gputtley / taufw

Analysis framework for tau analysis at CMS using NanoAOD

TauFW

Framework for tau analysis using NanoAOD at CMS. Three main packages are

1. PicoProducer: Tools to process nanoAOD and make custom analysis ntuples.
2. Plotter: Tools for further analysis, auxiliary measurements, validation and plotting. [Under development.]
3. Fitter: Tools for measurements and fits in combine. [Under development.]

Installation

First, setup a CMSSW release, for example,

export CMSSW=CMSSW_10_6_13
export SCRAM_ARCH=slc7_amd64_gcc700
cmsrel $CMSSW
cd $CMSSW/src
cmsenv

Which CMSSW version should matter for post-processing of nanoAOD, but if you like to use Combine in the same repository, it is better to use at least the recommended version. Then, install TauFW:

cd $CMSSW_BASE/src/
git clone https://github.com/cms-tau-pog/TauFW TauFW
scram b -j4

With each new session, do

export SCRAM_ARCH=slc7_amd64_gcc700
cd $CMSSW/src
cmsenv

PicoProducer

If you want to process nanoAOD using PicoProducer, install NanoAODTools:

cd $CMSSW_BASE/src/
git clone https://github.com/cms-nanoAOD/nanoAOD-tools.git PhysicsTools/NanoAODTools
scram b -j4

If you want to use tau ID SF, please install TauIDSFs tool:

cd $CMSSW_BASE/src
git clone https://github.com/cms-tau-pog/TauIDSFs TauPOG/TauIDSFs
cmsenv
scram b -j4

Fitter and Combine tools

If you want to use the Combine tools in Fitter, install Combine,

cd $CMSSW_BASE/src
git clone https://github.com/cms-analysis/HiggsAnalysis-CombinedLimit.git HiggsAnalysis/CombinedLimit
cd HiggsAnalysis/CombinedLimit
git fetch origin
git checkout v8.1.0

and then CombineHarvester,

cd $CMSSW_BASE/src
git clone https://github.com/cms-analysis/CombineHarvester.git CombineHarvester
scramv1 b clean; scramv1 b

TauID Scale Factor (SF) JSON and ROOT files creation

To create ROOT files including the measured SFs please install TauIDSFs tool as illustrated above. Modify the TauIDSFs/utils/createSFFiles.py script to include your measured SFs into the script. Finally, run the TauFW/scripts/tau_createROOT.sh to generate your ROOT files. They will be created into TauFW/scripts/data/ IMPORTANT: please comment and do not delete older SFs

To create JSON files with SFs values, please install correctionlib into the same $CMSSW_BASE/src as TauFW. To install correctionlib:

#Change directory to the same $CMSSW_BASE/src as TauFW
cd $CMSSW_BASE/src
source /cvmfs/sft.cern.ch/lcg/views/LCG_99/x86_64-centos7-gcc8-opt/setup.sh
git clone --recursive https://github.com/cms-tau-pog/correctionlib.git
cd correctionlib
python3 -m pip install --user .

Your SFs should be included in correctionlib/scripts/tau_createJSONs.py. Finally, run the TauFW/scripts/tau_createJSONs.sh script. JSON files will be produced in the TauFW/scripts/data/tau/new folder.