convert/system
convert a unit to the default unit in a system of units
Calling Sequence
Parameters
Description
Examples
convert(u, system, unitFrom, systemTo, opts)
convert(u*Unit(unitFrom), system, systemTo, opts)
convert(dim, system, systemTo, dimension=true, opts)
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
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.
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 and then enter the unit.
When you edit a unit, double brackets appear around it.
If infolevel is set to a greater integer (possible settings are 1 through 5), more detailed information about the computation method is displayed.
convert/system: "converting to the units N"
convert/system: "converting to the units lbf"
convert/system: "converting to the units A*s/kg"
Error, (in `convert/system`) cannot represent the given unit in the system `CGS`
convert/system: "converting to the units abA*s/g"
See Also
convert
convert/dimensions
convert/temperature
infolevel
type/dimension
Units
Units/Index
Units/Natural
Units/Standard
Units[GetSystems]
Units[UseSystem]
Units[UsingSystem]
Download Help Document