CATTools

Intro

• Cat tools is a common edm based tuple maker for KCMS.
• Design such that switching from PAT to CAT takes minimal effort
• Code can be found in https://github.com/vallot/CATTools.
• Setup and run instructions are below.
• Since catTools reads miniAODs for input, the selections on the physics objects are set by the cuts in the MiniAOD slimmer
• To request new features please add to issues
• For help cat-tools@cern.ch

Analysis Examples

• Steps and examples for cattuple usage is shown in here.

Datasets

• Location and details of cattuple datasets made with CATTools is here.

Physics Object Details

Naming conventions for the variables are the same as PAT if they exists in the PAT Object.

Muons

• isGlobalMuon()
• isPFMuon()
• isTightMuon()
• isLooseMuon()
• isSoftMuon()
• normalizedChi2()
• numberOfValidHits()
• numberOfValidMuonHits()
• numberOfMatchedStations()
• numberOfValidPixelHits()
• trackerLayersWithMeasurement()
• dxy()
• dz()
• relIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• chargedHadronIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• puChargedHadronIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• neutralHadronIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• photonIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• genParticle()
• shiftedEnUp() and shiftedEnDown()

Electrons

• electronID(const std::string& name) to get the electron PID, currently all PID from miniAODs are saved.
• scEta()
• passConversionVeto()
• isGsfCtfScPixChargeConsistent()
• isPF()
• dxy()
• dz()
• relIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• chargedHadronIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• puChargedHadronIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• neutralHadronIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• photonIso(float dR=0.3 ) function returns either dR=0.3 or 0.4, default is 0.3.
• genParticle()
• shiftedEnUp() and shiftedEnDown()

Jets

• LooseId?()
• pileupJetId() is pileupJetId:fullDiscriminant
• bDiscriminator(const std::string &theLabel) to get the btagging variable, currently all btagging from miniAODs are saved.
• vtxMass() is the mass of the vertex
• vtxNtracks() is the number of tracks in it
• vtx3DVal() is the decay length value
• vtx3DSig() is the decay length significance
• genParticle()
• genJet()
• partonFlavour()
• hadronFlavour()
• partonPdgId()
• smearedRes(), smearedResDown(), smearedResUp()
• shiftedEnUp() and shiftedEnDown()

Secondary Vertexs

• lxy() is the 2D distance from the primary vertex to the secondary vertex
• l3D() is the 3D distance from the primary vertex to the secondary vertex
• vProb() is the probabiltiy of the vertex (TMath::Prob( vertex chi2, vertex no. degrees of freedom))
• pdgId() returns 11 or 13 depending on weather the vertex was made with electrons or muons respectively
• ipos() and ineg() returns the index of the muon or electron used in the vertex, i.e. ipos 3 is the 3rd lepton from either muon or electron collection

How To

readme

Setting up CMSSW and checking out CATTools %CODE{"bash"}% scram p -n cat CMSSW CMSSW_7_2_2_patch1 cd cat/src cmsenv git clone git@github.com:vallot/CATTools.git cd CATTools git checkout cat72x cd .. scram b -j 8 %ENDCODE%

To run on MiniAODs %CODE{"bash"}% cd $SRT_CMSSW_BASE_SCRAMRTDEL/src/CATTools/CatProducer/prod/ cmsRun runCat.py useMiniAOD=True inputFiles=file:/pnfs/user/jlee/DYJetsToLL_M-50_13TeV-madgraph-pythia8/miniaod.root %ENDCODE%

To run on AODs, it is important to have the right globalTag used. %CODE{"bash"}% cd $SRT_CMSSW_BASE_SCRAMRTDEL/src/CATTools/CatProducer/prod/ cmsRun runCat.py useMiniAOD=False globalTag='PHYS14_25_V1::All' inputFiles=/store/mc/Phys14DR/DYJetsToLL_M-50_13TeV-madgraph-pythia8/AODSIM/PU20bx25_PHYS14_25_V1-v1/00000/00CC714A-F86B-E411-B99A-0025904B5FB8.root %ENDCODE% Please note that the the global tags are CMSSW version dependant. For PHYS14X?, use CMSSW_7_2_0 and above. For PLS170X?, use CMSSW_7_0 (below CMSSW_7_2_0)