Skip to main content
https://travis-ci.org/rootpy/root_numpy.png https://pypip.in/v/root_numpy/badge.png https://pypip.in/d/root_numpy/badge.png

root_numpy is a Python extension for converting ROOT TTrees into NumPy recarrays or structured arrays as well as converting NumPy arrays back into ROOT TTrees. With the core internals written in C++, root_numpy can efficiently handle large amounts of data (limited only by the available memory). Now that your ROOT data is in NumPy form, you can make use of the many powerful scientific Python packages or perform quick exploratory data analysis in interactive environments like IPython (especially IPython’s popular notebook feature).

root_numpy currently supports basic types such as bool, int, float, double, etc. and arrays of basic types (both variable and fixed-length). Vectors of basic types are also supported.

See the root2hdf5 script in the rootpy package that uses root_numpy and PyTables to convert all TTrees in a ROOT file into the HDF5 format.

Requirements

root_numpy is tested with ROOT 5.32, NumPy 1.6.1, Python 2.7.1 but it should work in most places.

Typical Usage

>>> import ROOT
>>> from root_numpy import root2array, root2rec, tree2rec
>>> # convert into a numpy structured array
>>> # treename is always optional if there is only one tree in the file
>>> arr = root2array('a.root', 'treename')
>>> # convert into a numpy record array
>>> rec = root2rec('a.root', 'treename')
>>> # or directly convert a tree
>>> rfile = ROOT.TFile('a.root')
>>> tree = rfile.Get('treename')
>>> rec = tree2rec(tree)

Getting the Latest Source

Clone the repository with git:

git clone git://github.com/rootpy/root_numpy.git

or checkout with svn:

svn checkout http://svn.github.com/rootpy/root_numpy

Manual Installation

If you have obtained a copy of rootpy_numpy yourself use the setup.py script to install.

To install in your home directory:

python setup.py install --user

To install system-wide (requires root privileges):

sudo python setup.py install

Automatic Installation

To install a released version of root_numpy use pip.

To install in your home directory:

pip install --user root_numpy

To install system-wide (requires root privileges):

sudo pip install root_numpy

Try root_numpy on CERN’s LXPLUS

First, set up ROOT:

source /afs/cern.ch/sw/lcg/contrib/gcc/4.3/x86_64-slc5/setup.sh &&\
cd /afs/cern.ch/sw/lcg/app/releases/ROOT/5.34.00/x86_64-slc5-gcc43-opt/root &&\
source bin/thisroot.sh &&\
cd -

Then, create and activate a virtualenv (change my_env at your will):

virtualenv my_env # necessary only the first time
source my_env/bin/activate

Install NumPy:

pip install numpy

Get the latest source:

git clone https://github.com/rootpy/root_numpy.git

and install it:

~/my_env/bin/python root_numpy/setup.py install

Note that neither sudo nor –user is used, because we are in a virtualenv.

root_numpy should now be ready to use:

>>> from root_numpy import testdata, root2rec
>>> root2rec(testdata.get_filepath())[:20]
rec.array([(1, 1.0, 1.0), (2, 3.0, 4.0), (3, 5.0, 7.0), (4, 7.0, 10.0),
      (5, 9.0, 13.0), (6, 11.0, 16.0), (7, 13.0, 19.0), (8, 15.0, 22.0),
      (9, 17.0, 25.0), (10, 19.0, 28.0), (11, 21.0, 31.0),
      (12, 23.0, 34.0), (13, 25.0, 37.0), (14, 27.0, 40.0),
      (15, 29.0, 43.0), (16, 31.0, 46.0), (17, 33.0, 49.0),
      (18, 35.0, 52.0), (19, 37.0, 55.0), (20, 39.0, 58.0)],
      dtype=[('n_int', '<i4'), ('f_float', '<f4'), ('d_double', '<f8')])

Running the Tests

Testing requires the nose package. Once root_numpy is installed, it may be tested (from outside the source directory) by running:

nosetests --exe -s -v root_numpy

root_numpy can also be tested before installing by running this from inside the source directory:

make test

Development

Please post on the rootpy-dev@googlegroups.com list if you have ideas or contributions. Feel free to fork root_numpy on GitHub and later submit a pull request.

Have Questions or Found a Bug?

Think you found a bug? Open a new issue here: github.com/rootpy/root_numpy/issues.

Also feel free to post questions or follow discussion on the rootpy-users or rootpy-dev Google groups.

Metadata

Release files for root-numpy 3.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for root-numpy 3.0.0
File Size Uploaded Provenance Actions
root_numpy-3.0.0.tar.gz 270.0 kB Without provenance Details for root_numpy-3.0.0.tar.gz

Release files / root_numpy-3.0.0.tar.gz

Download URL root_numpy-3.0.0.tar.gz
Size 270.0 kB
Tags Source
SHA-256 checksum
How to use checksums
7af2f8dd22b56c509cd522fc615ab77f2c74fc50fafe830420e0681496facb10
BLAKE2b-256 checksum
How to use checksums
39ee0dbd6806a65cc5f484accc0e81c5f0ee18361bfc0fa19e1aeeb8ab1845d8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for root-numpy 3.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.0.0 This release

1 release file No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page