convert/system - Maple Programming Help

Home : Support : Online Help : Science and Engineering : Units : Conversions : convert/system

convert/system

convert a unit to the default unit in a system of units

 Calling Sequence convert(u, system, unitFrom, systemTo, opts) convert(u*Unit(unitFrom), system, systemTo, opts) convert(dim, system, systemTo, dimension=true, opts)

Parameters

 u - expression dim - dimension unitFrom - symbol; unit to be converted from systemTo - (optional) symbol; system of units to be converted to opts - (optional) equation(s) of the form option=value where option is one of base, dimension, respectOverrides, or symbolic; specify options for the conversion

Description

 • The convert(u, system, unitFrom, systemTo) function multiplies the value u by the conversion factor to convert from the unit UnitFrom to the default unit of the same dimension in the system of units SystemTo.
 • The function Unit can be either Units[Unit] or the Unit routine from the Units[Standard] or the Units[Natural] environment.
 • The unit unitFrom and system SystemTo can be any unit label, for example, name or symbol, accepted by the Units package.
 • If SystemTo is not specified, the default system of units is used. See UseSystem and UsingSystem.
 Note: Temperature conversions are for temperature intervals not absolute temperatures. For example, 1 degree Celsius is converted to 1 kelvin.  For conversions of absolute temperatures, use convert/temperature.
 • You can modify the properties of the conversion by including options opts. The opts argument can contain one or more of the following equations.
 base = true or false
 This option specifies that the resulting unit should be returned in terms of base units, rather than derived units. By default, this option is set to false.
 dimension = true or false
 If this option is given, the third calling sequence is used.  This indicates that the given dimension should be converted into the corresponding units of the given system.  By default, this option is set to false.
 respectOverrides = true or false
 By default, convert/system converts purely to the system specified, disregarding units selected with UseUnit. To change that behavior, use respectOverrides=true.
 symbolic = true or false
 This option specifies whether annotations to units are ignored.  By default, this option is set to false.

Examples

 > $\mathrm{convert}\left(17.0,\mathrm{system},\frac{\mathrm{ft}}{s}\right)$
 ${5.181600000}$ (1)
 > $\mathrm{convert}\left(17.0,\mathrm{system},\frac{\mathrm{ft}}{s},\mathrm{SI}\right)$
 ${5.181600000}$ (2)
 > $\mathrm{convert}\left(60.0,\mathrm{system},\frac{\mathrm{mi}}{h}\right)$
 ${26.82240000}$ (3)
 > $\mathrm{Units}\left[\mathrm{GetSystems}\right]\left(\right)$
 ${\mathrm{Atomic}}{,}{\mathrm{CGS}}{,}{\mathrm{EMU}}{,}{\mathrm{ESU}}{,}{\mathrm{FPS}}{,}{\mathrm{MKS}}{,}{\mathrm{MTS}}{,}{\mathrm{SI}}$ (4)
 > $\mathrm{Units}\left[\mathrm{UseSystem}\right]\left(\mathrm{FPS}\right)$
 > $\mathrm{convert}\left(17.0,\mathrm{system},\frac{\mathrm{ft}}{s}\right)$
 ${17.0}$ (5)
 > $\mathrm{convert}\left(17.0,\mathrm{system},\frac{\mathrm{ft}}{s},\mathrm{SI}\right)$
 ${5.181600000}$ (6)
 > $\mathrm{convert}\left(60.0,\mathrm{system},\frac{\mathrm{mi}}{h}\right)$
 ${88.00000000}$ (7)
 > $\mathrm{Units}\left[\mathrm{UseSystem}\right]\left(\mathrm{SI}\right)$

The following examples illustrate conversion of an expression which is not a simple product of a quantity and a single unit. For such an expression the conversion may be applied after combining units, or the conversion may be mapped over individual units.

