convert/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

Parameters

Description

Examples

Calling Sequence

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

convert(L, conversion_table, opts)

Parameters

L1, L2, L

-

lists of symbols; unit names or symbols

opts

-

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

Description

• 

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.

Examples

Lnewton,gf,pond,sthene,dyne,ozf,lbf,tonforce,poundal,kipf:

AconvertL,conversion_table:

Anewton,gf

20000000196133

(1)

Adyne,ozf

3200000008896443230521

(2)

convertN,poundal,lbf,conversion_table,output=grid,filter=evalf4

To:NpoundalslbfUnit NameSymbolnewtonsN 1.7.2330.2248poundals 0.13831.0.03108poundforceslbf 4.44832.171.

(3)

convertW,hp,poncelet,abW,statW,ergs,W,hp,ergs,conversion_table,output=grid,filter=evalf4,order=lexorder

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.

(4)

convertmm,cm,dm,m,conversion_table,output=grid

To:mmcmdmmUnit NameSymbolmillimetersmm 1110110011000centimeterscm 1011101100decimetersdm 100101110metersm 1000100101

(5)

convert1m,Jmol,E0,1s,kg,cal,kg,Jmol,conversion_table,output=grid,energy,filter=evalf4

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

(6)

convertUnits[GetUnits]dimension=force,conversion_table,output=columns,energy,filter=evalf4

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

(7)

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