Installation¶
Requirements¶
root_numpy requires that both ROOT and NumPy are installed
and that ROOT is setup with the $ROOTSYS environment variable set before
installation. root_numpy’s installation script depends on ROOT’s
root-config utility to determine the ROOT compiler/linker flags
and include paths. The installation attempts to run root-config and if
unsuccessful then $ROOTSYS/bin/root-config. If root-config still cannot
be found, the installation aborts.
root_numpy has been tested with:
- ROOT 5.32, 5.34, 6.04, 6.06, 6.09
- NumPy 1.6, 1.7, 1.8, 1.9, 1.10, 1.11
- Python 2.6, 2.7, 3.4, 3.5
- GNU/Linux, Mac OS
Warning
Mac OS: libstdc++ and libc++ are not ABI-compatible.
If you’re compiling root_numpy with Clang and linking against libc++, ROOT should also have been compiled with Clang and libc++. ROOT compiles with Clang and libc++ since version 5.34/11, but PyROOT had a bug that was fixed after that tag, so it is best to compile a newer version. You can do this easily with Homebrew via:
brew install --HEAD root
This issue also comes up if you’re using a Python bundle such as Anaconda or Enthought Canopy. These bundles build against libstdc++, the GCC C++ standard library, which is used on Mac OS 10.5 and later. On Mac OS 10.7 and later, however, the default compiler links against libc++, the Clang C++ standard library.
Getting the Latest Source¶
Clone the repository with git:
git clone git://github.com/rootpy/root_numpy.git
or checkout with svn:
svn checkout https://github.com/rootpy/root_numpy/trunk 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 ROOTSYS=$ROOTSYS 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 ROOTSYS=$ROOTSYS pip install root_numpy
Note
The above will install the latest version of root_numpy on PyPI and may be lacking new unreleased features. You can also use pip to install the latest version of root_numpy on github:
pip install --upgrade --user https://github.com/rootpy/root_numpy/zipball/master