F.A.S.T. package for summarizing ROOT TTrees
Project description
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:
- Build a description of the datasets you wish to process using the
fast_curator
command from the fast-curator package. - Write a description of what you want to do with your data (see documentation below).
- 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
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
Hashes for fast_carpenter-0.5.6-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c958270e41429fb3044181a1077a9325f028de11935f9be67cfd43681c8854bd |
|
MD5 | 70e72e8c96ec62d895aca63c0d94be21 |
|
BLAKE2b-256 | 08349c74d086b5c61e0f07990ee4ae73a34616a4da93c6e282fb9a54b0db01af |