Notes:

 – To enter a unit in 2-D Math input, select the unit from the appropriate Units palette. If the unit you want is not there, select $\mathrm{unit}$ and then enter the unit.
 – When you edit a unit, double brackets appear around it.
 > $\mathrm{expr}≔\frac{\mathrm{Unit}\left(\mathrm{pound}\right)\mathrm{Unit}\left(\mathrm{inch}\right)}{{\mathrm{Unit}\left(\mathrm{sec}\right)}^{2}}$
 ${\mathrm{expr}}{≔}\frac{⟦{\mathrm{lb}}⟧{}⟦{\mathrm{in}}⟧}{{⟦{s}⟧}^{{2}}}$ (8)
 > $\mathrm{combine}\left(\mathrm{expr},'\mathrm{units}'\right)$
 $\frac{{5760623099}}{{500000000000}}{}⟦{N}⟧$ (9)
 > $\mathrm{convert}\left(\mathrm{combine}\left(\mathrm{expr},'\mathrm{units}'\right),'\mathrm{system}','\mathrm{FPS}'\right)$
 $\frac{{1}}{{12}}{}⟦{\mathrm{poundal}}⟧$ (10)
 > $\mathrm{subsindets}\left(\mathrm{expr},'\mathrm{Units}:-\mathrm{Unit}'\left('\mathrm{anything}'\right),e↦\mathrm{convert}\left(e,'\mathrm{system}',\mathrm{SI}\right)\right)$
 $\frac{{5760623099}}{{500000000000}{}{⟦{s}⟧}^{{2}}}{}⟦{\mathrm{kg}}⟧{}⟦{m}⟧$ (11)

If infolevel is set to a greater integer (possible settings are 1 through 5), more detailed information about the computation method is displayed.

 > $\mathrm{infolevel}\left[\mathrm{Units}\right]≔2$
 ${{\mathrm{infolevel}}}_{{\mathrm{Units}}}{≔}{2}$ (12)
 > $\mathrm{with}\left(\mathrm{Units}\left[\mathrm{Standard}\right]\right):$
 > $32.52\mathrm{Unit}\left(\frac{\mathrm{kg}m}{{s}^{2}}\right)$
 ${32.52}{}⟦\frac{{\mathrm{kg}}{}{m}}{{{s}}^{{2}}}⟧$ (13)
 > $\mathrm{combine}\left(,'\mathrm{units}'\right)$
 convert/system:   "converting to the units N"
 ${32.52}{}⟦{N}⟧$ (14)
 > $\mathrm{convert}\left(,'\mathrm{system}'\right)$
 convert/system:   "converting to the units N"
 ${32.52}{}⟦{N}⟧$ (15)
 > $\mathrm{convert}\left(,\mathrm{system},\mathrm{FPS}\right)$
 convert/system:   "converting to the units poundal"
 ${235.2176104}{}⟦{\mathrm{poundal}}⟧$ (16)
 > $\mathrm{convert}\left(15.23\mathrm{Unit}\left(\frac{C}{g}\right),'\mathrm{system}'\right)$
 convert/system:   "converting to the units A*s/kg"
 ${15230.00}{}⟦\frac{{A}{}{s}}{{\mathrm{kg}}}⟧$ (17)
 > $\mathrm{convert}\left(,\mathrm{system},\mathrm{CGS}\right)$
 > $\mathrm{convert}\left(,\mathrm{system},\mathrm{EMU}\right)$
 convert/system:   "converting to the units abA*s/g"
 ${1.523000000}{}⟦\frac{{\mathrm{abA}}{}{s}}{{g}}⟧$ (18)
 > $\mathrm{convert}\left(\frac{\mathrm{length}\mathrm{mass}}{{\mathrm{time}}^{2}},\mathrm{system},\mathrm{dimension}\right)$
 $⟦{N}⟧$ (19)
 > $\mathrm{convert}\left(\frac{\mathrm{length}\mathrm{mass}}{{\mathrm{time}}^{2}},\mathrm{system},\mathrm{dimension},\mathrm{base}\right)$
 $⟦\frac{{\mathrm{kg}}{}{m}}{{{s}}^{{2}}}⟧$ (20)
 > $\mathrm{convert}\left(\frac{\mathrm{length}\mathrm{mass}}{{\mathrm{time}}^{2}},\mathrm{system},\mathrm{FPS},\mathrm{dimension}\right)$
 $⟦{\mathrm{poundal}}⟧$ (21)