unit-free - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.
Our website is currently undergoing maintenance, which may result in occasional errors while browsing. We apologize for any inconvenience this may cause and are working swiftly to restore full functionality. Thank you for your patience.

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