# Unit Reference

### General Units

{% tabs %}
{% tab title="Time" %}

| Name         | Symbol | Definition        |
| ------------ | ------ | ----------------- |
| Nanoseconds  | ns     | 1 second = 1G ns  |
| Microseconds | µs     | 1 second = 1M µs  |
| Milliseconds | ms     | 1 second = 1k ms  |
| Second       | s, sec | Base unit of time |
| Minute       | min    | 60 seconds        |
| Hour         | h, hr  | 60 minutes        |
| Day          | day    | 24 hours          |
| Week         | wk     | 7 days            |
| Month        | mo     | 30.436875 days    |
| Year         | yr     | 365.2425 days     |
| {% endtab %} |        |                   |

{% tab title="Length" %}
**Metric**

| Unit Name   | Unit Symbol | Definition                                   |
| ----------- | ----------- | -------------------------------------------- |
| Nanometers  | nm          | One billionth of a meter                     |
| Micrometers | µm          | One millionth of a meter                     |
| Millimeters | mm          | One thousandth of a meter                    |
| Centimeters | cm          | One hundredth of a meter                     |
| Decimeters  | dm          | One tenth of a meter                         |
| Meters      | m           | The base unit of length in the metric system |
| Kilometers  | km          | 1000 meters                                  |

**Imperial**

| Unit Name | Unit Symbol | Definition            |
| --------- | ----------- | --------------------- |
| Furlongs  | fur         | 1 furlong = 220 yards |
| Miles     | mi          | 1 mile = 1,760 yards  |
| Yards     | yd          | 1 yard = 3 feet       |
| Feet      | ft or '     | 1 foot = 12 inches    |
| Inches    | "           |                       |

**Space & Sea**

| Unit Name      | Unit Symbol | Definition                                                                                                                                       |
| -------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Fathoms        | ftm         | A unit of length equal to 6 feet (1.8288 meters), commonly used to measure the depth of water.                                                   |
| Nautical Miles | NM          | A unit of distance used in maritime and air navigation, equal to one minute of latitude or approximately 1.15078 miles (1.852 kilometers).       |
| Light Years    | ly          | A unit of astronomical distance equivalent to the distance that light travels in one year, about 5.88 trillion miles (9.46 trillion kilometers). |
| {% endtab %}   |             |                                                                                                                                                  |

{% tab title="Area" %}
**Metric**

| Unit Name          | Unit Symbol    | Definition                                     |
| ------------------ | -------------- | ---------------------------------------------- |
| Square nanometers  | nm², nm^2, nm2 | Area of a square with sides of one nanometer.  |
| Square micrometers | µm², µm^2, µm2 | Area of a square with sides of one micrometer. |
| Square millimeters | mm², mm^2, mm2 | Area of a square with sides of one millimeter. |
| Square centimeters | cm², cm^2, cm2 | Area of a square with sides of one centimeter. |
| Square meters      | m², m^2, m2    | Area of a square with sides of one meter.      |
| Square kilometers  | km², km^2, km2 | Area of a square with sides of one kilometer.  |

**Imperial**

| Unit Name     | Unit Symbol          | Definition                                                      |
| ------------- | -------------------- | --------------------------------------------------------------- |
| Square Inches | in², sqin, in^2, in2 | A unit of area equal to a square measuring 1 inch on each side. |
| Square Feet   | ft², sqft, ft^2, ft2 | A unit of area equal to a square measuring 1 foot on each side. |
| Square Yard   | yd², sqyd, yd^2, yd2 | A unit of area equal to a square measuring 1 yard on each side. |
| Square Mile   | mi², sqmi, mi^2, mi2 | A unit of area equal to a square measuring 1 mile on each side. |

**Land**

| Unit Name    | Unit Symbol | Definition                                                                  |
| ------------ | ----------- | --------------------------------------------------------------------------- |
| Ares         | a           | A metric unit of area equal to 100 square meters.                           |
| Hectare      | ha          | A metric unit of area equal to 10,000 square meters.                        |
| Acre         | ac          | A unit of area commonly used in the US and UK, equal to 43,560 square feet. |
| {% endtab %} |             |                                                                             |

{% tab title="Volume" %}
**Metric**

