Metadata-Version: 2.2
Name: fast-carpenter
Version: 0.22.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
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
Requires-Dist: atuproot==0.1.13
Requires-Dist: atsge==0.2.1
Requires-Dist: atpbar==1.0.8
Requires-Dist: mantichora==0.9.7
Requires-Dist: alphatwirl==0.25.5
Requires-Dist: fast-flow>0.5.0
Requires-Dist: fast-curator
Requires-Dist: awkward
Requires-Dist: coffea==0.7.9
Requires-Dist: pandas>=1.1
Requires-Dist: numpy==1.21.0; python_version < "3.9"
Requires-Dist: numpy>=1.18.5; python_version > "3.8"
Requires-Dist: numexpr
Requires-Dist: typing-extensions>=4.1.1
Requires-Dist: uproot>=4.1.8
Requires-Dist: uproot3>=3.14.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: requires-dist
Dynamic: summary



.. 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.
