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

Online Help

All Products    Maple    MapleSim


convert/unit_free

convert to unit-free form

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

convert(u, unit_free, unit)

Parameters

u

-

expression

unit

-

(optional) name

Description

• 

The convert(u, unit_free) function returns the unit-free component of u. If u is of type unit, then 1 is returned.

• 

The convert(u, unit_free, unit) function returns the unit-free component of u and assigns the unit component of u to unit. If u is of type unit, then 1 is returned. If u is unit-free, then 1 is assigned to unit.

• 

The term unit-free describes a scalar quantity with no (multiplicative) unit attached to it. Conversion to unit-free does not apply directly to any non-scalar Maple object or data structure, which may still have units embedded within it.

Examples

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.

convert100.0,unit_free

100.0

(1)

convert234,unit_free,unit1

234

(2)

unit1

1

(3)

exprconvert45sinxUnitfarad,unit_free,unit2

expr45sinx

(4)

unit2

F

(5)

aexprunit2

a45sinxF

(6)

The conversion to unit_free state does not recurse into, or map over, non-scalar objects. Examples illustrating such mapping or effective unit-stripping recursion are shown below.

MVectorrow3Unitgram,5Unitkilogram

M3g5kg

(7)

mapconvert,M,unit_free

35

(8)

tIntsinxUnitmeter,x=1Units..10Units

ts10ssinxmⅆx

(9)

subsindetst,with_unit,zconvertz,unit_free

110sinxⅆx

(10)

subsindetst,specfuncanything,Units:-Unit,1

110sinxⅆx

(11)

If a non-scalar object contains a mix of units then it may be desirable to combine the units or convert to a single system, so as to get correct scaling.

exprMrange=3Unitkg..5Unitg

exprMrange=3kg..5g

(12)

subsindetsexpr,with_unit,zconvertcombinez,units,unit_free

Mrange=3..1200

(13)

exprMrange=3Unitkg..5Unitlb

exprMrange=3kg..5lb

(14)

subsindetsexpr,with_unit,zconvertconvertz,system,FPS,unit_free

Mrange=30000000045359237..5

(15)

See Also

convert

convert,conversion_table

convert,dimensions

convert,units

electric capacitance

type/with_unit

Units

Units/Index