| Unit Name         | Unit Symbol | Definition                            |
| ----------------- | ----------- | ------------------------------------- |
| Milliliters       | mL          | 1 mL = 1e-3 liters                    |
| Liters            | L           | Base unit for measuring liquid volume |
| Kiloliters        | kL          | 1 kL = 1e3 liters                     |
| Megaliters        | ML          | 1 ML = 1e6 liters                     |
| Cubic Micrometers | µm³         | 1 µm³ = 1e-18 cubic meters            |
| Cubic Millimeters | mm³         | 1 mm³ = 1e-9 cubic meters             |
| Cubic Centimeters | cm³         | 1 cm³ = 1e-6 cubic meters             |
| Cubic Kilometers  | km³         | 1 km³ = 1e9 cubic meters              |
| Cubic Meters      | m³          | Base unit for measuring volume        |
| Metric Cups       | cup         | 1 cup = 250 milliliters               |

**Imperial**

| Unit Name    | Unit Symbol             | Definition                                                       |
| ------------ | ----------------------- | ---------------------------------------------------------------- |
| Cubic Inches | in³, in3, in^3          | A measure of volume equivalent to a cube with edges of one inch. |
| Cubic Feet   | ft³, cuft, ft3, ft^3    | A measure of volume equivalent to a cube with edges of one foot. |
| Cubic Yards  | yd³, cuyd, yd3, yd^3    | A measure of volume equivalent to a cube with edges of one yard. |
| Cubic Miles  | mi³, mi3, mi^3, miles^3 | A measure of volume equivalent to a cube with edges of one mile. |

**US Customary**

| Unit Name    | Unit Symbol | Definition                                   |
| ------------ | ----------- | -------------------------------------------- |
| Gallons      | gal         | A unit of liquid capacity equal to 4 quarts. |
| Quarts       | qt          | A unit of liquid capacity equal to 2 pints.  |
| Tablespoons  | tbsp        | A unit of volume equal to 3 teaspoons.       |
| Teaspoons    | tsp         | A unit of volume often used in cooking.      |
| Cups         | cup         | A unit of volume equal to 8 fluid ounces.    |
| Pints        | pint        | A unit of volume equal to 16 fluid ounces.   |
| Fluid ounces | fl oz       | A unit of volume used for liquid measures.   |

{% hint style="info" %}
In Soulver's Region Settings you can choose whether US customary or imperial measurements are used for these volume units.

Note that a "cup" is always the US customary cup. Use "metric cup" for the cup unit commonly used in Australia, NZ and Canada (250ml).
{% endhint %}

**Other**

| Unit Name    | Unit Symbol | Definition                                                                                                                               |
| ------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Bushels      | bsh         | A unit of volume typically used for dry goods                                                                                            |
| Acre feet    | af          | A volume unit, typically used for large-scale water resources, defined as the volume of one acre of surface area to a depth of one foot. |
| {% endtab %} |             |                                                                                                                                          |

{% tab title="Mass" %}
**Metric**

| Unit Name   | Unit Symbol | Definition                                                       |
| ----------- | ----------- | ---------------------------------------------------------------- |
| Nanogram    | ng          | A unit of mass equal to one billionth of a gram.                 |
| Microgram   | mcg         | A unit of mass equal to one millionth of a gram.                 |
| Milligram   | mg          | A unit of mass equal to one thousandth of a gram.                |
| Gram        | g           | A unit of mass equal to one thousandth of a kilogram.            |
| Kilogram    | kg          | The base unit of mass in the International System of Units (SI). |
| Metric Tons | t           | A unit of mass equal to 1,000 kilograms.                         |

**Imperial**

| Unit Name  | Unit Symbol | Definition                                                                     |
| ---------- | ----------- | ------------------------------------------------------------------------------ |
| Ounces     | oz          | A unit of weight equal to 1/16th of a pound (lb).                              |
| Pounds     | lb          | A unit of weight by which various items are measured, equal to 16 ounces (oz). |
| Stones     | st          | A unit of weight equal to 14 pounds (lb).                                      |
| Short Tons | ton         | A unit of weight equal to 2,000 pounds (lb).                                   |

**Precious Metals**

