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
convert/system - convert a unit to the default unit in a system of units
Calling Sequence
convert(u, system, unitFrom, systemTo, opts)
convert(u*Unit(unitFrom), system, systemTo, opts)
convert(dim, system, systemTo, dimension=true, opts)
Parameters
u
-
expression
dim
dimension
unitFrom
symbol; unit to be converted from
systemTo
(optional) symbol; system of units to be converted to
opts
(optional) equation(s) of the form option=value where option is one of base, dimension or symbolic; specify options for the conversion
Description
The convert(u, system, unitFrom, systemTo) function multiplies the value u by the conversion factor to convert from the unit UnitFrom to the default unit of the same dimension in the system of units SystemTo.
The function Unit can be either Units[Unit] or the Unit routine from the Units[Standard] or the Units[Natural] environment.
The unit unitFrom and system SystemTo can be any unit label, for example, name or symbol, accepted by the Units package.
If SystemTo is not specified, the default system of units is used. See UseSystem and UsingSystem.
Note: Temperature conversions are for temperature intervals not absolute temperatures. For example, 1 degree Celsius is converted to 1 kelvin. For conversions of absolute temperatures, use convert/temperature.
You can modify the properties of the conversion by including options opts. The opts argument can contain one or more of the following equations.
base = true or false
This option specifies that the resulting unit should be returned in terms of base units, rather than derived units. By default, this option is set to false.
dimension = true or false
If this option is given, the third calling sequence is used. This indicates that the given dimension should be converted into the corresponding units of the given system. By default, this option is set to false.
symbolic = true or false
This option specifies whether annotations to units are ignored. By default, this option is set to false.
Examples
The following examples illustrate conversion of an expression which is not a simple product of a quantity and a single unit. For such an expression the conversion may be applied after combining units, or the conversion may be mapped over individual units.
If infolevel is set to a greater integer (possible settings are 1 through 5), more detailed information about the computation method is displayed.
convert/system: "converting to the units poundal"
Error, (in `convert/system`) cannot represent the given unit in the system `CGS`
convert/system: "converting to the units abA*s/g"
See Also
convert, convert/dimensions, convert/temperature, infolevel, type/dimension, Units, Units/Index, Units/Natural, Units/Standard, Units[GetSystems], Units[UseSystem], Units[UsingSystem]
Download Help Document
