convert a list of units into a conversion table - Maple Help

Online Help

All Products    Maple    MapleSim

Home : Support : Online Help : Science and Engineering : Units : Conversions : convert/conversion_table

convert/conversion_table - convert a list of units into a conversion table

Calling Sequence

convert([L1, L2], conversion_table, opts)

convert(L, conversion_table, opts)


L1, L2, L


lists of symbols; unit names or symbols



(optional) equation(s) of the form option=value where option is one of energy, filter, order, output, or symbolic; specify options for the conversion



The convert([L1, L2], conversion_table) function creates a table indexed by the cartesian product of the lists L1 and L2 where the entries are the conversion factors from the first index to the second.


The convert(L, conversion_table) function is a short form for convert([L, L], conversion_table).


When a conversion factor cannot be found between two valid units, the entry in the table is FAIL.


You can modify the properties of the conversion by including options opts. The opts argument can contain one or more of the following equations.




energy = true or false


This option is passed as an option to the convert/units routine.  If this option is set to true, the conversion can be between energy units, not only units with the same dimension. See Energy Conversions. The default value is false.




filter = anything


This option is a filter applied to the conversion factors.  For example, filter=evalf5 evaluates all conversion factors to five digit floating-point numbers.




order =lexorder or a procedure


This option specifies the order in which names should be listed. The order can be specified by a procedure or be the lexicographical order (see sort). The value of this option determines the output order only for output=grid or columns.




output = table, grid, columns


By default, output=table. The output is a table as described above.


If this option is set to grid, a formatted table is returned with unit names and unit symbols of the list L1 in the first two columns, and unit symbols of the list L2 (where available) in the first row.


If this option is set to columns, a formatted table is returned. In the first column, the unit names from L1 are listed in order. For each entry in the first column, an entry in the second column appears for each unit in L2 for which a conversion exists along with conversion factor in the third column.




symbolic = `true` or `false`


This option is passed to the convert/units function as an option. The default value is false.











To:NpoundalslbfUnit NameSymbolnewtonsN 1.7.2330.2248poundals 0.13831.0.03108poundforceslbf 4.44832.171.



To:ergsHPWUnit NameSymbolergs per secondergs 1.1.34110-101.10-7abwattsabW 1.1.34110-101.10-7horsepowersHP 7.4571091.745.7poncelets 9.8071091.315980.7statwattsstatW 1.1.34110-101.10-7wattsW 1.1070.0013411.



To:mmcmdmmUnit NameSymbolmillimetersmm 1110110011000centimeterscm 1011101100decimetersdm 100101110metersm 1000100101



To:kgJmolUnit NameSymbol1 per meter1m 2.2110-420.1196joules per moleJmol 1.84810-411.hartreesE0 4.85110-352.6251061 per second1s 7.37210-513.9910-10kilogramskg 1.5.4121040caloriescal 4.65510-172.521024



Units From:Units To:Conversion Factor:dynesgf0.00102kipf2.24810-9N0.00001ozf0.00003597planck_force8.26110-50pond0.00102poundal0.00007233lbf0.000002248sn1.10-8tonf1.12410-9gramforcesdyn980.7kipf0.000002205N0.009807ozf0.03527planck_force8.10110-47pond1.poundal0.07093lbf0.002205sn0.000009807tonf0.000001102kipfdyn4.448108gf4.536105N4448.ozf16000.planck_force3.67510-41pond4.536105poundal32170.lbf1000.sn4.448tonf0.5newtonsdyn1.105gf102.kipf0.0002248ozf3.597planck_force8.26110-45pond102.poundal7.233lbf0.2248sn0.001tonf0.0001124ounceforcesdyn27800.gf28.35kipf0.0000625N0.278planck_force2.29710-45pond28.35poundal2.011lbf0.0625sn0.000278tonf0.00003125planck forcesdyn1.211049gf1.2341046kipf2.7211040N1.211044ozf4.3541044pond1.2341046poundal8.7561044lbf2.7211043sn1.211041tonf1.3611040pondsdyn980.7gf1.kipf0.000002205N0.009807ozf0.03527planck_force8.10110-47poundal0.07093lbf0.002205sn0.000009807tonf0.000001102poundalsdyn13830.gf14.1kipf0.00003108N0.1383ozf0.4973planck_force1.14210-45pond14.1lbf0.03108sn0.0001383tonf0.00001554poundforcesdyn4.448105gf453.6kipf0.001N4.448ozf16.planck_force3.67510-44pond453.6poundal32.17sn0.004448tonf0.0005sthenedyn1.108gf1.02105kipf0.2248N1000.ozf3597.planck_force8.26110-42pond1.02105poundal7233.lbf224.8tonf0.1124tonforcesdyn8.896108gf9.072105kipf2.N8896.ozf32000.planck_force7.34910-41pond9.072105poundal64350.lbf2000.sn8.896


See Also

convert, convert/dimensions, convert/unit_free, convert/units, Energy Conversions, evalf, FAIL, sort, Units, Units/Index

Download Help Document

Was this information helpful?

Please add your Comment (Optional)
E-mail Address (Optional)
What is ? This question helps us to combat spam