.. _unit_tables: Supported Units *************** The following units are supported by VUnits when parsing strings. These units can be combined to form different quantities. For example, dividing an entry from the :ref:`supported lengths ` (e.g. ``m``) by an entry from the :ref:`supported times ` (e.g. ``s``) will produce a quantity that represents a velocity (``m/s``). Prefixes of the units (e.g. 'km' or 'kilometer') are also supported. See the :ref:`prefixes section ` below for supported prefixes. .. contents:: For custom units, add a :class:`~vunits.quantity.UnitQuantity` object to :py:data:`~vunits.db.unit_db`. .. _time_table: Time ---- +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +========+==========================+================================+======================================+==============================+ | s | 1.0 s | Y | N | N | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | sec | 1.0 s | N | N | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | second | 1.0 s | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | min | 60.0 s | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | minute | 60.0 s | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | h | 3600.0 s | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | hr | 3600.0 s | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | hour | 3600.0 s | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | day | 86400.0 s | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | yr | 31557600.0 s | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | year | 31557600.0 s | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _frequency_table: Frequency --------- +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +=======+==========================+================================+======================================+==============================+ | Hz | 1.0 s\ :sup:`-1`\ | Y | N | N | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | hertz | 1.0 s\ :sup:`-1`\ | Y | N | N | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _length_table: Length ------ +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +=======+==========================+================================+======================================+==============================+ | m | 1.0 m | Y | Y | N | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | meter | 1.0 m | N | Y | Y | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | in | 0.025399986284007407 m | N | Y | Y | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | inch | 0.025399986284007407 m | N | Y | Y | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | ft | 0.3047999902464003 m | N | Y | Y | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | foot | 0.3047999902464003 m | N | Y | N | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | feet | 0.3047999902464003 m | N | Y | N | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | mile | 1609.344 m | N | Y | Y | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Ang | 1e-10 m | N | Y | Y | +-------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _volume_table: Volume ------ Note that all :ref:`length ` units can be combined to form new units for volume. For example, 'm3', 'cm3', 'cm inch ft' are all valid volume units. +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +========+==========================+================================+======================================+==============================+ | L | 0.001 m\ :sup:`3`\ | Y | N | N | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | liter | 0.001 m\ :sup:`3`\ | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | gal | 0.003785 m\ :sup:`3`\ | Y | N | N | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | gallon | 0.003785 m\ :sup:`3`\ | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _acceleration_table: Acceleration ------------ +------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +======+==========================+================================+======================================+==============================+ | g0 | 9.80665 m s\ :sup:`-2`\ | Y | N | N | +------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _mass_table: Mass ---- +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +========+==========================+================================+======================================+==============================+ | g | 0.001 kg | Y | Y | N | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | gram | 0.001 kg | Y | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | u | 1.660577881102624e-27 kg | N | Y | N | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | amu | 1.660577881102624e-27 kg | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Da | 1.660577881102624e-27 kg | Y | Y | N | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | dalton | 1.660577881102624e-27 kg | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | lb | 0.45359290943563974 kg | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | pound | 0.45359290943563974 kg | N | Y | Y | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _force_table: Force ----- +--------+-----------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +========+=============================+================================+======================================+==============================+ | N | 1.0 m kg s\ :sup:`-2`\ | Y | N | N | +--------+-----------------------------+--------------------------------+--------------------------------------+------------------------------+ | newton | 1.0 m kg s\ :sup:`-2`\ | Y | Y | Y | +--------+-----------------------------+--------------------------------+--------------------------------------+------------------------------+ | dyn | 1e-05 m kg s\ :sup:`-2`\ | Y | N | N | +--------+-----------------------------+--------------------------------+--------------------------------------+------------------------------+ | dyne | 1e-05 m kg s\ :sup:`-2`\ | N | Y | Y | +--------+-----------------------------+--------------------------------+--------------------------------------+------------------------------+ | lbf | 4.448222 m kg s\ :sup:`-2`\ | N | N | N | +--------+-----------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _energy_table: Energy ------ +------+-------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +======+=================================================+================================+======================================+==============================+ | J | 1.0 m\ :sup:`2`\ kg s\ :sup:`-2`\ | Y | N | N | +------+------------------------------+------------------+--------------------------------+--------------------------------------+------------------------------+ | cal | 4.184 m\ :sup:`2`\ kg s\ :sup:`-2`\ | Y | N | N | +------+------------------------------+------------------+--------------------------------+--------------------------------------+------------------------------+ | eV | 1.6021766208e-19 m\ :sup:`2`\ kg s\ :sup:`-2`\ | Y | N | N | +------+------------------------------+------------------+--------------------------------+--------------------------------------+------------------------------+ | Latm | 101.325 m\ :sup:`2`\ kg s\ :sup:`-2`\ | N | N | N | +------+------------------------------+------------------+--------------------------------+--------------------------------------+------------------------------+ | Eh | 4.3597482e-16 m\ :sup:`2`\ kg s\ :sup:`-2`\ | Y | N | N | +------+------------------------------+------------------+--------------------------------+--------------------------------------+------------------------------+ | Ha | 4.3597482e-16 m\ :sup:`2`\ kg s\ :sup:`-2`\ | Y | N | N | +------+------------------------------+------------------+--------------------------------+--------------------------------------+------------------------------+ | BTU | 1055.0 m\ :sup:`2`\ kg s\ :sup:`-2`\ | N | N | Y | +------+------------------------------+------------------+--------------------------------+--------------------------------------+------------------------------+ .. _power_table: Power ----- +------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +======+============================================+================================+======================================+==============================+ | W | 1.0 m\ :sup:`2`\ kg s\ :sup:`-3`\ | Y | N | N | +------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | watt | 1.0 m\ :sup:`2`\ kg s\ :sup:`-3`\ | N | Y | Y | +------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _pressure_table: Pressure -------- +--------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +========+============================================+================================+======================================+==============================+ | Pa | 1.0 m\ :sup:`-1`\ kg s\ :sup:`-2`\ | Y | N | N | +--------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | pascal | 1.0 m\ :sup:`-1`\ kg s\ :sup:`-2`\ | N | Y | Y | +--------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | atm | 101325.0 m\ :sup:`-1`\ kg s\ :sup:`-2`\ | N | N | N | +--------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | bar | 100000.0 m\ :sup:`-1`\ kg s\ :sup:`-2`\ | Y | Y | Y | +--------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | mmHg | 133.322 m\ :sup:`-1`\ kg s\ :sup:`-2`\ | N | N | N | +--------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | torr | 133.322 m\ :sup:`-1`\ kg s\ :sup:`-2`\ | Y | Y | Y | +--------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Torr | 133.322 m\ :sup:`-1`\ kg s\ :sup:`-2`\ | Y | Y | Y | +--------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | psi | 6894.76 m\ :sup:`-1`\ kg s\ :sup:`-2`\ | N | N | N | +--------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _amount_table: Amount ------ +----------+----------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +==========+============================+================================+======================================+==============================+ | mol | 1.0 mol | Y | Y | Y | +----------+----------------------------+--------------------------------+--------------------------------------+------------------------------+ | mole | 1.0 mol | Y | Y | Y | +----------+----------------------------+--------------------------------+--------------------------------------+------------------------------+ | molecule | 1.6605390395999472e-24 mol | N | Y | Y | +----------+----------------------------+--------------------------------+--------------------------------------+------------------------------+ | molec | 1.6605390395999472e-24 mol | N | Y | N | +----------+----------------------------+--------------------------------+--------------------------------------+------------------------------+ | particle | 1.6605390395999472e-24 mol | N | Y | Y | +----------+----------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _temp_table: Temperature ----------- The values here represent incremental quantities (i.e. 1 K\ :sup:`-1`\ = 1 \ :sup:`o`\ C\ :sup:`-1`\ = 1.8 R\ :sup:`-1`\ = 1.8 \ :sup:`o`\ F\ :sup:`-1`\ ). If the :class:`~vunits.quantity.Quantity` object's dimensions are only ``temperature``, unit conversions are done accounting for different reference points (i.e. 298.15 K = 25 \ :sup:`o`\ C = 536.67 R = 77 \ :sup:`o`\ F). +------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +======+==========================+================================+======================================+==============================+ | K | 1.0 K | N | N | N | +------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | oC | 1.0 K | N | N | N | +------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | R | 1.8 K | N | N | N | +------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | oF | 1.8 K | N | N | N | +------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _current_table: Electric Current ---------------- +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +========+==========================+================================+======================================+==============================+ | A | 1.0 A | Y | N | N | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | ampere | 1.0 A | N | Y | N | +--------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _intensity_table: Light Intensity --------------- +---------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +=========+==========================+================================+======================================+==============================+ | cd | 1.0 cd | Y | N | N | +---------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | candela | 1.0 cd | N | Y | Y | +---------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _charge_table: Charge ------ +---------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +=========+==========================+================================+======================================+==============================+ | C | 1.0 s A | Y | N | N | +---------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ | coulomb | 1.0 s A | Y | Y | Y | +---------+--------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _potential_diff_table: Potential Difference -------------------- +------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +======+=====================================================+================================+======================================+==============================+ | V | 1.0 m\ :sup:`2`\ kg s\ :sup:`-3`\ A\ :sup:`-1`\ | Y | N | N | +------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | volt | 1.0 m\ :sup:`2`\ kg s\ :sup:`-3`\ A\ :sup:`-1`\ | N | Y | Y | +------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _capacitance_table: Capacitance ----------- +-------+--------------------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +=======+==============================================================+================================+======================================+==============================+ | F | 1.0 m\ :sup:`-2`\ kg\ :sup:`-1`\ s\ :sup:`4`\ A\ :sup:`2`\ | Y | N | N | +-------+--------------------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | farad | 1.0 m\ :sup:`-2`\ kg\ :sup:`-1`\ s\ :sup:`4`\ A\ :sup:`2`\ | N | Y | Y | +-------+--------------------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _inductance_table: Electrical Inductance --------------------- +-------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +=======+=====================================================+================================+======================================+==============================+ | H | 1.0 m\ :sup:`2`\ kg s\ :sup:`-2`\ A\ :sup:`-2`\ | Y | N | N | +-------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | henry | 1.0 m\ :sup:`2`\ kg s\ :sup:`-2`\ A\ :sup:`-2`\ | N | Y | Y | +-------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _resistance_table: Electrical Resistance --------------------- +------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +======+=====================================================+================================+======================================+==============================+ | ohm | 1.0 m\ :sup:`2`\ kg s\ :sup:`-3`\ A\ :sup:`-2`\ | Y | Y | Y | +------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _mag_flux_den_table: Magnetic Flux Density --------------------- +-------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +=======+============================================+================================+======================================+==============================+ | T | 1.0 kg s\ :sup:`-2`\ A\ :sup:`-1`\ | Y | N | N | +-------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | tesla | 1.0 kg s\ :sup:`-2`\ A\ :sup:`-1`\ | N | Y | Y | +-------+--------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _mag_flux_table: Magnetic Flux ------------- +-------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | Unit | SI Base Units Equivalent | Short Prefix Allowed (e.g. km) | Long Prefix Allowed (e.g. kilometer) | Plural Allowed (e.g. meters) | +=======+=====================================================+================================+======================================+==============================+ | Wb | 1.0 m\ :sup:`2`\ kg s\ :sup:`-2`\ A\ :sup:`-1`\ | Y | N | N | +-------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ | weber | 1.0 m\ :sup:`2`\ kg s\ :sup:`-2`\ A\ :sup:`-1`\ | N | Y | Y | +-------+-----------------------------------------------------+--------------------------------+--------------------------------------+------------------------------+ .. _prefix_table: Supported Prefixes ****************** VUnits supports the following prefixes when parsing units. +-------------+--------------+-----------+ | Long Prefix | Short Prefix | Magnitude | +=============+==============+===========+ | yotta | Y | 1.00E+24 | +-------------+--------------+-----------+ | zetta | Z | 1.00E+21 | +-------------+--------------+-----------+ | exa | E | 1.00E+18 | +-------------+--------------+-----------+ | peta | P | 1.00E+15 | +-------------+--------------+-----------+ | tera | T | 1.00E+12 | +-------------+--------------+-----------+ | giga | G | 1.00E+09 | +-------------+--------------+-----------+ | mega | M | 1.00E+06 | +-------------+--------------+-----------+ | kilo | k | 1.00E+03 | +-------------+--------------+-----------+ | hecto | h | 1.00E+02 | +-------------+--------------+-----------+ | deca | da | 1.00E+01 | +-------------+--------------+-----------+ | deci | d | 1.00E-01 | +-------------+--------------+-----------+ | centi | c | 1.00E-02 | +-------------+--------------+-----------+ | milli | m | 1.00E-03 | +-------------+--------------+-----------+ | micro | mu | 1.00E-06 | +-------------+--------------+-----------+ | nano | n | 1.00E-09 | +-------------+--------------+-----------+ | pico | p | 1.00E-12 | +-------------+--------------+-----------+ | femto | f | 1.00E-15 | +-------------+--------------+-----------+ | atto | a | 1.00E-18 | +-------------+--------------+-----------+ | zepto | z | 1.00E-21 | +-------------+--------------+-----------+ | yocto | y | 1.00E-24 | +-------------+--------------+-----------+