Skip to main content

A package for handling numpy arrays with units

Project description

unyt Documentation Status Test Coverage

A package for handling numpy arrays with units


Often writing code that deals with data that has units can be confusing. A function might return an array but at least with plain NumPy arrays, there is no way to easily tell what the units of the data are without somehow knowing a prioi.

The unyt package provides a subclass of NumPy’s ndarray class that knows about units. For example, one could do:

>>> import unyt
>>> cars = ['toyota', 'volkswagen', 'honda']
>>> distance_traveled = [3.4, 5.8, 7.2] * unyt.mile
>>> print('km'))
[ 5.4717696  9.3341952 11.5872768] km

And a whole lot more! See the documentation for more examples as well as full API docs.

Code of Conduct

The unyt package is part of The yt Project <>. Participating in unyt development therefore happens under the auspices of the yt community code of conduct <>. If for any reason you feel that the code of conduct has been violated, please send an e-mail to with details describing the incident. All emails sent to this address will be treated with the strictest confidence.


The unyt package is licensed under the BSD 3-clause license. If you make use of unyt in a publication we would appreciate a mention in the text of the paper or in the acknowledgements.


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


unyt began life as a submodule of yt named yt.units.

It was separated from yt.units as its own package in 2018.

0.1.0 (2018-03-28)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

unyt-1.0.0.tar.gz (145.0 kB view hashes)

Uploaded Source

Built Distribution

unyt-1.0.0-py2.py3-none-any.whl (50.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page