There are currently two CMS scripts to download CMS luminosity information:

  1. for LHC Run1 lumi data
  2. and newer brilcalc (part of brilws) for LHC Run2 data which should at some point support also LHC Run1 lumi data

LHC Run1 lumi data

See users guide of on CMS Twiki ( requires CMSSW and provides only HF lumi)

Example -o fill_2836_lumiCalc2.py_V04-02-10_lumibylsXing.csv -f 2836 lumibylsXing --xingMinLum -1

LHC RUN 2 lumi data

CMS doc to brilws (look at it before continuing):

In short in the simplest case (look to the doc for more details, options and up to date comments!):

1) login to lxplus:

ssh -Y <user>

2) run

export PATH=$HOME/.local/bin:/afs/$PATH
pip uninstall -y brilws
pip install --install-option="--prefix=$HOME/.local" brilws
pip show brilws


lumi info for a given fill number may be downloaded as:

brilcalc lumi -f 4489 --xing -o fill_4489_brilcalc_lumi_xing.csv
which may provide only some BCID. To download some lumi values for all BCIDs you may try HF detector (dedicated to mainly online measurement):
brilcalc lumi -f 4489 --xing -o fill_4489_brilcalc_lumi_xing.csv --type hfoc

beam intensities may be downloaded as:

brilcalc beam -f 4489 --xing -o fill_4489_brilcalc_beam_xing.csv

Important note

The above instructions should help to get fast some lumi data for more advanced analyses it is necessary to ask CMS which lumi should be used for given TOTEM runs and what is the corresponding uncertainty etc (some corrections or calibration may require some more time for offline analysis and may come much later)

CMS lumi/bril mailing list:

Some usefull links

CMS Luminosity - public results

Simple lumi calculator:


BCID/BXID - bunch crossing ID (CMS stars from 1, TOTEM from 0 )

SBIL - single bunch instantaneous luminosity

LS - lumi section or lumi block (~23.3sec)


TOTEM fills without stable beams: in 2015: 3838, 3844, 3952 (no lumi available), 4489

-- JiriProchazka - 2015-10-28

This topic: TOTEM > WebLeftBar > CompOfflineSw > CompCMSlumi
Topic revision: r2 - 2015-10-28 - JiriProchazka
This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2021 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback