system - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


convert/system

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

 

Calling Sequence

Parameters

Description

Examples

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

convert17.0,system,fts

5.181600000

(1)

convert17.0,system,fts,SI

5.181600000

(2)

convert60.0,system,mih

26.82240000

(3)

UnitsGetSystems

Atomic,CGS,EMU,ESU,FPS,IPS,MKS,MTS,SI

(4)

UnitsUseSystemFPS

convert17.0,system,fts

17.0

(5)

convert17.0,system,fts,SI

5.181600000

(6)

convert60.0,system,mih

88.00000000

(7)

UnitsUseSystemSI

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

– 

When you edit a unit, double brackets appear around it.

exprUnitpoundUnitinchUnitsec2

exprlbins2

(8)

combineexpr,units

5760623099500000000000N

(9)

convertcombineexpr,units,system,FPS

508196133lbf

(10)

subsindetsexpr,Units:-Unitanything,econverte,system,SI

5760623099500000000000s2kgm

(11)

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

infolevelUnits2

infolevelUnits2

(12)

withUnitsStandard:

32.52Unitkgms2

32.52kgms2

(13)

combine,units

convert/system:   "converting to the units N"

32.52N

(14)

convert,system

convert/system:   "converting to the units N"

32.52N

(15)

convert,system,FPS

convert/system:   "converting to the units lbf"

7.310786830lbf

(16)

convert15.23UnitCg,system

convert/system:   "converting to the units A*s/kg"

15230.00Askg

(17)

convert,system,CGS

Error, (in `convert/system`) cannot represent the given unit in the system `CGS`

convert,system,EMU

convert/system:   "converting to the units abA*s/g"

1.523000000abAsg

(18)

convertlengthmasstime2,system,dimension

N

(19)

convertlengthmasstime2,system,dimension,base

kgms2

(20)

convertlengthmasstime2,system,FPS,dimension

lbf

(21)

See Also

convert

convert/dimensions

convert/temperature

infolevel

type/dimension

Units

Units/Index

Units/Natural

Units/Standard

Units[GetSystems]

Units[UseSystem]

Units[UsingSystem]