pint-cf 0.1.1

CF-compliant unit registry and formatter for Pint

pint-cf

This package extends Pint with a CF-compliant unit registry and formatter.

Features

This package provides:

• A CF-compliant Pint UnitRegistry, with explicit plurals.
• A custom formatter cf, supporting both long and short (symbol) formats.

Known limitations:

• Pint does not support time coordinates (e.g. days since 2001-01-01) or climate calendars (e.g., 360_days). Consider using cftime for that.
• Pint does not support scaling factors in Unit expressions (e.g. pint.Unit('0.1 m')). You can work around this by adding your own unit definition.

Usage

Create a CF-ready unit registry with cf_unitregistry(). This function also registers the cf formatter.

from pint_cf import cf_unitregistry

ureg = cf_unitregistry()
print(type(ureg))  # <class 'pint.registry.UnitRegistry'>

q = ureg('10 meters per second^2').to('km s-2')

print(f"{q:cf}")   # 0.01 kilometer-second^-2
print(f"{q:~cf}")  # 0.01 km/s2