convert/units - Maple Help

Online Help

All Products    Maple    MapleSim


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

convert/units

convert between units

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

convert(u, 'units', unitFrom, unitTo, opts)

convert(u*Unit(unitFrom), 'units', unitTo, opts)

Parameters

u

-

expression

unitFrom

-

symbol; unit to be converted from

unitTo

-

symbol; unit to be converted to

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(u, 'units', unitFrom, unitTo) function 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.

  

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.

  

 

  

'energy'=truefalse

  

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 1 to convert to a dimensionless quantity.  For more information about energy transformations, see Energy Conversions.

  

 

  

'symbolic'=truefalse

  

This option specifies whether annotations to units should be ignored.  By default, this option is set to false.

Examples

convert100.0,'units','ft','m'

30.48000000

(1)

convert46145,'units','yards','kilometers'

10548747250000

(2)

convert120,'units','W','hp'

200000000000000012428331193037837

(3)

convert1,'units','permittivityAtomic',1,'energy'=true

1

(4)

convert5Nmradius,'units',Nm,'symbolic'=true

5Nm

(5)

In the following example, the expression being converted has a unit associated with it. Here, only the unitTo parameter needs to provided.

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 unit and then enter the unit.

– 

In Maple 2015 and later versions, the double brackets around a unit are not displayed unless you are editing the unit.

withUnits[Standard]:

3'kg''m''s'

3kgms

(6)

convert,'units','lb''ft''h'

4500000000000005760623099lbfth

(7)

See Also

convert

convert,conversion_table

convert/dimensions

convert/system

convert/temperature

convert/unit_free

electric permittivity

Energy Conversions

Units

Units/annotations

Units/Index

 


Download Help Document

Was this information helpful?



Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam