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 supported lengths (e.g. m
) by an entry from
the 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 prefixes section below for supported prefixes.
Contents
For custom units, add a UnitQuantity
object to
unit_db
.
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¶
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-1 |
Y |
N |
N |
hertz |
1.0 s-1 |
Y |
N |
N |
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¶
Note that all 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 m3 |
Y |
N |
N |
liter |
0.001 m3 |
N |
Y |
Y |
gal |
0.003785 m3 |
Y |
N |
N |
gallon |
0.003785 m3 |
N |
Y |
Y |
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-2 |
Y |
N |
N |
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¶
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-2 |
Y |
N |
N |
newton |
1.0 m kg s-2 |
Y |
Y |
Y |
dyn |
1e-05 m kg s-2 |
Y |
N |
N |
dyne |
1e-05 m kg s-2 |
N |
Y |
Y |
lbf |
4.448222 m kg s-2 |
N |
N |
N |
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 m2kg s-2 |
Y |
N |
N |
|
cal |
4.184 m2 kg s-2 |
Y |
N |
N |
|
eV |
1.6021766208e-19 m2 kg s-2 |
Y |
N |
N |
|
Latm |
101.325 m2 kg s-2 |
N |
N |
N |
|
Eh |
4.3597482e-16 m2 kg s-2 |
Y |
N |
N |
|
Ha |
4.3597482e-16 m2 kg s-2 |
Y |
N |
N |
|
BTU |
1055.0 m2 kg s-2 |
N |
N |
Y |
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 m2kg s-3 |
Y |
N |
N |
watt |
1.0 m2kg s-3 |
N |
Y |
Y |
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-1kg s-2 |
Y |
N |
N |
pascal |
1.0 m-1kg s-2 |
N |
Y |
Y |
atm |
101325.0 m-1kg s-2 |
N |
N |
N |
bar |
100000.0 m-1kg s-2 |
Y |
Y |
Y |
mmHg |
133.322 m-1kg s-2 |
N |
N |
N |
torr |
133.322 m-1kg s-2 |
Y |
Y |
Y |
Torr |
133.322 m-1kg s-2 |
Y |
Y |
Y |
psi |
6894.76 m-1kg s-2 |
N |
N |
N |
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 |
Temperature¶
The values here represent incremental quantities
(i.e. 1 K-1= 1 oC-1= 1.8 R-1=
1.8 oF-1). If the Quantity
object’s dimensions are only temperature
, unit conversions are done
accounting for different reference points (i.e. 298.15 K = 25 oC =
536.67 R = 77 oF).
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 |
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 |
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¶
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 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 m2kg s-3A-1 |
Y |
N |
N |
volt |
1.0 m2kg s-3A-1 |
N |
Y |
Y |
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-2kg-1s4A2 |
Y |
N |
N |
farad |
1.0 m-2kg-1s4A2 |
N |
Y |
Y |
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 m2kg s-2A-2 |
Y |
N |
N |
henry |
1.0 m2kg s-2A-2 |
N |
Y |
Y |
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 m2kg s-3A-2 |
Y |
Y |
Y |
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-2A-1 |
Y |
N |
N |
tesla |
1.0 kg s-2A-1 |
N |
Y |
Y |
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 m2kg s-2A-1 |
Y |
N |
N |
weber |
1.0 m2kg s-2A-1 |
N |
Y |
Y |
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 |