Skip to main content

Tools for doing Collider HEP style analysis with columnar operations at Fermilab

Project description

This package is currently organized into three subpackages:

  1. lookup_tools - This package manages importing corrections and scale factors, and provides a unified interface for evaluating those corrections on physics objects.
    • lookup_tools.extractor: handles importing the lookups from root files
    • lookup_tools.evaluator: handles organizing, providing an interface for, and evaluating the lookups
  2. analysis_objects - This package contains definitions of physics objects casted in the language of JaggedArrays
    • JaggedCandidateArray - This object represents a list of candidates (things with four momenta and other attribute). Upon creation one can add extra columns of data that were not imported at construction, and all columns are accessible as though they were attributes of the class. This gives analysts a simple-to-read but rich, descriptive, and highly configurable object to represent muons, electrons, etc.
    • JaggedTLorentzVectorArray - This is a jagged representation of a TLorentzVectorArray.
  3. striped - This package defines transformations from the raw striped database into JaggedArrays and JaggedCandidateArrays
    • ColumnGroup - This object takes the name of a column that has attributes in striped and creates a dictionary of all given attributes.
    • PhysicalColumnGroup - Just like ColumnGroup except it requires a “p4” attribute to be defined, and is specialized to aide in creating JaggedCandidateArrays
    • jaggedFromColumnGroup - This is a function that takes a column group and returns a JaggedArray if it is a normal column group, or a JaggedCandidateArray if given a PhysicalColumnGroup


Install fnal-column-analysis-tools like any other Python package:

pip install fnal-column-analysis-tools

or similar (use sudo, --user, virtualenv, or pip-in-conda if you wish).

Strict dependencies:

The following are installed automatically when you install uproot with pip:

  • numpy (1.15+)
  • awkward-array to manipulate data from non-flat TTrees, such as jagged arrays (part of Scikit-HEP)
  • uproot-methods to allow expressions of things as lorentz vectors
  • numba just-in-time compilation of python functions
  • scipy for statistical functions
  • matplitlib as a plotting backend
  • uproot for interacting with ROOT files

Download files

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

Files for fnal-column-analysis-tools, version 0.4.23
Filename, size File type Python version Upload date Hashes
Filename, size fnal_column_analysis_tools-0.4.23-py2.py3-none-any.whl (85.0 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size fnal-column-analysis-tools-0.4.23.tar.gz (2.3 MB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page