ROOT I/O in pure Python and Numpy.
Project description
uproot (originally μproot, for “micro-Python ROOT”) is a reader and (someday) a writer of the ROOT file format using only Python and Numpy. Unlike the standard C++ ROOT implementation, uproot is only an I/O library, primarily intended to stream data into machine learning libraries in Python. Unlike PyROOT and root_numpy, uproot does not depend on C++ ROOT. Instead, it uses Numpy calls to rapidly cast data blocks in the ROOT file as Numpy arrays.
It is important to note that uproot is not maintained by the ROOT project team, so post bug reports as uproot GitHub issues, not on any ROOT forum.
Installation
Install uproot like any other Python package:
pip install uproot
or similar (use sudo, --user, virtualenv, or pip-in-conda if you wish).
Strict dependencies:
Python (2.7+, 3.4+)
The following are installed automatically when you install uproot with pip:
Numpy (1.13.1+)
awkward-array to manipulate data from non-flat TTrees, such as jagged arrays (part of Scikit-HEP)
uproot-methods (0.2.0+) for histogram and physics object methods, such as TLorentzVector (part of Scikit-HEP)
cachetools for dict-like caches (replaces uproot 2’s custom caches)
lz4 to read lz4-compressed ROOT files (now ROOT’s default compression method)
Optional dependencies:
lzma to read lzma-compressed ROOT files in Python 2 (not needed for Python 3 or if your ROOT files aren’t lzma-compressed)
futures for parallel processing in Python 2 (not needed for Python 3 or if you don’t plan to use parallel processing)
XRootD to access remote files; get version 4 or later for pyxrootd to be included in the package (unfortunately, you have to compile it manually with CMake)
Reminder: you do not need C++ ROOT to run uproot.
Tutorial
See the project homepage for a tutorial.
Interactive tutorial
Run this tutorial on Binder.
Reference documentation
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file uproot-3.2.6.tar.gz
.
File metadata
- Download URL: uproot-3.2.6.tar.gz
- Upload date:
- Size: 54.5 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.0 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | af0a093f0788b8983d07b88fac3094b26c3e28358bc10cdb8d757cc07956f8d4 |
|
MD5 | 6ed94fabf7d5914798e5a563a4e174f4 |
|
BLAKE2b-256 | 07852b012fe38ea4c31f5203761627d421e77af3976d7f89f9660238e341dc46 |
File details
Details for the file uproot-3.2.6-py2.py3-none-any.whl
.
File metadata
- Download URL: uproot-3.2.6-py2.py3-none-any.whl
- Upload date:
- Size: 133.6 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.20.0 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.6.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | c9965bb8807318c2380935963b69c651a6c30f076801e13bd22ae6b487190dd3 |
|
MD5 | 5dcbca2332515fe052fcfb2ed16d27ce |
|
BLAKE2b-256 | fa084b32c85f32ff28b4955d3854365d4104fa49d2c3e2b7cfc5339baebe5745 |