pyunitwizard.dialects.ucum.parse_quantity#
- pyunitwizard.dialects.ucum.parse_quantity(value, code, *, unit, units_metadata=None, form=None)[source]#
Convert UCUM values into an explicitly required computing unit.
- Parameters:
value (numeric scalar or array-like) – Values in the declared UCUM code. Inputs are not modified.
code (str) – Case-sensitive UCUM code parsed by actual ucumvert.
unit (str or pint.Unit) – Required computing destination; session units supply no defaults.
units_metadata (str, optional) – Required temperature semantics, as in
validate_unit.form (str, optional) – Computing backend; defaults to the session form or Pint.
- Returns:
Converted values, potentially promoted to floating point.
- Return type:
quantity
- Raises:
RecordError – For unsupported codes, nonnumeric values or incompatible definitions.
ModuleNotFoundError – If the optional provider or requested backend is unavailable.
Examples
>>> round(float(parse_quantity(1000, 'nmol/L', unit='micromolar', form='pint').magnitude), 12) 1.0