| Unit Name    | Unit Symbol | Definition                                                                                 |
| ------------ | ----------- | ------------------------------------------------------------------------------------------ |
| Ounces Troy  | oz t        | A unit of imperial measure used for weighing precious metals, equivalent to 31.1035 grams. |
| Carats       | ct          | A unit of mass used for gemstones, equivalent to 200 milligrams or 0.2 grams.              |
| {% endtab %} |             |                                                                                            |

{% tab title="Speed" %}

| Unit Name           | Unit Symbol | Definition                                                                  |
| ------------------- | ----------- | --------------------------------------------------------------------------- |
| Meters per second   | m/s         | A unit of speed describing the distance in meters traveled in one second.   |
| Miles per hour      | mph         | A unit of speed expressing the number of statute miles covered in one hour. |
| Kilometers per hour | km/h        | A unit of speed defining the number of kilometers traveled in one hour.     |
| Knots               | kn          | A unit of speed equal to one nautical mile per hour.                        |
| {% endtab %}        |             |                                                                             |
| {% endtabs %}       |             |                                                                             |

### Math & Science Units

{% tabs %}
{% tab title="Angle" %}

| Unit Name | Unit Symbol | Definition                                                                                                 |
| --------- | ----------- | ---------------------------------------------------------------------------------------------------------- |
| Radians   | rad         | The angle subtended at the center of a circle by an arc whose length is equal to the radius of the circle. |
| Degrees   | °           | A unit of angle measurement equal to 1/360 of a full rotation.                                             |

{% hint style="info" %}
Note that trigonometric functions assume radians by default.

sin (90) = 0.8939966636

sin (90 degrees) = 1
{% endhint %}
{% endtab %}

{% tab title="Temperature" %}

| Unit Name    | Unit Symbol                 | Definition                                                                      |
| ------------ | --------------------------- | ------------------------------------------------------------------------------- |
| Fahrenheit   | °F, ºF, F, degF, fahrenheit | A temperature scale where water freezes at 32 degrees and boils at 212 degrees. |
| Celsius      | °C, ºC, C, degC, celsius    | A temperature scale where water freezes at 0 degrees and boils at 100 degrees.  |
| {% endtab %} |                             |                                                                                 |

{% tab title="Frequency" %}

| Unit Name    | Unit Symbol | Definition                                       |
| ------------ | ----------- | ------------------------------------------------ |
| Nanohertz    | nHz         | One billionth of a hertz, or 1/1,000,000,000 Hz. |
| Microhertz   | µHz         | One millionth of a hertz, or 1/1,000,000 Hz.     |
| Millihertz   | mHz         | One thousandth of a hertz, or 1/1,000 Hz.        |
| Hertz        | Hz          | One cycle per second                             |
| Kilohertz    | kHz         | One thousand hertz, or 1,000 Hz.                 |
| Megahertz    | MHz         | One million hertz, or 1,000,000 Hz.              |
| Gigahertz    | GHz         | One billion hertz, or 1,000,000,000 Hz.          |
| Terahertz    | THz         | One trillion hertz, or 1,000,000,000,000 Hz.     |
| {% endtab %} |             |                                                  |

{% tab title="Energy" %}

| Unit Name      | Unit Symbol | Definition                                                |
| -------------- | ----------- | --------------------------------------------------------- |
| Terawatt hours | TWh         | Equal to 1 trillion watt hours or 10^12 watt hours.       |
| Gigawatt hours | GWh         | Equal to 1 billion watt hours or 10^9 watt hours.         |
| Megawatt hours | MWh         | Equal to 1 million watt hours or 10^6 watt hours.         |
| Kilowatt hours | kWh         | Equal to 1,000 watt hours or 10^3 watt hours.             |
| Watt hours     | Wh          | A unit of energy equal to one watt of power for one hour. |
| Watt minutes   | W m         | Equal to 60 watt seconds.                                 |
| Watt seconds   | W s         | Basic unit of energy, equal to 1 joule.                   |
| Kilocalories   | kCal        | Approx. equal to 4.184 kilojoules.                        |
| Calories       | cal         | Approx. equal to 4.184 joules.                            |
| Gigajoules     | GJ          | Equal to 1 billion joules or 10^9 joules.                 |
| Megajoules     | MJ          | Equal to 1 million joules or 10^6 joules.                 |
| Kilojoules     | kJ          | Equal to 1,000 joules or 10^3 joules.                     |
| Joules         | J           | The SI unit of work or energy                             |
| {% endtab %}   |             |                                                           |

