====== Luminosity at CMS ======

Summary plots of data taking at CMS and the LHC can be found [[https://twiki.cern.ch/twiki/bin/view/CMSPublic/LumiPublicResults|here]].


===== Calculate the integrated luminosity =====

For a given dataset, you can calculate the luminosity yourself with the ''brilcalc'' tool described [[https://twiki.cern.ch/twiki/bin/view/CMS/TWikiLUM|at the Lumi POG]] and [[https://cms-service-lumi.web.cern.ch/cms-service-lumi/brilwsdoc.html|in the manual]].

You need a JSON file that contains all the runs you want to include:
<code bash>
brilcalc lumi -b "STABLE BEAMS" --normtag /afs/cern.ch/user/l/lumipro/public/Normtags/normtag_DATACERT.json -u /pb -i myJSON.txt
</code>

Typically, you can find the JSON files on ''afs'', for example for 2017 data:
<code>
/afs/cern.ch/cms/CAF/CMSCOMM/COMM_DQM/certification/Collisions17/13TeV/Final/Cert_294927-306462_13TeV_PromptReco_Collisions17_JSON.txt
</code>
and for a certain era dataset (''B''-''F''), take a look in:
<code>
/afs/cern.ch/cms/CAF/CMSCOMM/COMM_DQM/certification/Collisions17/13TeV/Era/Prompt/
</code>
For the recommended JSON files, [[#run_numbers|see below]].
===== Run numbers =====

You can find the correct run numbers and the corresponding JSON files here:
  * [[https://twiki.cern.ch/twiki/bin/viewauth/CMS/PdmV2015Analysis|Run II, 2015 data]]
  * [[https://twiki.cern.ch/twiki/bin/viewauth/CMS/PdmV2016Analysis|Run II, 2016 data]]
  * [[https://twiki.cern.ch/twiki/bin/viewauth/CMS/PdmV2017Analysis|Run II, 2017 data]]