Pintext

Extend Pint with unit contexts

Motivation

Scientific applications routinely accept plain numbers, e.g. from configuration files, user input or serialized data. They then have to decide what units those numbers carry. Hard-coding the answer at each site is brittle; passing units around explicitly is noisy.

Pintext's answer is the unit context: a registry of named, overridable unit generators built on Pint. Units are resolved when a value is interpreted, not when the code declaring it was written, so a single with block can change how an entire object tree reads its inputs.

Features

• Define unit contexts to vary unitless value interpretation dynamically
• Attach units to unitless values and check unit compatibility with a check stricter than Pint's dimensionality (e.g. angles, radiance vs irradiance)
• Interpret quantities stored as dictionaries or xarray DataArrays
• Attach units to attrs fields
• Attach units to pydantic fields

The core depends on Pint alone; the class-framework integrations are optional.

Installation

pip install pintext
pip install "pintext[attrs]"  # attrs integration
pip install "pintext[pydantic]"  # pydantic integration

Check the documentation for more detail.

Contributing

Please refer to the contributor's guide for the AI usage policy, development setup instructions and development practices.

License

Pintext is distributed under the terms of the MIT license.

About

Pintext is written and maintained by Vincent Leroy.

Development is supported by Rayference.

Pintext is a component of the Eradiate radiative transfer model.

Pintext was previously released as Pinttrs, which it supersedes. Pintext contains breaking changes, see the porting guide for details.