{% tab title="Power" %}

| Unit Name     | Unit Symbol | Definition                               |
| ------------- | ----------- | ---------------------------------------- |
| Horsepower    | hp          | A unit of power equivalent to 746 W      |
| Milliwatts    | mW          | A unit of power equivalent to 0.001 W    |
| Watts         | W           | The base unit of power in the SI system. |
| Kilowatts     | kW          | A unit of power equivalent to 10³ W      |
| Megawatts     | MW          | A unit of power equivalent to 10⁶ W      |
| Gigawatts     | GW          | A unit of power equivalent to 10⁹ W      |
| Terawatts     | TW          | A unit of power equivalent to 10¹² W     |
| {% endtab %}  |             |                                          |
| {% endtabs %} |             |                                          |

### Computer-related Units

{% tabs %}
{% tab title="Data Storage" %}
{% hint style="info" %}
Units like GB, MB, kB, etc are in base 10 (1 GB = 1000 MB)

Units like GiB, MiB, KiB, etc are in base 2 (1 GiB = 1024 MiB)

See [here](https://en.wikipedia.org/wiki/Gigabyte) for more information on the SI standard with regards to units of data storage.
{% endhint %}

* Bytes (B)
* Bits (bit)
* Yottabytes (YB)
* Zettabytes (ZB)
* Exabytes (EB)
* Petabytes (PB)
* Terabytes (TB)
* Gigabytes (GB)
* Megabytes (MB)
* Kilobytes (kB)
* Yottabits (Yb)
* Zettabits (Zb)
* Exabits (Eb)
* Petabits (Pb)
* Terabits (Tb)
* Gigabits (Gb)
* Megabits (Mb)
* Kilobits (kb)
* Yobibytes (YiB)
* Zebibytes (ZiB)
* Exbibytes (EiB)
* Pebibytes (PiB)
* Tebibytes (TiB)
* Gibibytes (GiB)
* Mebibytes (MiB)
* Kibibytes (KiB)
* Yobibits (Yib)
* Zebibits (Zib)
* Exbibits (Eib)
* Pebibits (Pib)
* Tebibits (Tib)
* Gibibits (Gib)
* Mebibits (Mib)
* Kibibits (Kib)
  {% endtab %}

{% tab title="Data Transfer" %}

* Bytes per second (Bps)
* Bits per second (bps)
* Yottabytes per second (YBps)
* Zettabytes per second (ZBps)
* Exabytes per second (EBps)
* Petabytes per second (PBps)
* Terabytes per second (TBps)
* Gigabytes per second (GBp)
* Megabytes per second (MBp)
* Kilobytes per second (KBp)
* Yottabits per second (Ybps)
* Zettabits per second (Zbps)
* Exabits per second (Ebps)
* Petabits per second (Pbp)
* Terabits per second (Tbp)
* Gigabits per second (Gbp)
* Megabits per second (Mbp)
* Kilobits per second (Kbp)
* Yobibytes per second (YiBps)
* Zebibytes per second (ZiBps)
* Exbibytes per second (EiBps)
* Pebibytes per second (PiBps)
* Tebibytes per second (TiBps)
* Gibibytes per second (GiBps)
* Mebibytes per second (MiBps)
* Kibibytes per second (KiBps)
* Yobibits per second (Yibps)
* Zebibits per second (Zibps)
* Exbibits per second (Eibps)
* Pebibits per second (Pibps)
* Tebibits per second (Tibps)
* Gibibits per second (Gibps)
* Mebibits per second (Mibps)
* Kibibits per second (Kibps)
  {% endtab %}

{% tab title="CSS" %}

* Pixel (px) - defined as 1⁄96 inch (0.26 mm)
* Em
* Pt

{% hint style="info" %}
Note that CSS units are units of length, so you can convert them to and from other units of length, like inches
{% endhint %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.soulver.app/syntax-reference/units-and-conversions/unit-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
