Normalize physical quantity¤

This transformer normalizes physical quantities.

Upon its creation, the Physical Quantities Normalizer can be configured by specifying a target unit and a number format. Both parameters are optional.

The target unit parameter stands for a metric system such as the International System of Units (SI), which is the default unit system, unless overridden.

Upon its execution, the Physical Quantities Normalizer will convert the given physical magnitude to a numerical value without the physical unit. For example, "1 km" will be converted to "1000.0". This is called a normalization.

By default, all quantities are normalized to their base unit. For instance, lengths will be normalized to metres.

The physical magnitudes are expected to be expressed in the form {Number}{UnitPrefix}{Symbol}. In our previous example "1 km", the number is 1, the unit prefix is k (kilo), and the symbol is m (meter).

Spaces between the number and the physical unit, consisting of unit prefix and symbol, are optional.

Additionally: * If one input is provided, the physical quantities are parsed from the provided strings of the form "1 km". * If two inputs are provided, the numeric values are parsed from the first input and the units from the second input.

SI units and common derived units are supported. The following section lists all supported units.

Supported units¤

Time¤

Time is expressed in seconds (symbol: s). The following alternative symbols are supported: * mo_s: day29.53059 * mo_g: year/12.0 * a: day365.25 * min: min * a_g: year * mo: (day365.25)/12.0 * mo_j: (day365.25)/12.0 * a_j: day365.25 * h: h * a_t: day365.24219 * d: day

Length¤

Length is expressed in metres (symbol: m). The following alternative symbols are supported: * in: c(cm254.0) * nmi: m1852.0 * Ao: dnm * mil: m(c(cm254.0)) * yd: ((c(cm254.0))12.0)3.0 * AU: m1.49597871E11 * ft: (c(cm254.0))12.0 * pc: m3.085678E16 * fth: ((c(cm254.0))12.0)6.0 * mi: ((c(cm254.0))12.0)5280.0 * hd: (c(cm254.0))4.0

Mass¤

Mass is expressed in kilograms (symbol: kg). The following alternative symbols are supported: * lb: lb * ston: hlb20.0 * t: Mg * stone: lb14.0 * u: AMU * gr: (mg6479891.0)/100000.0 * lcwt: lb112.0 * oz: oz * g: g * scwt: hlb * dr: oz/16.0 * lton: (lb112.0)20.0

Electric current¤

Electric current is expressed in amperes (symbol: A). The following alternative symbols are supported: * Bi: daA * Gb: cm·(A/m)*250.0/[one?]

Temperature¤

Temperature is expressed in kelvins (symbol: K). The following alternative symbols are supported: * Cel: ℃

Amount of substance¤

Amount of substance is expressed in moles (symbol: mol).

Luminous intensity¤

Luminous intensity is expressed in candelas (symbol: cd).

Area¤

Area is expressed in square metres (symbol: m²). The following alternative symbols are supported: * m2: m² * ar: hm² * syd: ((c(cm254.0))12.0)3.0² * cml: [one?]/4.0·m(c(cm254.0))² * b: hfm² * sft: (c(cm254.0))12.0² * sin: c(cm*254.0)²

Volume¤

Volume is expressed in cubic metres (symbol: ㎥). The following alternative symbols are supported: * st: [㎥?] * bf: (c(cm254.0)³)144.0 * cyd: ((c(cm254.0))12.0)3.0³ * cr: ((c(cm254.0))12.0³)128.0 * L: L * l: l * cin: c(cm254.0)³ * cft: (c(cm254.0))*12.0³ * m3: ㎥

Energy¤

Energy is expressed in joules (symbol: J). The following alternative symbols are supported: * cal_IT: (J41868.0)/10000.0 * eV: J1.602176487E-19 * cal_m: (J419002.0)/100000.0 * cal: m(J4184.0) * cal_th: m(J*4184.0)

Angle¤

Angle is expressed in radians (symbol: rad). The following alternative symbols are supported: * circ: [one?]·rad2.0 * gon: ([one?]·rad/180.0)0.9 * deg: [one?]·rad/180.0 * ': ([one?]·rad/180.0)/60.0 * '': (([one?]·rad/180.0)/60.0)/60.0

Others¤

1/m, derived units: Ky: c(1/m)
kg/(m·s), derived units: P: g/(s·cm)
bit/s, derived units: Bd: bit/s
bit, derived units: By: bit*8.0
Sv
N
Ω, derived units: Ohm: Ω
T, derived units: G: T/10000.0
sr, derived units: sph: [one?]·sr*4.0
F
C/kg, derived units: R: (C/kg)*2.58E-4
cd/m², derived units: sb: cd/cm², Lmb: cd/([one?]·cm²)
Pa, derived units: bar: Pa100000.0, atm: Pa101325.0
kg/(m·s²), derived units: att: k(g·(m/s²)*9.80665)/cm²
m²/s, derived units: St: cm²/s
A/m, derived units: Oe: (A/m)*250.0/[one?]
kg·m²/s², derived units: erg: cm²·g/s²
kg/m³, derived units: g%: g/dl
mho
V
lx, derived units: ph: lx/10000.0
m/s², derived units: Gal: cm/s², m/s2: m/s²
m/s, derived units: kn: m*1852.0/h
m·kg/s², derived units: gf: g·(m/s²)9.80665, lbf: lb·(m/s²)9.80665, dyn: cm·g/s²
m²/s², derived units: RAD: cm²·g/(s²·hg), REM: cm²·g/(s²·hg)
C
Gy
Hz
H
lm
W
Wb, derived units: Mx: Wb/1.0E8
Bq, derived units: Ci: Bq*3.7E10
S

Examples¤

Notation: List of values are represented via square brackets. Example: [first, second] represents a list of two values “first” and “second”.

Example 1:

Input values:
1. [1 km]
Returns: [1000.0]

Example 2:

Input values:
1. [1.0000 ft]
Returns: [0.3048]

Example 3:

Input values:
1. [1.0lb]
Returns: [0.45359237]

Example 4:

Input values:
1. [1000000000.0 nm]
Returns: [1.0]

Example 5:

Input values:
1. [-1E6 m]
Returns: [-1000000.0]

Example 6:

Parameters
- numberFormat: de
Input values:
1. [1.000,5 m]
Returns: [1000.5]

Example 7:

Input values:
1. [1,000.5 m]
Returns: [1000.5]

Example 8:

Parameters
- targetUnit: mi
Input values:
1. [1 km]
Returns: [0.621371192237334]

Example 9:

Parameters
- targetUnit: m
Input values:
1. [1 kg]
Returns: []
Throws error: ValidationException

Example 10:

Input values:
1. [100.0]
Returns: []
Throws error: ValidationException

Example 11:

Input values:
1. [1]
2. [km]
Returns: [1000.0]

Example 12:

Input values:
1. [1, 10000]
2. [km, mm]
Returns: [1000.0, 10.0]

Example 13:

Input values:
1. [1, 10000, 10]
2. [km, mm]
Returns: []
Throws error: ValidationException

Parameter¤

Target unit¤

Target unit. Can be left empty to convert to the respective SI base units.

ID: targetUnit
Datatype: string
Default Value: None

Number format¤

The IETF BCP 47 language tag, e.g., ‘en’.

ID: numberFormat
Datatype: string
Default Value: en

Advanced Parameter¤

None