Maple Professional
Maple Academic
Maple Student Edition
Maple Personal Edition
Maple Player
Maple Player for iPad
MapleSim Professional
MapleSim Academic
Maple T.A. - Testing & Assessment
Maple T.A. MAA Placement Test Suite
Möbius - Online Courseware
Machine Design / Industrial Automation
Aerospace
Vehicle Engineering
Robotics
Power Industries
System Simulation and Analysis
Model development for HIL
Plant Modeling for Control Design
Robotics/Motion Control/Mechatronics
Other Application Areas
Mathematics Education
Engineering Education
High Schools & Two-Year Colleges
Testing & Assessment
Students
Financial Modeling
Operations Research
High Performance Computing
Physics
Live Webinars
Recorded Webinars
Upcoming Events
MaplePrimes
Maplesoft Blog
Maplesoft Membership
Maple Ambassador Program
MapleCloud
Technical Whitepapers
E-Mail Newsletters
Maple Books
Math Matters
Application Center
MapleSim Model Gallery
User Case Studies
Exploring Engineering Fundamentals
Teaching Concepts with Maple
Maplesoft Welcome Center
Teacher Resource Center
Student Help Center
Units[Converter][AddUnit] - add a unit to or modify a unit in the Unit Converter
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, , 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 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
Change the spelling in the text of 'centimeters per second'
Set the already existing unit of kilowatt hour as the default 'From' unit
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]
Download Help Document