The Final State Analysis (FSA) package is a CMSSW analysis framework. Common utilities are organized as subpackages. Each analysis (Higgs to tau, SSDL, etc) should exists as a separate subpackage.

The full documentation is available at http://readthedocs.org/docs/final-state-analysis/en/latest/.

Definitions of custom, EDM persist-able data formats used by the framework.

The DataAlgos package defines the algorithm implementations used by the member functions of the DataFormats package. This improves code reuse, eases backward compatibility, and improves compilation speed.

This package holds "data about data." It knows what samples exist, how to find them in DBS, and what their cross sections are. It also holds the central definition of plot styles used for different data samples. Also, reference type code (such as getting Higgs boson properties from lookup tables, etc, are hosted here).

The RecoTools package contains plugin modules and utilities for dealing with RECO and AOD content. This package is not FWKLITE compatible.

The PAT tools package contains everything needed to build the FSA pat tuple. It is standalone.

The Selectors package defines the "analyzeFinalStates" FWKLITE binary, which is the final analysis builder. It additionally contains additional helper classes to analyze PATFinalStates, as well as the python definitions of common cuts to be applied. New selections and plots should be defined in Selectors/python/selectors and Selectors/python/plotting, respectively.

Contains various command--line tools and C++ functionality.

The recipe section contains scripts which automate installation of related packages. The docs folder just contains all the documentation.

Each analysis, which uses the above packages, is configued in a separate sub--package. In general, an analysis can/should have some variation of following content:

python/selection.py

Defines the selections and plots (from the Selectors package) used in the analysis.

test/analyze_cfg.py

Defines the final ntuple production cfg. This is the steering file for the analyzeFinalStatesBinary.

test/submit_analysis.py

Submits the analyze_cfg.py jobs to condor/GRID/etc.

test/plotting/*

Tools to analyze the final level ntuple and produces plots.

Tools for generating Tag and Probe like analysis for muons and taus.

Associated Higgs to tau analysis.