Two types of files must be provided to the n-tupliser when processing data:

the lumi masks (a.k.a. golden JSON files) are used to filter certified runs,
the pileup normalisation files are used to determine the pileup profile corresponding to the selected data.

These files should be provided to the n-tupliser in the luminosity block, e.g.:

"luminosity": {
    "mask": "/eos/user/c/cmsdqm/www/CAF/certification/Collisions24/Cert_Collisions2024_378981_386951_Golden.json",
    "pileup": "/afs/cern.ch/user/p/paconnor/workspace/DasAnalysisSystem/tables/PUprofile/Run2024DtoI.json"
}

Lumi masks

High-PU data

| 2016 | /eos/user/c/cmsdqm/www/CAF/certification/Collisions16/13TeV/Legacy_2016/Cert_271036-284044_13TeV_Legacy2016_Collisions16_JSON.txt | | 2017 | /eos/user/c/cmsdqm/www/CAF/certification/Collisions17/13TeV/Legacy_2017/Cert_294927-306462_13TeV_UL2017_Collisions17_GoldenJSON.txt | | 2018 | /eos/user/c/cmsdqm/www/CAF/certification/Collisions18/13TeV/Legacy_2018/Cert_314472-325175_13TeV_Legacy2018_Collisions18_JSON.txt | | 2022 | /eos/user/c/cmsdqm/www/CAF/certification/Collisions22/Cert_Collisions2022_355100_362760_Golden.json | | 2023 | /eos/user/c/cmsdqm/www/CAF/certification/Collisions23/Cert_Collisions2023_366442_370790_Golden.json | | 2024 | /eos/user/c/cmsdqm/www/CAF/certification/Collisions24/Cert_Collisions2024_378981_386951_Golden.json |

NB: analyses exclusively relying on muons may use slightly different lumi masks – see other files in the same directories.

Low-PU data

| 2016 | /eos/user/c/cmsdqm/www/CAF/certification/Collisions16/13TeV/ReReco/Final/Cert_271036-284044_13TeV_23Sep2016ReReco_Collisions16_JSON_LowLowPU.txt | | 2017C | /eos/user/c/cmsdqm/www/CAF/certification/Collisions17/13TeV/ReReco/Cert_299996-303819_13TeV_EOY2017ReReco_Collisions17_JSON_LowPU.txt | | 2017H | /eos/user/c/cmsdqm/www/CAF/certification/Collisions17/13TeV/ReReco/Cert_306896-307082_13TeV_EOY2017ReReco_Collisions17_JSON_LowPU.txt | | 2018 | /eos/user/c/cmsdqm/www/CAF/certification/Collisions18/13TeV/PromptReco/Cert_318939-319488_13TeV_PromptReco_SpecialCollisions18_JSON_LOWPU.txt |

PU profile

Before blindly using the files provided here, one should check the current recommendations TWiki. For Run 2, the so-called pileup_latest.txt files can be found at /afs/cern.ch/cms/CAF/CMSCOMM/COMM_DQM/certification/Collisions1?/13TeV/PileUp/UltraLegacy/pileup_latest*.txt. For Run 3, the equivalent files are called pileup_JSON.txt and can be found at /eos/user/c/cmsdqm/www/CAF/certification/Collisions2?/PileUp. It is also possible to recalculate them with brilcalc with following the instruction on the aforementioned TWiki.

Uncertainties

The Run 2 calibration has been taken from the reference TWiki and adapted to a custom format in the present directory.