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

Installation

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.

Filename, size & hash SHA256 hash help File type Python version Upload date
fnal_column_analysis_tools-0.2.3-py2.py3-none-any.whl (64.3 kB) Copy SHA256 hash SHA256 Wheel py2.py3
fnal_column_analysis_tools-0.2.3-py3.7.egg (148.2 kB) Copy SHA256 hash SHA256 Egg 3.7
fnal-column-analysis-tools-0.2.3.tar.gz (42.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page