LHCb Conditions Database Browser

Table of Contents


The Conditions Database Browser (CondDBBrowser) is a Graphical User Interface (GUI) that can be used to browse LHCb Git Conditions Database (GitCondDB). The current version is a fork with reduced functionalities of the original CondDBBrowser (which was able to read from and write to COOL database files). The old version is still available from old releases of the LHCb projects, so if you need to browse COOL database files, please, got to the legacy version of this page.

With respect to the legacy version, the current CondDBBrowser lacks:

  • access to COOL files
    • not needed because all active branches of LHCb software projects have been migrated to GitCondDB)
  • write to a CondDB partition
    • while this was mandatory for COOL databases, GitCondDB can be updated with any editor or even from the Gitlab Web IDE

The GUI had been implemented on top of the Qt framework (version 5.x) using the official Python bindings (adapted from the old PyQt5 version).

Get the Browser

The CondDBBrowser is available in the standard LHCb User environment (on cvmfs) as the command
but is packaged as a standard Python (2) package and can be installed with
pip install CondDBBrowser

Using the CondDB Browser

This part of the document is mainly a guided tour through which most of the browser's functionalities will be described.

Assuming you have either the standard LHCb User environment (e.g. on lxplus), or you installed the browser with pip, you can start it with:


This will open the main window of the browser:

CondDB Browser main window view

Navigating the database

Opening an existing database

If you want to open one of the standard GitCondDB partitions deployed on cvmfs you should go to the menu Database/Standard and choose the one you need. Note that this functionality may not be available with the pip-installed version, but you can still browse and GitCondDB repository.

To open a non standard partition/deployment (or if the "Standard" menu is not active) you have to go to Database/Open menu:

CondDB Browser open database view

Here you have to switch to the "advanced" tab and type the path of the directory containing the GitCondDB clone.

The tree view

CondDB Browser data tree view
hierarchy_browser.png The image on the right is an example of the contents of the data tree, located on the left in Hierarchy browser. Here the LHCBCOND partition is opened, as an example. You can travel through it like in most file system explorer programs. At the top of the tree, you can see a location bar which displays the path to the selected tree item. You can choose the path from the expandable list to go quickly to the item you are interested in.

Like in any filesystem, you can find:

  • folders: used to group other folders and files
  • files: represent condition values with their evolution with time

The data display and the time filter

Selecting a file in the tree view will modify the content of the central and right sides of the main window: the data display and the time browser. The image below shows what appears when selecting /Conditions/Ecal/Calibration/Gain.xml:

Contents of the data display and of the time browser

  • The data display (the central one part) displays the contents (in text) of a condition object stored in the database.
  • The Time Browser offers the possibility to select the condition object to display. These condition objects are listed in the IOV Table area. By default, the list of condition objects is reduced to the one, which is active starting from current time. Full list (or the one for specific "From time and To time") can be seen adjusting the settings in the Filter area of the Time Browser.

One a file is selected, it is possible to chose the version of its content via the Tag Name selector:

Tag names list area view for the particular _folder_

The selector contains the list of tag names available for the partition. Tags are grouped by the version of the current file, such that tags pointing to the same version of the files appear close to each other and with the same background color.

Useful tip:

  • If you want to copy the current contents of the text box you can just select the text and right-click on it to open the pop-up menu, and choose Copy. There you can find another few useful actions.


-- IllyaShapoval - 31-Jan-2010

-- MarcoClemencic - 2019-09-10

Topic attachments
I Attachment History Action Size Date Who Comment
PNGpng add_condition.png r1 manage 119.1 K 2010-02-02 - 00:31 UnknownUser Add condition to the Folder
PNGpng browser.png r1 manage 29.1 K 2010-02-01 - 10:33 UnknownUser CondDB Browser main window view
PNGpng browser_open_menu.png r1 manage 34.7 K 2010-02-01 - 13:18 UnknownUser CondDB open menu window
PNGpng data_display.png r1 manage 141.6 K 2010-02-01 - 14:55 UnknownUser Contents of the data display and the Time Browser
PNGpng edit_condition_payload.png r1 manage 143.9 K 2010-02-02 - 00:32 UnknownUser Edit payload
PNGpng hierarchy_browser.png r1 manage 27.8 K 2010-02-01 - 13:22 UnknownUser CondDB Browser Hierarchy Browser
PNGpng new_db.png r1 manage 9.4 K 2010-02-01 - 23:15 UnknownUser Creation of a new db from scratch
PNGpng new_from_slice.png r1 manage 34.9 K 2010-02-01 - 23:15 UnknownUser Creation of a new db from a slice
PNGpng new_node.png r1 manage 115.0 K 2010-02-02 - 00:40 UnknownUser Creating a new node
PNGpng new_tag.png r1 manage 128.8 K 2010-02-02 - 00:36 UnknownUser Adding a new tag
PNGpng new_tag_folderset_2.png r1 manage 123.8 K 2010-02-03 - 03:03 UnknownUser Creating the tag for the FolderSet (2)
PNGpng tag_names.png r1 manage 149.0 K 2010-02-01 - 17:50 UnknownUser Tag names for the folder
Edit | Attach | Watch | Print version | History: r16 < r15 < r14 < r13 < r12 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r16 - 2019-09-10 - MarcoClemencic
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    LHCb 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