from_string

justunits.from_string(unit_text: str) → justunits.DerivedUnit

Parameters

unit_text –

Returns:

Examples

>>> import justunits
>>> torque = justunits.from_string("Nm")
>>> torque
(AUnit(N 'newton' force, weight), AUnit(m 'meter' length))

>>> str(torque)
'N⋅m'

>>> millisecond = justunits.from_string("ms")
>>> millisecond
(AUnit(ms 'millisecond' time, 0.001s),)

>>> millisecond.with_prefix(SiPrefixes.nano)
(AUnit(ns 'nanosecond' time, 1e-09s),)

>>> apple = justunits.from_string("apple")
>>> apple
(UnknownUnit('apple'),)

>>> justunits.register_unit(create_unit("apple", "apple", "fruit"))
>>> apple = justunits.from_string("apple")
>>> apple
(AUnit(apple 'apple' fruit),)