The successor of the Monitor, based on Totem Offline SW.

Installation and documentation

The TotemDQM is a part of the Totem Offline SW, therefore the installation procedure and documentation sources are identical as to any other Totem Offline SW module.

For proper functionality (not for compilation), the TotemDQM needs the QtRoot tool.

User's guide

1. Getting started


After proper configuration of your CMSSW, just type:

to start Data Quality Monitor Application.

To see more options you can use:

runTotemDQM --help


After running DQM application you should see Main Window.

In order to use the application you must open a configuration file.

To do so, just click on File->Open.


Now you should see 'Open Dialog' window.

Choose configuration files to be opened in section 'Configuration File' and related data files in section 'Event Source'.

Click 'Open'.

After a while data should be loaded and you should see 'File opened' message in the status bar.


Now click on Window->New to open new plots' space


Try double-click on a cell to choose the plot you'd like to see.

After double-click on a cell, the 'Choose Dialog' Window should become visible.

Now you can select the plot that you're interested in.

From the left window (tree structure) you select the 'element type' and from the right window - 'output plot' related to the element.

Confirm by 'OK' or double-click.

You should see chosen plot in the clicked cell.


You can repeat the choosing plot operation for the same or other cells to get the plots you like.

If you need more cells, just increase the number of cells by clicking '+col' or '+row' button (in the 'Window Layout groupbox - right bottom of the Main Window).


For plots which are related to one event only use 'Event' groupbox (left bottom of the Main Window) to change the number of the run and event.

Use can also use '+' and '-' keyboard shortcut to change event number.

This is the minimum you have to know to use the DQM application, but you work can be much more pleasant and faster while using special features delivered by the DQM.

So I strongly recommend reading the next section.

2. Useful features


Multiple Windows feature gives you the possibility to better organize your plots. You can keep them separate windows which can be easily attached/detached and tabbed in Main Frame.

To detach window from the main frame just click on the window name (e.g. "Untitled") and while pressing the mouse button move the cursor outside the Main Frame.

Now, release the mouse button. Hopefully you can see a separate window related to the same application.

To attach the window back to the Main Frame, just grab it and move to the Main Frame Then release the button.

Now, change the window name. You can do it by double clicking on the current name of the window (just the place you pressed the button key before). Try double click on that place (e.g. "Untitled"). You should see the change window name dialog.

Try changing the window name (e.g. "Very important plots").

The windows can be tabbed in the Main Window. Try creating a new window (Window->New).

Now, you should see it has been added as a tabbed window which you can control be clicking the right tab.

Benefit from the multiple windows and separate logically your graph in a way that is the best for you.


Layout feature gives you the possibility to save and load the arrangement of your plots.

So you just place the plots in the positions you like and then save the layout. After running again the application you can load the layout and have the same plot arrangement you've saved.

There are two types of layouts:

  1. Window Layout
  2. Application Layout

Window Layout

Window Layout is related to the one window (not all window we have in the application).

It remembers:

  • the arrangement of the plots (inside one window).

To save the Window Layout click on the Save button placed on the bottom right side of the window.

Now when you run the DQM application once again or just create a new window you can have the same plots that you saved by loading the right *.lay file.

Try also creating new window directly from Window Layout file by clicking Window->New From...

Application Layout

Application Layout is related to the whole application.

It remembers:

  • names of all the window
  • arrangement of plots in all the windows
  • geometry of the windows
  • attached/detached with reference to the Main Window

To save the Application Layout click Application Layout->Save to....

Now, after running the application once again you can load the Application Layout by clicking Application Layout->Load From... and selecting the right *apl file.

Directories to save layouts

The directories to keep layouts can be selected each time you wish to save/load layout. But for the convenience the default directories can be set by using environmental variable:



Plot Drag&Drop feature is extremely useful while arranging the plots places. You can simply change the place of the plot.

While the mouse cursor is on some plot press Ctrl key and keep it pressed. Now press the left mouse button and while they are pressed (both Ctrl key and left mouse button) move the cursor on some other.

Now release the mouse button. You should see that plots have changed their places.

Drag&Drop can be also used when one would like to exchange the plots between windows.


Zooming feature is useful when one would like to see the plot in details.

Try clicking on the plot with both mouse buttons (or while pressing Shift button click left mouse button). You should see a new fullscreen window only with one plot in it.

3. Detailed application description


Open File window is dedicated to selecting and opening the proper configuration file with data files.

1. configuration file selection

Click browse to select the configuration file you want to use. The configuration files you selected before are remembered and you can use them by clicking on the combo box.

If you want to edit the configuration file - click edit. It will be opened in editor set by local variable


If the variable is not set, the configuration file will be opened in kate editor

2. data source selection

You can use data files from the configuration file (if there is any) or select data files separately.

3. selecting data files

Click on browse button to add a new data file.

Click on clear button to clear the configuration file field.

Your previous choices are remembered in the history, so by clicking '<--' and '-->' buttons you can select one of them.


The graphs seen in the Choose Dialog Window have to be firstly registered in DQM Plugin. It is made by the function:

PlotManager::Register(const std::string &path, const std::string &title, TNamed *n, const string &opt, bool own)

path is a tree pattern string

For example after registering graph with the path:

“sector 56/station 220/nr_tp/plane 02/cluster size”

we will see the result in the Choose Dialog window like:

After choosing the proper element in the left part of the window the plots related to this element will be shown in the right part of the window.

Then, click OK select and show the chosen plot.

One can use also Empty to clear the cell (put empty plot).


View can be seen in the botton middle part of the window. It consists of 3 buttons.

  • Refresh - used to refresh visually plots and to update the incoming data (with streaming data)
  • Screenshot - used to save the plots as an image in the selected format
  • Save ROOT File - used to save all the plots that have been registered in the PlotManager to ROOT file

4. Other important information


The correlation plot is done for 2 planes. If we wanted to use all the planes, there would be too many plots. So we have to reduce the number of the correlation plots.

There are 3 variables in the configuration file:

  • buildCorrelationPlots : cms.untracked.bool - decides whether to use correlation plots or not
  • correlationPlotsLimit : cms.untracked.uint32 - decides the maximum number of the correlation plots
  • correlationPlotsFilter : cms.untracked.string - decides which planes are used for correlation plots

The example of the filter string:

“default=0,3,6; 120=0,3,6,4;”

With this string following planes would be used:

  • from RP number 120 planes 0,3,4,6
  • from RPs planes 0,3,6

So the default defines the planes for every casual RP, then we specify for each RP which plane to use.

From all the chosen planes all necessary correlation plots are created.


It is possible to do several thing strict from the command line (before starting the application):

  • loading configuration file
  • loading Window Layouts
  • loading Application Layouts

use help to see all the possibilities.

runTotemDQM -h

TODO: to be filled by Rafal smile

Topic attachments
I Attachment History Action SizeSorted ascending Date Who Comment
PNGpng 18.png r1 manage 1.7 K 2009-09-17 - 19:12 UnknownUser  
PNGpng 11.png r1 manage 2.7 K 2009-09-17 - 17:46 UnknownUser  
PNGpng 12.png r1 manage 3.3 K 2009-09-17 - 17:54 UnknownUser  
PNGpng 8.png r1 manage 5.2 K 2009-09-17 - 17:08 UnknownUser  
PNGpng 1.png r1 manage 9.2 K 2009-09-17 - 16:49 UnknownUser  
PNGpng 17.png r1 manage 12.9 K 2009-09-17 - 18:59 UnknownUser  
PNGpng 2.png r1 manage 13.5 K 2009-09-17 - 16:52 UnknownUser  
PNGpng 4.png r1 manage 13.6 K 2009-09-17 - 16:52 UnknownUser  
PNGpng 7.png r1 manage 14.7 K 2009-09-17 - 17:00 UnknownUser  
PNGpng 9.png r1 manage 14.8 K 2009-09-17 - 17:13 UnknownUser  
PNGpng 3.png r1 manage 15.6 K 2009-09-17 - 16:52 UnknownUser  
PNGpng 15.png r1 manage 16.1 K 2009-09-17 - 18:20 UnknownUser  
PNGpng 16.png r1 manage 16.7 K 2009-09-17 - 18:35 UnknownUser  
PNGpng 5.png r1 manage 17.0 K 2009-09-17 - 16:53 UnknownUser  
PNGpng 10.png r1 manage 18.3 K 2009-09-17 - 17:39 UnknownUser  
PNGpng 6.png r1 manage 18.3 K 2009-09-17 - 16:53 UnknownUser  
PNGpng 14.png r1 manage 19.6 K 2009-09-17 - 18:14 UnknownUser  
PNGpng 13.png r1 manage 20.2 K 2009-09-17 - 18:13 UnknownUser  
Edit | Attach | Watch | Print version | History: r9 | r5 < r4 < r3 < r2 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r3 - 2009-09-17 - unknown
    • 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