MooseUnits

MooseUnits is a physical units parsing and conversion helper class. A unit object can be constructed form a string (e.g. N*m, eV/at, kg*(m/s)^2, 1/s, m^-3). The unit parser supports the *,/, and ^ operators as well as parenthesis (, ). The argument of the ^ operator is expected to be a positive or negative integer.

Upon parsing all units are resolved to a combination of the seven base SI units (m, g, s, A, K, mol, cd) with their respective exponents and a prefactor. A canonical form is generated that permits unit comparisons to determine conformity (i.e. whether two units can be converted between).

MooseUnits supports prefixing all units with a metric prefix ranging from Y (yotta) to y (yocto).

Supported derived units

The following units are currently supported

Symbol	Base units	Name	Description
`Ohm`	$var element = document.getElementById("moose-equation-1d55bdd8-1827-4ee2-bbcd-2ced3babb613");katex.render("\\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-3}\\cdot \\text{A}^{-2}", element, {displayMode:false,throwOnError:false});$	Ohm	resistance, impedance, reactance
`atm`	$var element = document.getElementById("moose-equation-b43ddd0e-5b08-4b6e-ba72-dfc575b7c544");katex.render("101325\\, \\text{kg}\\cdot \\text{m}^{-1}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	Standard atmosphere	pressure
`eV`	$var element = document.getElementById("moose-equation-778f7019-b9b2-4c0a-a4f1-e989a6ff48f0");katex.render("1.60218\\cdot10^{-19}\\, \\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	electron Volt	energy
`erg`	$var element = document.getElementById("moose-equation-b6d7022a-4e4a-47c6-a004-9e597fe1433d");katex.render("10^{-7}\\, \\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	Erg	energy
`degC`	$var element = document.getElementById("moose-equation-7830b18e-3430-473c-9210-ca55179a7cfd");katex.render("\\text{K}", element, {displayMode:false,throwOnError:false});$	Celsius	temperature - As long as this unit stands alone the additive shift in the scale is taken into account. In all other cases this unit behaves like Kelvin
`degF`	$var element = document.getElementById("moose-equation-c51223fd-8c27-4b96-ba98-fddb6c3e55f1");katex.render("\\frac59\\,\\text{K}", element, {displayMode:false,throwOnError:false});$	Fahrenheit	temperature - As long as this unit stands alone the additive shift in the scale is taken into account. In all other cases this unit behaves like Rankine
`degR`	$var element = document.getElementById("moose-equation-97a8b296-16c4-4709-aa1e-b0dece55f7de");katex.render("\\frac59\\,\\text{K}", element, {displayMode:false,throwOnError:false});$	Rankine	temperature
`Ang`	$var element = document.getElementById("moose-equation-692fb7c4-3bff-465e-8390-06dc65dcf2d9");katex.render("10^{-10}\\, \\text{m}", element, {displayMode:false,throwOnError:false});$	Angstrom	length
`m`	$var element = document.getElementById("moose-equation-ecb6a86c-b526-42bd-9fc9-5b3d5ced6216");katex.render("\\text{m}", element, {displayMode:false,throwOnError:false});$	meter	length
`g`	$var element = document.getElementById("moose-equation-b122cac0-8767-479c-806c-da1137a145aa");katex.render("0.001\\, \\text{kg}", element, {displayMode:false,throwOnError:false});$	gram	mass
`s`	$var element = document.getElementById("moose-equation-afbfd8c1-dd5c-444e-93dc-c9a88f39edc7");katex.render("\\text{s}", element, {displayMode:false,throwOnError:false});$	second	time
`A`	$var element = document.getElementById("moose-equation-481377c9-b3e8-4f1d-9702-29ea74b4767a");katex.render("\\text{A}", element, {displayMode:false,throwOnError:false});$	Ampere	electric current
`K`	$var element = document.getElementById("moose-equation-5a110fe2-8c22-4588-b86b-acaf0555aa93");katex.render("\\text{K}", element, {displayMode:false,throwOnError:false});$	Kelvin	temperature
`mol`	$var element = document.getElementById("moose-equation-85d153e6-327c-438e-b160-283ab6de1744");katex.render("6.02214076e23\\cdot10^{23}\\, \\text{at}", element, {displayMode:false,throwOnError:false});$	mole	amount of substance
`cd`	$var element = document.getElementById("moose-equation-9c8ca288-b94d-445d-8b16-a6d8ae51b302");katex.render("\\text{cd}", element, {displayMode:false,throwOnError:false});$	candela	luminous intensity
`N`	$var element = document.getElementById("moose-equation-f55f194e-85aa-499d-8d00-c9d864d58bf6");katex.render("\\text{kg}\\cdot \\text{m}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	Newton	force, weight
`Pa`	$var element = document.getElementById("moose-equation-e3ee2ea5-ba2a-4b9c-ad44-5a70eeff291d");katex.render("\\text{kg}\\cdot \\text{m}^{-1}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	Pascal	pressure, stress
`J`	$var element = document.getElementById("moose-equation-305e5d23-9a15-4fe6-a4d3-c6c77c72d03d");katex.render("\\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	Joule	energy, work, heat
`cal`	$var element = document.getElementById("moose-equation-87a42fe2-7882-4582-a022-8f1ab06ddd3b");katex.render("4.184\\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	Calorie	energy, work, heat
`W`	$var element = document.getElementById("moose-equation-b08ec88a-d7dd-46e0-b9c5-94e8f683a0ab");katex.render("\\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-3}", element, {displayMode:false,throwOnError:false});$	Watt	power, radiant flux
`C`	$var element = document.getElementById("moose-equation-105699b5-505c-4cd3-9cc3-944888e5cf55");katex.render("\\text{A}\\cdot \\text{s}", element, {displayMode:false,throwOnError:false});$	Coulomb	electric charge
`V`	$var element = document.getElementById("moose-equation-38b95a86-d921-4cda-abbb-8b01013043ae");katex.render("\\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-3}\\cdot \\text{A}^{-1}", element, {displayMode:false,throwOnError:false});$	Volt	voltage (electrical potential), emf
`F`	$var element = document.getElementById("moose-equation-28c0e9c3-3f4c-403d-8030-a99d2decac14");katex.render("\\text{kg}^{-1}\\cdot \\text{m}^{-2}\\cdot \\text{s}^{4}\\cdot \\text{A}^{2}", element, {displayMode:false,throwOnError:false});$	Farad	capacitance
`S`	$var element = document.getElementById("moose-equation-927d7029-5feb-4cfb-9154-dcedb20304ca");katex.render("\\text{kg}^{-1}\\cdot \\text{m}^{-2}\\cdot \\text{s}^{3}\\cdot \\text{A}^{2}", element, {displayMode:false,throwOnError:false});$	Siemens	electrical conductance
`Wb`	$var element = document.getElementById("moose-equation-617ebd26-e860-467a-8b03-08c3ec6df55f");katex.render("\\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-2}\\cdot \\text{A}^{-1}", element, {displayMode:false,throwOnError:false});$	Weber	magnetic flux
`T`	$var element = document.getElementById("moose-equation-1749939d-61ed-45a8-8fd2-930c4899a062");katex.render("\\text{kg}\\cdot \\text{s}^{-2}\\cdot \\text{A}^{-1}", element, {displayMode:false,throwOnError:false});$	Tesla	magnetic flux density
`H`	$var element = document.getElementById("moose-equation-f8073396-9853-43e4-b675-65d768589764");katex.render("\\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-2}\\cdot \\text{A}^{-2}", element, {displayMode:false,throwOnError:false});$	Henry	inductance
`Ba`	$var element = document.getElementById("moose-equation-c1f38da2-1893-46ca-bd38-e4a69c532ff8");katex.render("0.1\\, \\text{kg}\\cdot \\text{m}^{-1}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	barye	Pressure
`dyn`	$var element = document.getElementById("moose-equation-beec420d-19f5-4e15-b5ae-072d740cd9b3");katex.render("10^{-5}\\, \\text{kg}\\cdot \\text{m}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	dyne	force, weight
`ft`	$var element = document.getElementById("moose-equation-32bb192c-516b-4cf4-9fce-edd84f9350fe");katex.render("0.3048\\, \\text{m}", element, {displayMode:false,throwOnError:false});$	Foot	length
`in`	$var element = document.getElementById("moose-equation-0073b710-9f40-4fab-8bfa-8df9fdcf5922");katex.render("0.0254\\, \\text{m}", element, {displayMode:false,throwOnError:false});$	Inch	length
`lb`	$var element = document.getElementById("moose-equation-6e6feb59-1cb9-4a5f-b01e-2e8e25386ac2");katex.render("0.45359237\\, \\text{kg}", element, {displayMode:false,throwOnError:false});$	pound	mass
`lbf`	$var element = document.getElementById("moose-equation-8b66793b-75b6-4427-ad32-405e346d513a");katex.render("4.4482216152605\\, \\text{kg}\\cdot \\text{m}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	pound-force	force
`psi`	$var element = document.getElementById("moose-equation-87b55259-c23b-4e04-bef9-ae7575e327b6");katex.render("6894.757\\, \\text{kg}\\cdot \\text{m}^{-1}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	pound-force per square inch	pressure, stress
`BTU`	$var element = document.getElementById("moose-equation-13e15d70-7a5e-4f54-a8f1-bb29bb549ef3");katex.render("1055.06\\, \\text{kg}\\cdot \\text{m}^{2}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	ISO 31-4 British thermal unit	heat
`bar`	$var element = document.getElementById("moose-equation-e627cae0-ba51-4c00-8359-824253f3615d");katex.render("10^5\\, \\text{kg}\\cdot \\text{m}^{-1}\\cdot \\text{s}^{-2}", element, {displayMode:false,throwOnError:false});$	Bar	pressure, stress
`h`	$var element = document.getElementById("moose-equation-13a0cd87-974d-44ff-b1c1-efa0bd8a829a");katex.render("3600\\, \\text{s}", element, {displayMode:false,throwOnError:false});$	hour	time
`day`	$var element = document.getElementById("moose-equation-53c6b7d7-be78-48f1-bc07-3d5ee6b8f632");katex.render("86400\\, \\text{s}", element, {displayMode:false,throwOnError:false});$	day	time (`d` would create an ambiguity between centi-day and candela)
`year`	$var element = document.getElementById("moose-equation-4ab8808f-9841-4fc1-9f18-1e6c3f547c69");katex.render("365.25\\cdot86400\\, \\text{s}", element, {displayMode:false,throwOnError:false});$	annum	time (Julian calendar year, `a` would create an ambiguity between Peta-annum and Pascal)
`l`	$var element = document.getElementById("moose-equation-d3700f29-6003-400c-bcd0-57ce96e322b0");katex.render("0.001\\, \\text{m}^{3}", element, {displayMode:false,throwOnError:false});$	liter	volume
`u`	$var element = document.getElementById("moose-equation-2d803411-ac0d-4f0a-ae8b-e86996affba8");katex.render("1.6605390666\\cdot10^{-27}\\, \\text{kg}^{3}", element, {displayMode:false,throwOnError:false});$	unified atomic mass unit	mass
`at`	$var element = document.getElementById("moose-equation-2eac4a0d-130e-4631-8b9b-cfe661e8a0ba");katex.render("\\text{at}", element, {displayMode:false,throwOnError:false});$	atom	single count of substance

Operators

Unit objects support the * and / operators to multiply and divide units respectively. An overload of std::pow is provided to exponentiate units.

The == equal operator is implemented for comparison of two units and a unit and a real number. It returns true if the two units are exactly identical including the prefactor. A comparison that omits the prefactor is provided by the conformsTo method.

A unit is considered equal to a real number if all its base unit exponents are zero and the prefactor matches the real number.

Dimension check

In addition to the conformsTo check a few bool member functions are provided to check if the unit represents a given physical dimension.

isLength()
isTime()
isMass()
isCurrent()
isTemperature()

Output

MooseUnits objects can be output to streams using the << operator. The output consists of the prefactor and the SI base units with their respective exponents. Two stream manipulators are provided to toggle between plain text and LaTeX formatted output of the units.

MooseUnits

Supported derived units

Operators

Dimension check

Output

See also