Overview of the Units Package - Maple Programming Help

Online Help

All Products    Maple    MapleSim


Home : Support : Online Help : Science and Engineering : Units : Units

Overview of the Units Package

 

Basic Functionality

List of Units Package Commands

Examples

Compatibility

Basic Functionality

• 

The Units package contains commands for unit conversion and provides environments for performing calculations with units.

  

Using Units and Dimensions in Maple Documents provides an overview of using units and dimensions including how to:

– 

Distinguish between environments

– 

Perform conversions

– 

Perform computations with units

– 

Control the default system of units

– 

Add new systems of units

  

There is also an introductory tutorial on units and tolerances in the Maple Portal.  To access this tutorial, see Units Tutorial.

• 

To perform quick unit conversions, use the Unit Converter point-and-click interface.

• 

The Units package has two distinct sets of commands to customize the quantities available. The commands that manage the set of dimensions, units, and systems of units available in execution groups are listed below. The commands that manage the set of dimensions and units available in the Unit Converter dialog are listed in the Unit Converter Support Package page.

• 

For additional information about the Units package, see the Details and Index pages or one of the following four worksheets that introduce the use of units in the various Maple environments:

Standard Units Environment

Natural Units Environment

Simple Units Environment

Default Units Environment

  

By default, loading the Units package enables the Simple Units Environment.

Accessing Units Package Commands

• 

Each command in the Units package can be accessed by using either the long form or the short form of the command name in the command calling sequence.

  

Long Form

Units[GetUnit]('light_year');

  

Short Form

with(Units):

GetUnit('light_year');

• 

If you load the Units package in order to use the short form of command names, be aware that this enables the Simple Units Environment by default. You can call the Units[UseMode] command beforehand to select a different units environment, or load another Units subpackage afterwards to override the environment. If you want to use the short form of Units commands, but not load any of the subpackages so that you stay in the default Units environment, you can load the Units[CommandsOnly] package.

List of Units Package Commands

  

The following is a list of available commands.

AddBaseUnit

AddDimension

AddSystem

AddUnit

GetDimension

GetDimensions

GetSystem

GetSystems

GetUnit

GetUnits

HasDimension

HasSystem

HasUnit

RemoveDimension

RemoveSystem

Unit

UseContexts

UseMode

UseSystem

UseUnit

UsingContexts

UsingSystem

 

 

  

To display the help page for a particular Units package command, click the corresponding hyperlink.

Examples

To directly convert a single value from one unit to another, use the convert/units command.

convert4.532,'units','N''m'2,'lb''ft''s'2'ft'2

3.045363395

(1)

To directly convert an absolute temperature to a different temperature scale, use the convert/temperature command. For temperature values, the convert/units command converts intervals.

convert0,'units','degC','degF'

0

(2)

convert0,'temperature','degC','degF'

32

(3)

Explore computations using units and systems in the Simple units environment.

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.

withUnits:

Automatically loading the Units[Simple] subpackage

UsingSystem

SI

(4)

distance3.53'ft'+4.1'm'

distance5.175944000m

(5)

GetSystems

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

(6)

UseSystem'FPS'

distance3.53'ft'+4.1'm'

distance16.98144357ft

(7)

For information on creating and managing systems, units, and dimensions, see the Units Package Commands page.

Compatibility

• 

The Units package was updated in Maple 2018.

See Also

convert/conversion_table

convert/system

convert/temperature

convert/units

type/unit

type/unit_name

type/with_unit

Units Tutorial

Units/annotations

Units/Commands

Units/Converter

Units/Default

Units/Details

Units/Index

Units/Natural

Units/Simple

Units/Standard

Units[CommandsOnly]

Using Units and Dimensions in Maple Documents