Skip to main content

ROOT I/O in pure Python and Numpy.

Project description

uproot

uproot (originally μproot, for “micro-Python ROOT”) is a reader and 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:

The following are installed automatically when you install uproot with pip:

Optional dependencies:

  • lz4 to read lz4-compressed ROOT files (now ROOT’s default compression method)

  • 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

Release history Release notifications | RSS feed

This version

3.3.2

Download files

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

Source Distribution

uproot-3.3.2.tar.gz (55.7 MB view details)

Uploaded Source

Built Distribution

uproot-3.3.2-py2.py3-none-any.whl (136.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file uproot-3.3.2.tar.gz.

File metadata

  • Download URL: uproot-3.3.2.tar.gz
  • Upload date:
  • Size: 55.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.29.0 CPython/3.6.3

File hashes

Hashes for uproot-3.3.2.tar.gz
Algorithm Hash digest
SHA256 2a3050efb8cfceb25e712e0ef6d38ab443458b52914956a2c0b1c88b0715c5fd
MD5 d8e14855c8bfa083151e36318d4e944b
BLAKE2b-256 c5957aa54f13ee337a3567c1a7e724368cbe99ff58f9c79384e700057aa4e500

See more details on using hashes here.

File details

Details for the file uproot-3.3.2-py2.py3-none-any.whl.

File metadata

  • Download URL: uproot-3.3.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 136.3 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/40.6.3 requests-toolbelt/0.8.0 tqdm/4.29.0 CPython/3.6.3

File hashes

Hashes for uproot-3.3.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 3f3d106942f8a60748d085c7e8fd813cac1e72e894e59287a39e1dd9c650c522
MD5 5791f998ae1fcb875c2b663e128c7b51
BLAKE2b-256 13336220f44da4930d9f4a90dad69cde63e038a81208cf56c6406cef2778993e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page