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 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 + one extra module 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:

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


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

Edit | Attach | Watch | Print version | History: r3 < r2 < r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r3 - 2015-10-29 - 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-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