jme-validation

Framework based on Bamboo, running on NanoAOD, to validate JME deliverables.

Installation

In order to install the framework, first git-clone:

git clone https://github.com/cms-jet/jme-validation

Then, run the installation script:

source install.sh

The script will install Bamboo, plotit and CMSJMECalculators inside a python virtual environment.
After installation, a few changes to the bamboo code are neeed. These changes will soon be implemented directly inside the installation script. For the time being, you can implement them using the sed command. Known changes needed:

     sed -i 's/"Rho_fixedGridRhoFastjetAll"/"Rho"/g' bamboo/bamboo/analysisutils.py
     sed -i 's/"Rho_fixedGridRhoFastjetAll"/"Rho"/g' bamboovenv/lib/python3.9/site-packages/CMSJMECalculators/utils.py
     sed -i 's/JRDatabase/jme-validation/g' bamboo/bamboo/analysisutils.py
     sed -i 's/JECDatabase/jme-validation/g' bamboo/bamboo/analysisutils.py
     sed -i '/cms-jet\/jme-validation/s/$/ branch="main",/' bamboo/bamboo/analysisutils.py
     sed -i 's/heads\/master"/heads\/"+self.branch/g' bamboovenv/lib/python3.9/site-packages/CMSJMECalculators/jetdatabasecache.py
     sed -i 's/idxs=defCache(self.rng)/idxs=defCache(self.rng).replace("IndexRange<std::size_t>{","IndexRange<std::size_t>{static_cast<unsigned long>(").replace("}",")}")/g' bamboo/bamboo/treeoperations.py

Every time you change bamboo-related code, you have to reinstall the packages dependencies by doing

pip install --upgrade .

or using the bash script:

source recompile.sh

Finally, inside the jme-validation main folder, you need to create a file called bamboo.init with the following content:

[batch]
backend = htcondor

[htcondor]
jobflavour = "longlunch"

[das]
sitename = T2_CH_CERN
storageroot = /eos/cms
xrootdredirector = cms-xrd-global.cern.ch

Running the framework

To have the framework run, first source everything you need by doing

source setup.sh

We currently have two modules (corresponding to different selections) that can be run:

• QCD: used to obtain MC truth corrections;
• DY: used for jet reconstruction efficiency/purity and tau performance plots.

The choice of which module to run can be made by setting the module variable inside /macros/steer.py accordingly.

You can perform a test run by doing:

 ./macros/steer.py -c -t

If everything looks good, you can submit condor jobs:

./macros/steer.py -c -s

Finally, you can make plots:

./macros/steer.py -p

Running on custom NanoAODs

The framework can be run either on centrally-produced NanoAOD samples or custom ones. In order to produce custom NanoAOD samples that meet most of needs of the JME group, we are currently developing the JMENano framework.