Metadata-Version: 2.1
Name: fast-carpenter
Version: 0.20.0
Summary: F.A.S.T. package for summarizing ROOT TTrees
Home-page: https://github.com/FAST-HEP/fast-carpenter
Author: Ben Krikler
Author-email: fast-hep@cern.ch
License: Apache Software License 2.0
Keywords: ROOT,pandas,analysis,particle physics,HEP,F.A.S.T
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
License-File: LICENSE



.. image:: https://img.shields.io/pypi/v/fast-carpenter.svg
   :target: https://pypi.org/project/fast-carpenter/
   :alt: pypi package


.. image:: https://travis-ci.com/FAST-HEP/fast-carpenter.svg?branch=master
   :target: https://travis-ci.com/FAST-HEP/fast-carpenter
   :alt: pipeline status


.. image:: https://codecov.io/gh/FAST-HEP/fast-carpenter/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/FAST-HEP/fast-carpenter
   :alt: coverage report


.. image:: https://readthedocs.org/projects/fast-carpenter/badge/?version=latest
   :target: https://fast-carpenter.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation Status


.. image:: https://badges.gitter.im/FAST-HEP/community.svg
   :target: https://gitter.im/FAST-HEP/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge
   :alt: Gitter

.. image:: https://zenodo.org/badge/187055992.svg
   :target: https://zenodo.org/badge/latestdoi/187055992

.. image:: https://raw.githubusercontent.com/FAST-HEP/logos-etc/master/fast-carpenter-black.png
   :target: https://github.com/fast-hep/fast-carpenter
   :alt: 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
* Espresso: to keep the developer(s) writing code


A tool from the Faster Analysis Software Taskforce: http://fast-hep.web.cern.ch/

Installation and usage
----------------------

Visit the `documentation <https://fast-carpenter.readthedocs.io/>`_ for full details.


