Skip to main content
https://img.shields.io/travis/pelssers/broot.svg https://img.shields.io/pypi/v/broot.svg

Library for converting python numpy datastructures to the ROOT output format.

The ROOT(https://root.cern.ch/) data analysis framework is used much in High Energy Physics (HEP) and has its own output format (.root). ROOT can be easily interfaced with software written in C++. For software tools in Python there exists pyROOT(https://root.cern.ch/drupal/content/pyroot). Unfortunately pyROOT does not work well with python3.4.

broot is a small library that converts data in python numpy ndarrays to ROOT files containing trees with a branch for each array.

The goal of this library is to provide a generic way of writing python numpy datastructures to ROOT files. The library should be portable and supports both python2, python3, ROOT v5 and ROOT v6 (requiring no modifications on the ROOT part, just the default installation). Installation of the library should only require a user to compile to library once or install it as a python package.

Secondly the library can be used to convert other file formats that store information in numpy-like structures, such as HDF5, to ROOT.

Installation

To use broot a user must have installed python, ROOT and be able to compile C++ code. To install:

pip install broot

To use the examples clone the repository and run:

python setup.py develop

Use

To use broot one needs libRootOutput.so and RootWrap.py

RootWrap can be imported in any python file and a new RootOutput instance can be made:

from broot import RootWrap

OUT = RootWrap.RootOutput()

Two example scripts are provided in ‘examples’.

  • ‘convert.py’ demonstrates the functions available using some ndarrays.

  • ‘hdf_to_root.py’ is a first implementation of a HDF5 to ROOT converter (HDF5 file not provided).

Current support:

  • python2

  • python3.4

  • ROOT v5

  • ROOT v6

  • compiles on gcc versions with c++11

  • compiles on gcc versions without c++11 (see branch no-c++11)

  • tested on GNU/Linux

Todo list:

  • Proper Makefile instead of ‘compile.sh’

  • Python package

  • HDF5 converter class

  • OS support for Windows and Mac

  • Documentation

History

0.1.0 (2015-05-25)

  • First release on PyPI.

Metadata

Release files for broot 0.1.1

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

Built distribution (wheel)

Table of built distributions (wheels) for broot 0.1.1
File Interpreter ABI Platform
broot-0.1.1-py3.4.egg Legacy Egg format - - Details

Release files / broot-0.1.1-py3.4.egg

Download URL broot-0.1.1-py3.4.egg
Size 40.2 kB
Tags Egg
SHA-256 checksum
How to use checksums
4e870012e9eac451080912445b88317041062ed6ecf1e0e107736a07f26de72f
BLAKE2b-256 checksum
How to use checksums
d8eed505ee946ca5f674e7a7cc5451c99bfc5fa17c29f5e029c7f9edc15a8618
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.1 This release

1 release file

0.1.0

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