Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

NumPy arrays with named axes and named indices.

Project description

Scientists, engineers, mathematicians and statisticians don’t just work with matrices; they often work with structured data, just like you’d find in a table. However, functionality for this is missing from Numpy, and there are efforts to create something to fill the void. This is one of those efforts.


This code is currently experimental, and its API will change! It is meant to be a place for the community to understand and develop the right semantics and have a prototype implementation that will ultimately (hopefully) be folded back into Numpy.

Datarray provides a subclass of Numpy ndarrays that support:

  • individual dimensions (axes) being labeled with meaningful descriptions
  • labeled ‘ticks’ along each axis
  • indexing and slicing by named axis
  • indexing on any axis with the tick labels instead of only integers
  • reduction operations (like .sum, .mean, etc) support named axis arguments instead of only integer indices.

Prior Art

In no particular order:

  • xray - very close in spirit to this package, xray implements named ND array axes and tick labels. It integrates with (and depends on) Pandas;
  • pandas is based around a number of DataFrame-esque datatypes.
  • Tabular implements a spreadsheet-inspired datatype, with rows/columns, csv/etc. IO, and fancy tabular operations.
  • scikits.statsmodels sounded as though it had some features we’d like to eventually see implemented on top of something such as datarray, and Skipper seemed pretty interested in something like this himself.
  • scikits.timeseries also has a time-series-specific object that’s somewhat reminiscent of labeled arrays.
  • pandas is based around a number of DataFrame-esque datatypes.
  • pydataframe is supposed to be a clone of R’s data.frame.
  • larry, or “labeled array,” often comes up in discussions alongside pandas.
  • divisi includes labeled sparse and dense arrays.
  • pymvpa provides Dataset class encapsulating the data together with matching in length sets of attributes for the first two (samples and features) dimensions. Dataset is not a subclass of numpy array to allow other data structures (e.g. sparse matrices).
  • ptsa subclasses ndarray to provide attributes per dimensions aiming to ease slicing/indexing given the values of the axis attributes

Project Goals

  1. Get something akin to this in the numpy core;
  2. Stick to basic functionality such that projects like scikits.statsmodels can use it as a base datatype;
  3. Make an interface that allows for simple, pretty manipulation that doesn’t introduce confusion;
  4. Oh, and make sure that the base numpy array is still accessible.


You can find our sources and single-click downloads:

The latest released version is always available from pypi.


Please put up issues on the datarray issue tracker.

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
datarray-0.1.0-py2-none-any.whl (36.8 kB) Copy SHA256 hash SHA256 Wheel py2 Jun 10, 2016
datarray-0.1.0-py3-none-any.whl (36.8 kB) Copy SHA256 hash SHA256 Wheel py3 Jun 10, 2016
datarray-0.1.0.tar.gz (61.6 kB) Copy SHA256 hash SHA256 Source None Jun 10, 2016 (75.8 kB) Copy SHA256 hash SHA256 Source None Jun 10, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page