A package of data-quality monitoring tools, focusing on high-level reconstruction (e.g. tracks) which is performed by the Offline SW. It is complementary tool set to the Monitor.


Data processing is split into two phases:

  1. reconstruction is performed with standard Offline SW (CMSSW), producing RECO files
  2. visualisation is done with a separate program reading RECO files
This organisation brings several advantages
  • better separation of reconstruction and visualisation code (easier to maintain)
  • reconstructed data are not lost when DQM window is closed
  • DQM can be used to visually inspect RECO files made for analysis

Tools in the package

  • TotemDQMLite: monitoring tool with graphical user interface
  • TotemDQMLiteBatch: tool to save plots as PDF files according to predefined layouts
  • TotemDQMLiteRaw: convenience script to perform both reconstruction and visualisation with one command

Repository and installation

TotemDQMLite is a part of the Offline SW version 7.x and can be downloaded from the standard SVN repository

svn co svn+ssh://

Compilation follows the standard rules of the Offline SW.



TotemDQMLite is configured with files with syntax very similar to the standard CMSSW python files, for example

import FWCore.ParameterSet.Config as cms

TotemDQMModuleDAQ = cms.PSet(
    tagRawEvent = cms.InputTag("source")

TotemDQMModuleRP = cms.PSet(
   tagRawEvent = cms.InputTag("source"),
   correlationPlotsFilter = cms.untracked.string("default=0,1")

#TotemDQMModuleT1 = cms.PSet()
If a module is commented out or not mentioned in the file, it will not be included in visualisation. At the moment, there are four modules available: names end with DAQ, RP, T1 and T2.

If no configuration file is explicitly supplied, TotemDQMLite will use the default configuration:


TotemDQMLiteBatch: User's guide

Complete help can be obtained by running TotemDQMLiteBatch --help. A typical use is a follows:

TotemDQMLiteBatch reco_file.root -l layout1.lay -l layout2.lay
which will process file reco_file.root and save plots layout1.pdf and layout2.pdf following the chosen layouts. A collection of standard layouts can be found in:

TotemDQMLiteRaw: User's guide

All the options are explained by TotemDQMLiteRaw --help. For each of the options, one can easily set default values, see src/TotemDQMLite/GUI/scripts/TotemDQMLiteRaw_README. Typical usage:

TotemDQMLiteRaw raw_data.srs --reco-cfg RP --reco-dir /tmp
The script will first check the RECO-file pool (here /tmp) for a file corresponding to raw_data.srs. If not found, it will launch CMSSW with config template RP. These templates are stored in:
Once the RECO file is available, it will start TotemDQMLite for visualisation.

-- JanKaspar - 2015-10-07

This topic: TOTEM > WebPreferences > CompDQM
Topic revision: r1 - 2015-10-07 - JanKaspar
This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2020 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback