The Final State Analysis (FSA) package is a CMSSW analysis framework.
The package contains a complete implementatation to build a POG-approved PAT tuple, and utilities for generating plain ROOT ntuples from the PAT tuple.

Documentation: https://github.com/uwcms/FinalStateAnalysis/wiki

Automated tests:

53X PAT + Ntuple
52X PAT + Ntuple
42X PAT + Ntuple
53X Ntuple Only

Current CMSSW versions: 4_2_8_patch7 or 5_3_7.
The installation instructions are the same for both.

Get a supported CMSSW release area::

  scram pro -n MyWorkingAreaName CMSSW CMSSW_VERSION

Checkout the FinalStateAnalysis repository::

  cd MyWorkingAreaName/src
  git clone --recursive https://github.com/uwcms/FinalStateAnalysis.git

This will checkout the lastest and greatest version of the code. You might also want the HCP2012 compatible branch, if so you should additionally run:

cd FinalStateAnalysis
git checkout hcp2012

and then proceed as normal.

Checkout the needed CMSSW tags:

  cd FinalStateAnalysis/recipe/
  # You need to have CVS access
  kinit me@CERN.CH
  # Make sure your CMSSW environment is set up
  cmsenv
  # Checkout needed packages and apply patches
  # This enables all options.  You can turn off things you don't need.
  # NB that in the hcp2012 changes the options won't do anything.
  PATPROD=1 LUMI=1 LIMITS=1 ./recipe.sh
  # Compile
  cd ../../
  scram b -j 8

You must always set up the environment::

  source FinalStateAnalysis/environment.sh

For python plotting enhancements, install the custom python virtualenv and extra packages (note this is not necessary for PAT tuple production)::

  ./install_python.sh
  yolk -l # List installed packages