Instructions how to download CMS luminosity and bunch intensities for a given LHC fill

BRIL (Beam Radiation Instrumentation and Luminosity) is a new project within CMS introduced after LS1: "it comprises all subdetectors for the measurement of the luminosity, monitoring of the beam conditions, and protection of CMS from serious radiation damage"

There are currently two CMS scripts which provides CMS luminosity calibrated using VDM scans (separation scans):

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

How to download luminosity for runs BEFORE LS1

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

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

How to download luminosity and beam/bunch intensities for runs AFTER LS1

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

brilws release notes:

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 (adjust to your real running setup accordingly, the following will uninstall current version of brilws and install the latest one, X.Y.Z should be the latest brilconda version, see

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 BCIDs. 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
To select just some BCIDs (e.g., 41,1826,901,932):
     brilcalc lumi -f 4489 --xing --xingId "41,1826,901,932" --xingMin 1e-100 -o fill_4489_brilcalc_lumi_xing_ids.csv  --type hfoc

  • beam/bunch 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). The downloaded file with lumi values includes in header also some meta information (data tag and norm tag - "version") which is very useful for later usage - to keep track of the version, lumi values serving as an input for an physics analysis (=>save and keep the file).

CMS lumi/bril mailing list:

Timber variables for bunch intensities (for beam 1 and beam 2 separatelly)


or (there are two systems "A" and "B" which should report consistent values; or at least one system should work)


a csv file for a given fill number and each beam may be downloaded using Timber. This is an "online" alternative to offline "brilcalc beam" to retrieve bunch intensitites for each beam.

Some usefull links

CMS Luminosity - public results

Simple lumi calculator

General information about luminosity calibration at the LHC (mostly outdated but contains links about concept of luminosity etc)



Central deployment:


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

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

CMS lumi callibration in 2015 (pp@13TeV):

LHC Programme Coordination

Filling Scheme Editor

Filling Schemes

Java Filling schemes viewer


-- JiriProchazka - 2015-10-28

Edit | Attach | Watch | Print version | History: r7 < r6 < r5 < r4 < r3 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r7 - 2017-07-26 - JiriProchazka
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    TOTEM All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2023 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