Installation

unithandler is registered on PyPI.

pip install unithandler

Source files may be found in the GitLab repository.

The Unit class

This class handles all unit-associated attributes and methods. The unit attribute returns an appropriately formatted unit (complete with superscripts) as a string. Units are managed in dictionary format, associating a power to each unit denoted. The class (and its subclasses) are structured) so that the units may be easily modified using python built-in multiplication and division operators (exactly as one would track units with pen and paper).

The UnitFloat class

The UnitFloat class is a float-like numeric class that has an associated unit. The class has all defined Python magic methods, which enable all appropriate modifications and operations on or by UnitFloat objects. Typically, the return of each magic method is another UnitFloat instance, but see the UnitFloat documentation for further details.

Known limitations

Since this package is written entirely in Python, it does not provide direct access to values as the true float and int would. As such, some errors or unintended functionality may be encountered.

Currently numpy support is limited to basic ufunc implementation. Unexpected behaviour may be encountered when performing numpy operations on UnitFloat or UnitInt. We are working to implement full support for vectorized operations on the numeric classes in this package. To the best of our knowledge, the math package is fully supported, so any numeric operations should be performed with that package while we work to enable numpy support.