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