Documentation of tkCommissioner New

This document shall provide some documentation about the tkCommissioner which can be used to easily perform various tasks around the commissioning of the CMS silicon tracker.


Description of the GUI

DirectedGraphPlugin_1.png diagram

Run Selection

In the main window you will see a list of partitions (left) and runs within this partition (right). If you have taken new runs while tkCommissioner was running, you can update both views with the buttons.

If you want to analyse a run (i.e. produce the commmissioning source and client file) choose the run in the right panel and press the "Analyze" button For a first analysis of the data you want to have "save client file" and "save analysis" checked. Do not check "upload config" unless you have finished looking at this particular run and want to actually have it saved.

If for a given run the data are uploaded into the database and the client file is there, you should have the "View Results" button active and the "use client file" checked. Then you can press "View Results" to look at the output. If starting the treeviewer failed something went wrong.

Tree View (``View Results'')

After starting the tree viewer, you will get two windows: The tree viewer main window and another window with several summary histogramms. The latter window is probably behind the main window. The summary histogramms are retrieved from the client file. They are described here (in the individual run sections). There will be some warning messages in the shell from which you started the tkCommissioner, saying

Error in <TH1F::Add>: Attempt to add histograms with different number of bins
which is normal due to the way the histogramms are retrieved.

Detailed View (``GetSelected'')

This image displays information about the items you selected with the tree viewer. The first row is the DeviceId, which is a unique identifier for the object in question. The next rows are the two rows which were used as x and y axis in the tree viewer. After this, all information about the fec/fed location follows.

Note : If you chose one of the fec/fed columns as x or y axis, it will not be displayed in the first rows (there will be just one or none if you took two variables which are there by default)

You can check various boxes in front of the devices and click on "Source Histogram" to get to the raw histograms for the respective device from the client file.

If you find a problem which should want to tag, you check the boxes in front of the respective devices, you select a "Tag" from the combobox or, if you don't find a tag which describes the problem you found, you can create a new tag. After this, you can press "Tag selected" to open the respective dialog.

Display from ROOT File (``Details for Selected'')

If you have multiple histogramms in the window, you can select a single one by middle-clicking on the respective subcanvas and then pressing "Redraw" which will open a new window with only the selected graph displayed. If you check the "ROOT Canvas" box, the window will be redrawn in a standard root canvas with all the menus on the top.

Create DB Tag

A largely self-explaining window. Just enter the title of the new tag (less then 100 characters) and click "Ok". Do not enter a tag which already exists

Open Ticket in Analysis Log (Tag Selected)

When you open the "Tag selected" window, you should see all devices which you selected. Below this list you should see the tag description of the tag you selected. You can select items and add a comment (either by pressing the "Add comment" button for many devices or by clicking on the comment line of a single device).

Before uploading, you have to check the "confirm" box (this is just a precaution). After pressing Ok, you will be prompted to enter your name. After this you will get a notification about the sucess or failure of the upload.

Things that can (and will) go wrong

  • No runs are displayed:
    • There is probably a problem with the $CONFDB variable in your setup. This should have the form of "someuser/somepassword@somecomputer"
    • Try to use the read/write-able account, the read-only one does not work with tkCommissioner
  • Use client file is checked (i.e. the file exists), but no results are retrieved
    • Something probably went wrong during the analysis or you never uploaded the results. In any case there is no record in the database associated with this run.
  • tkCommissioner crashes with a nasty seg fault after you just pressed a button
    • (Most likely) Not your fault, restart and try again
  • Creating a "New Cut" does not do anything:
    • Probably the active pad is not in the treeviewer. Middle-click on the treeviewer canvas. After this, it should have a red frame and creating the cut should work

-- ErikButz - 26 May 2009

Edit | Attach | Watch | Print version | History: r16 < r15 < r14 < r13 < r12 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r16 - 2013-09-02 - TWikiGuest
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    Sandbox All webs login

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.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback