root-numpy 3.0.0

Requirements

• ROOT

• NumPy

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.