Add Unit - Maple Help

Online Help

All Products    Maple    MapleSim


Units[Converter]

  

AddUnit

  

add a unit to or modify a unit in the Unit Converter

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

AddUnit(unit, opts)

Parameters

unit

-

symbol; unit name

opts

-

equation(s) of the form option=value where option is one of 'display', 'default', or 'make'; specify options for the unit

Description

• 

The AddUnit(unit, opts) function adds a new unit to or modifies options of an existing unit in the Unit Converter.

• 

If the dimension corresponding to unit is not in the Unit Converter, the command Units[Converter][AddDimension](convert(unit, 'dimensions', 'base')) is executed automatically.

• 

This procedure accepts symbols and variations in spelling. For example, ms, meters/second, and metre/second represent the same unit in the Unit Converter.

• 

You describe the options of the unit by using the optional arguments. The opts argument can contain one or more of the following equations.

  

 

  

'display'=string

  

This option gives the text that appears in the drop-down boxes in the Unit Converter dialog box.  If this option is not given, the entry is unit.

  

 

  

'default'=From, To, or a set of these

  

This option specifies whether the unit appears as the default unit in the From: or To: drop-down box when the corresponding dimension is selected in the Unit Converter dialog box.

  

 

  

'make'=truefalse

  

This option specifies whether the conversion tables are rebuilt after the unit has been added to the Unit Converter.  By default, this option is set to true. If 10 or more dimensions or units are being added to or removed from the Unit Converter in the same execution group, it is recommended that you execute the Units[Converter][MakeConverter]() calling sequence afterward.

Examples

withUnitsConverter:

AddUnitparsecyearJulian,display=parsecs per Julian year

Change the spelling in the text of 'centimeters per second'

AddUnitcms,display=centimetres per second

Set the already existing unit of kilowatt hour as the default 'From' unit

AddUnitkWh,default=From

See Also

Units

Units/Converter

Units[AddUnit]

Units[Converter][AddDimension]

Units[Converter][GetUnit]

Units[Converter][GetUnits]

Units[Converter][HasUnit]

Units[Converter][MakeConverter]

Units[Converter][RemoveUnit]