|
Calling Sequence
|
|
convert(expr, 'units', unitFrom, unitTo, opts)
convert(exprWithUnit, 'units', unitTo, opts)
|
|
Parameters
|
|
expr
|
-
|
expression
|
unitFrom
|
-
|
symbol; unit to be converted from
|
unitTo
|
-
|
symbol; unit to be converted to
|
exprWithUnit
|
-
|
expression with unit
|
opts
|
-
|
(optional) equation(s) of the form option=value where option is one of energy or symbolic; specify options for the conversion
|
|
|
|
|
Description
|
|
•
|
The convert(expr, 'units', unitFrom, unitTo) command multiplies the value u by the conversion factor from unitFrom to unitTo.
|
•
|
The units unitTo and unitFrom can be labeled in any way accepted by the Units package, for example, name, abbreviation, or symbol.
|
•
|
For the second calling sequence, exprWithUnit can be any expression with a unit attached in any valid way. This can be, for example, 3*Unit('cm') or an expression with a unit added from the Units palette.
|
–
|
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.
|
|
Note: Thermodynamic temperature conversions are for temperature intervals, not absolute temperatures. For example, 1 degree Celsius is converted to 1 kelvin, not 274.15 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.
|
|
If this option is set to true, the conversion can be between energy units, not necessarily units with the same dimensions. Furthermore, unitTo can be set to to convert to a dimensionless quantity. For more information about energy transformations, see Energy Conversions.
|
|
This option specifies whether annotations to units should be ignored. By default, this option is set to false.
|
|
|
Examples
|
|
>
|
|
>
|
|
>
|
|
| (3) |
>
|
|
In the next two examples, the expression being converted has a unit associated with it. Here, only the unitTo parameter needs to provided.
>
|
|
>
|
|
>
|
|
| (7) |
|
|
|