Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
manual:chapter3:units [2018/10/18 09:32] claudio |
manual:chapter3:units [2019/11/19 13:34] (current) claudio [Custom Units] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | This is a list of the units available in the '' | + | ===== Units ===== |
- | | **Length** | + | ---- |
- | | Unit | Unit name | Definition | + | |
- | | 1_m | metre | 1_m | Base SI unit of length | | + | ==== Entering Units ==== |
- | | 1_cm | centimetre | 1_cm = 0.01_m | SI length | + | |
- | | 1_mm | millimetre | 1_mm = 0.001_m | SI length | + | Units are objects that have 2 separate parts: the value and the unit per se. The value is usually a real number, but units may be attached to other numerical objects as well, for example complex numbers and vectors or matrices can have associated units. The unit part is entered using the underscore '' |
- | | 1_yd | yard | 1_yd = 3_ft | US customary length | + | |
- | | 1_ft | foot | 1_ft = 12_in | US customary length | + | The unit is an algebraic expression combining one or more unit symbols, and may be optionally surrounded by square brackets. The brackets are optional for stack input, but mandatory when units are used within a symbolic expression (to separate the unit from other algebraic operations). The '' |
- | | 1_in | inch | 1_in = 0.0254_m | US customary length | + | |
- | | 1_Mpc | megaparsec | 1_Mpc = 1000000_pc | Astronomical length | | + | Examples of valid unit objects are: \\ |
- | | 1_pc | parsec | 1_pc = (648000/ | + | '' |
- | | 1_lyr | light year | 1_lyr = 365.25_d*c | + | '' |
- | | 1_au | astronomical unit | 1_au = 149597870700_m | SI astronomical length | | + | '' |
- | | 1_km | kilometre | 1_km = 1000_m | SI length | + | '' |
- | | 1_mi | mile | 1_mi = 5280_ft | US customary length | + | '' |
- | | 1_nmi | nautical mile | 1_nmi = 1852_m | non-SI length | | + | in all cases above, the underscore is being used as a separator, but can be used as an operator as well: \\ |
- | | 1_miUS | surveying mile | 1_miUS = 5280_ftUS | US surveying length | | + | '' |
- | | 1_chain | surveying chain | 1_chain = 66_ftUS | US surveying length | | + | '' |
- | | 1_rd | rod | 1_rd =16.5_ft | US customary length | | + | in the first case, the operator '' |
- | | 1_rdUS | surveying rod | 1_rdUS =16.5_ftUS | US surveying length | | + | |
- | | 1_fath | surveying fathom | 1_fath =6_ftUS | US surveying length | | + | Exponents within a unit expression can be integer numbers, real numbers or fractional exponents. The use of fractional exponents is always preferred over real numbers because they can be simplified in an exact way. \\ |
- | | 1_ftUS | surveying foot | 1_ftUS = 1200/3937_m | US surveying length | | + | '' |
- | | 1_mil | thousandth of inch | 1_mil = 0.001_in | US customary length | | + | |
- | | 1_µ | micron | + | ==== Multiples and Submultiples ==== |
- | | 1_Å | Ångström | + | |
- | | 1_fermi | fermi or femtometre | + | Multiples and submultiples of many units are obtained by prefixing them with the standard SI prefixes. Therefore, '' |
+ | |||
+ | SI prefixes can be used with all SI units and many non-SI units where SI prefixes are common usage. Other non-SI units do not accept prefixes. | ||
+ | |||
+ | ^ SI Prefix | ||
+ | | | ||
+ | | Z | ||
+ | | | ||
+ | | P | ||
+ | | T | ||
+ | | G | ||
+ | | M | ||
+ | | k | ||
+ | | h | ||
+ | | da | $10^{1}$ | ||
+ | | d | ||
+ | | c | ||
+ | | m | ||
+ | | µ | ||
+ | | n | ||
+ | | p | ||
+ | | f | ||
+ | | a | ||
+ | | z | ||
+ | | y | ||
+ | |||
+ | ==== Operating with Units ==== | ||
+ | |||
+ | Unit objects can be operated upon normally, and the system will perform all the necessary unit conversions in the background. Unit consistency is strictly enforced for addition and subtraction, | ||
+ | |||
+ | Results of an addition or subtraction between consistent units will produce a result with the units of the first argument (argument in level 2 of the stack at the time of the operation, or the left argument in an algebraic expression). | ||
+ | |||
+ | Unit conversions can be performed directly using the '' | ||
+ | |||
+ | To reduce a unit to its base components, use the command '' | ||
+ | |||
+ | To extract the value part of a unit object, use the '' | ||
+ | |||
+ | ==== Custom Units ==== | ||
+ | |||
+ | Units in newRPL can be arbitrary symbols, not just the ones predefined in the system. For example, adding '' | ||
+ | |||
+ | Custom units can also be defined as derived units, in terms of other base units. This is done with the '' | ||
+ | |||
+ | Custom units may also accept SI prefixes, but this needs to be explicitly enabled during the unit definition. To create a custom unit that accepts SI prefixes, the name of the unit needs to be preceded by a question mark ''?'' | ||
+ | |||
+ | New units can also be defined in terms of new (unknown) base units. For example typing '' | ||
+ | From that moment the addition '' | ||
+ | |||
+ | Custom units work systemwide, the command '' | ||
+ | |||
+ | |||
+ | ==== Available Units ==== | ||
+ | |||
+ | This is a list of the units available in the '' | ||
+ | |||
+ | === Length === | ||
+ | |||
+ | ^ Unit ^ Unit name ^ Definition | ||
+ | | 1_m | metre | 1_m | Base SI unit of length | ||
+ | | 1_cm | centimetre | 1_cm = 0.01_m | SI, metric | {{fa> | ||
+ | | 1_mm | millimetre | 1_mm = 0.001_m | SI, metric | {{fa> | ||
+ | | 1_yd | yard | 1_yd = 3_ft | US Customary | {{fa> | ||
+ | | 1_ft | foot | 1_ft = 12_in | US Customary | {{fa> | ||
+ | | 1_in | inch | 1_in = 0.0254_m | US Customary | {{fa> | ||
+ | | 1_Mpc | megaparsec | 1_Mpc = 1000000_pc | Astronomical length | ||
+ | | 1_pc | parsec | 1_pc = (648000/ | ||
+ | | 1_lyr | light year | 1_lyr = 9460730472580800_m | ||
+ | | 1_au | astronomical unit | 1_au = 149597870700_m | SI astronomical length | ||
+ | | 1_km | kilometre | 1_km = 1000_m | SI, metric | {{fa> | ||
+ | | 1_mi | mile | 1_mi = 5280_ft | US Customary | {{fa> | ||
+ | | 1_nmi | nautical mile | 1_nmi = 1852_m | non-SI length | ||
+ | | 1_miUS | surveying mile | 1_miUS = 5280_ftUS | US surveying length | ||
+ | | 1_chain | surveying chain | 1_chain = 66_ftUS | US surveying length | ||
+ | | 1_rd | rod | 1_rd =16.5_ft | US customary length | ||
+ | | 1_rdUS | surveying rod | 1_rdUS =16.5_ftUS | US surveying length | ||
+ | | 1_fath | surveying fathom | 1_fath =6_ftUS | US surveying length | ||
+ | | 1_ftUS | surveying foot | 1_ftUS = 1200/3937_m | US surveying length | ||
+ | | 1_mil | thousandth of inch | 1_mil = 0.001_in | US customary length | ||
+ | | 1_µ | micron | 1_µ = 1_µm | SI length | ||
+ | | 1_Å | ångström | ||
+ | | 1_fermi | fermi | 1_fermi = 1_fm | SI length | ||
| **Area** |||| | | **Area** |||| | ||
Line 57: | Line 138: | ||
| 1_cu | cup | 1_cu = 1/16_gal | US customary volume | | | 1_cu | cup | 1_cu = 1/16_gal | US customary volume | | ||
| 1_ozfl | fluid ounce | 1_ozfl = 1/128_gal | US customary volume | | | 1_ozfl | fluid ounce | 1_ozfl = 1/128_gal | US customary volume | | ||
- | | 1_tbsp | table spoon | 1_tbsp = 1/2_ozfl | US customary volume | | + | | 1_tbsp | tablespoon |
- | | 1_tsp | tea spoon | 1_tsp = 1/6_ozfl | US customary volume | | + | | 1_tsp | teaspoon |
| 1_fbm | board foot | 1_fbm = 144_in%%^%%3 | US customary volume | | | 1_fbm | board foot | 1_fbm = 144_in%%^%%3 | US customary volume | | ||
| 1_galUK | gallon (UK) | 1_galUK = 0.00454609_m%%^%%3 | Imperial volume | | | 1_galUK | gallon (UK) | 1_galUK = 0.00454609_m%%^%%3 | Imperial volume | | ||
Line 78: | Line 159: | ||
| **Time** |||| | | **Time** |||| | ||
| Unit | Unit name | Definition | Description | | | Unit | Unit name | Definition | Description | | ||
- | | 1_yr | tropical year | 1_yr = 31556925.9747_sper | + | | 1_yr | tropical year | 1_yr = 31556925.9747_s |
| 1_d | day | 1_d = 86400_s | SI time | | | 1_d | day | 1_d = 86400_s | SI time | | ||
| 1_h | hour | 1_h = 3600_s | SI time | | | 1_h | hour | 1_h = 3600_s | SI time | | ||
| 1_min | minute | 1_min = 60_s | SI time | | | 1_min | minute | 1_min = 60_s | SI time | | ||
| 1_s | second | 1_s | Base SI unit of time | | | 1_s | second | 1_s | Base SI unit of time | | ||
- | | 1_Hz | Hertz | 1_Hz = 1_1/s | SI frequency | | + | | 1_Hz | hertz | 1_Hz = 1_1/s | SI frequency | |
| **Speed** |||| | | **Speed** |||| | ||
Line 109: | Line 190: | ||
| Unit | Unit name | Definition | Description | | | Unit | Unit name | Definition | Description | | ||
| 1_kg | kilogram | 1_kg | Base SI unit of mass | | | 1_kg | kilogram | 1_kg | Base SI unit of mass | | ||
- | | 1_g | kilogram | + | | 1_g | gram | 1_g = 0.001_kg | SI mass | |
| 1_lb | pound | 1_lb = 7000_grain | US customary mass | | | 1_lb | pound | 1_lb = 7000_grain | US customary mass | | ||
| 1_oz | ounce | 1_oz = 1/16_lb | US customary mass | | | 1_oz | ounce | 1_oz = 1/16_lb | US customary mass | | ||
Line 116: | Line 197: | ||
| 1_ton | tonne | 1_ton = 2000_lb | US customary mass | | | 1_ton | tonne | 1_ton = 2000_lb | US customary mass | | ||
| 1_tonUK | tonne (UK) | 1_tonUK = 2240_lb | Imperial mass | | | 1_tonUK | tonne (UK) | 1_tonUK = 2240_lb | Imperial mass | | ||
- | | 1_t | Metric | + | | 1_t | metric |
| 1_ozt | troy ounce | 1_ozt = 480_grain | Imperial mass | | | 1_ozt | troy ounce | 1_ozt = 480_grain | Imperial mass | | ||
- | | 1_ct | Metric | + | | 1_ct | metric |
| 1_grain | grain | 1_grain = 64.79891_mg | Imperial mass | | | 1_grain | grain | 1_grain = 64.79891_mg | Imperial mass | | ||
| 1_u | unified atomic mass | 1_u = 1.660539040E-27_kg | non-SI mass | | | 1_u | unified atomic mass | 1_u = 1.660539040E-27_kg | non-SI mass | | ||
| 1_mol | mole | 1_mol | Base SI amount of substance | | | 1_mol | mole | 1_mol | Base SI amount of substance | | ||
| 1_gmol | gram mole | 1_gmol = 1_mol | non-SI amount of substance | | | 1_gmol | gram mole | 1_gmol = 1_mol | non-SI amount of substance | | ||
- | | 1_lbmol | pound mole | 1_lbmol = 453.59237_mol | US customary substance | | + | | 1_lbmol | pound mole | 1_lbmol = 453.59237_mol | US customary |
| **Force** |||| | | **Force** |||| | ||
| Unit | Unit name | Definition | Description | | | Unit | Unit name | Definition | Description | | ||
- | | 1_N | Newton | + | | 1_N | newton |
| 1_dyn | dyne | 1_dyn = 1_g*cm/ | | 1_dyn | dyne | 1_dyn = 1_g*cm/ | ||
| 1_gf | gram-force | 1_gf = 1_g*ga | non-SI force | | | 1_gf | gram-force | 1_gf = 1_g*ga | non-SI force | | ||
| 1_kip | kip | 1_kip = 1000_lbf | US customary force | | | 1_kip | kip | 1_kip = 1000_lbf | US customary force | | ||
| 1_lbf | pound-force | 1_lbf = 1_lb*ga | US customary force | | | 1_lbf | pound-force | 1_lbf = 1_lb*ga | US customary force | | ||
- | | 1_pdl | poundal | 1_pdl = = 1_lb*ft/ | + | | 1_pdl | poundal | 1_pdl = 1_lb*ft/ |
| **Energy** |||| | | **Energy** |||| | ||
| Unit | Unit name | Definition | Description | | | Unit | Unit name | Definition | Description | | ||
- | | 1_J | Joule | 1_J = 1_N*m | SI energy | | + | | 1_J | joule | 1_J = 1_N*m | SI energy | |
| 1_kW*h | kilowatt-hour | 1_kW*h = 3.6_MJ | non-SI energy | | | 1_kW*h | kilowatt-hour | 1_kW*h = 3.6_MJ | non-SI energy | | ||
| 1_erg | erg | 1_erg = 1_dyn*cm | non-SI energy | | | 1_erg | erg | 1_erg = 1_dyn*cm | non-SI energy | | ||
- | | 1_kcal | kilo calorie | + | | 1_kcal | kilocalorie (thermochemical) |
- | | 1_cal | calorie | 1_cal = 4.184_J | non-SI energy | | + | | 1_cal | calorie |
| 1_Btu | british thermal unit | 1_Btu = =1055.056_J | Imperial energy | | | 1_Btu | british thermal unit | 1_Btu = =1055.056_J | Imperial energy | | ||
| 1_ft*lbf | foot-pound | 1_ft*lbf = 1_lb*ft*ga | US customary energy | | | 1_ft*lbf | foot-pound | 1_ft*lbf = 1_lb*ft*ga | US customary energy | | ||
| 1_therm | therm | 1_therm = 100000_Btu | Imperial energy | | | 1_therm | therm | 1_therm = 100000_Btu | Imperial energy | | ||
- | | 1_MeV | mega electronvolt | + | | 1_MeV | megaelectronvolt |
| 1_eV | electronvolt | 1_eV = 1.6021766208E-19_J | non-SI energy | | | 1_eV | electronvolt | 1_eV = 1.6021766208E-19_J | non-SI energy | | ||
| **Power** |||| | | **Power** |||| | ||
| Unit | Unit name | Definition | Description | | | Unit | Unit name | Definition | Description | | ||
- | | 1_W | Watt | 1_W = 1_J/s | SI power | | + | | 1_W | watt | 1_W = 1_J/s | SI power | |
| 1_kW | kilowatt | 1_kW = 1000_W | SI power | | | 1_kW | kilowatt | 1_kW = 1000_W | SI power | | ||
| 1_MW | megawatt | 1_MW = 1000000_W | SI power | | | 1_MW | megawatt | 1_MW = 1000000_W | SI power | | ||
Line 157: | Line 238: | ||
| **Pressure** |||| | | **Pressure** |||| | ||
| Unit | Unit name | Definition | Description | | | Unit | Unit name | Definition | Description | | ||
- | | 1_Pa | Pascal | + | | 1_Pa | pascal |
| 1_atm | atmospheric pressure | 1_atm = 101325_Pa | non-SI pressure | | | 1_atm | atmospheric pressure | 1_atm = 101325_Pa | non-SI pressure | | ||
| 1_bar | bar | 1_bar = 100000_Pa | non-SI pressure | | | 1_bar | bar | 1_bar = 100000_Pa | non-SI pressure | | ||
| 1_psi | pound per square inch | 1_psi = 1_lbf/ | | 1_psi | pound per square inch | 1_psi = 1_lbf/ | ||
- | | 1_Torr | Torricelli | + | | 1_Torr | torr | 1_Torr = 1/760_atm | non-SI pressure | |
| 1_mmHg | millimetres of mercury (at 0°C) | 1_mmHg = 13595.1_kg/ | | 1_mmHg | millimetres of mercury (at 0°C) | 1_mmHg = 13595.1_kg/ | ||
| 1_inHg | inches of mercury (at 0°C) | 1_inHg = 13595.1_kg/ | | 1_inHg | inches of mercury (at 0°C) | 1_inHg = 13595.1_kg/ | ||
Line 168: | Line 249: | ||
| **Temperature** |||| | | **Temperature** |||| | ||
| Unit | Unit name | Definition | Description | | | Unit | Unit name | Definition | Description | | ||
- | | 1_°C | celsius (or degree | + | | 1_°C | celsius (or degree |
| 1_Δ°C | celsius temperature change | 1_Δ°C = 1_ΔK | Change of temperature | | | 1_Δ°C | celsius temperature change | 1_Δ°C = 1_ΔK | Change of temperature | | ||
- | | 1_°F | farenheit (or degree | + | | 1_°F | farenheit (or degree |
| 1_Δ°F | farenheit temperature change | 1_Δ°F = 1_Δ°R | Change of temperature | | | 1_Δ°F | farenheit temperature change | 1_Δ°F = 1_Δ°R | Change of temperature | | ||
| 1_K | kelvin | 1_K | Base SI temperature (abs. scale) | | | 1_K | kelvin | 1_K | Base SI temperature (abs. scale) | | ||
Line 187: | Line 268: | ||
| 1_Fdy | faraday | 1_Fdy = 96485.33289_C | non-SI electrical charge | | | 1_Fdy | faraday | 1_Fdy = 96485.33289_C | non-SI electrical charge | | ||
| 1_H | henry | 1_H = 1_Wb/A | SI inductance | | | 1_H | henry | 1_H = 1_Wb/A | SI inductance | | ||
- | | 1_mho | mho (Siemens) | + | | 1_mho | mho | 1_mho = 1_S | non-SI conductance | |
| 1_S | siemens | 1_S = 1_1/Ω | SI conductance | | | 1_S | siemens | 1_S = 1_1/Ω | SI conductance | | ||
| 1_T | tesla | 1_T = 1_Wb/ | | 1_T | tesla | 1_T = 1_Wb/ | ||
Line 220: | Line 301: | ||
| 1_Bq | becquerel | 1_Bq = 1_1/s | SI radiation | | | 1_Bq | becquerel | 1_Bq = 1_1/s | SI radiation | | ||
| 1_Ci | curie | 1_Ci = 3.7E10_Bq | non-SI radiation | | | 1_Ci | curie | 1_Ci = 3.7E10_Bq | non-SI radiation | | ||
- | | 1_R | rontgen | + | | 1_R | roentgen |
| **Viscosity** |||| | | **Viscosity** |||| |