Skip to main content

F.A.S.T. package for summarizing ROOT TTrees

Project description

pypi package pipeline status coverage report

fast-carpenter

Turns your trees into tables (ie. reads ROOT TTrees, writes summary Pandas DataFrames)

fast-carpenter can:

  • Be controlled using YAML-based config files
  • Define new variables
  • Cut out events or define phase-space "regions"
  • Produce histograms stored as CSV files using multiple weighting schemes
  • Make use of user-defined stages to manipulate the data

Powered by:

  • AlphaTwirl (presently): to run the dataset splitting
  • Atuproot: to adapt AlphaTwirl to use uproot
  • uproot: to load ROOT Trees into memory as numpy arrays
  • fast-flow: to manage the processing config files
  • fast-curator: to orchestrate the lists of datasets to be processed
  • coffee: to help the developer(s) write code

Installation

Can be installed from pypi:

pip install --user fast-carpenter

or if you want to be able to edit code in this repo:

pip install --user -e git+https://gitlab.cern.ch/fast-hep/public/fast-carpenter.git#egg=fast_carpenter --src .

Note that to use this repository and the main fast_carpenter command, you normally shouldn't need to be able to edit this codebase; in most instances the full analysis should be describable with just a config file, and in some cases custom, analysis-specific stages to create more tricky variables for example.

Also note that if you install this with pip, the main executable, fast_carpenter, will only be available everywhere if include the directory ~/.local/bin in your PATH variable.

Documentation

Basic usage:

  1. Build a description of the datasets you wish to process using the fast_curator command from the fast-curator package.
  2. Write a description of what you want to do with your data (see documentation below).
  3. Run things:
fast_carpenter datasets.yaml processing.yaml

You can use the built-in help as well for more info:

fast_carpenter --help

The processing config file

... is on its way...

Example analysis

...is also on its way...

Project details


Download files

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

Source Distribution

fast-carpenter-0.4.1.tar.gz (12.9 kB view hashes)

Uploaded Source

Built Distribution

fast_carpenter-0.4.1-py2.py3-none-any.whl (16.6 kB view hashes)

Uploaded Python 2 Python 3

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