You are here: TWiki> Online Web>HistogramPresenter (2017-06-24, robbep)
Tags:
create new tag
, view all tags

Presenter manual for monitoring experts

Usage at the Pit:

Linux:

  1. login to a plus nodes
  2. type presenter
  3. you can specify command line options for changing the default behaviour. Use presenter --help for a list. In particular:
    • presenter -D myDimDns for using a DIM_DNS_NODE other than mona08
    • presenter -M history saveset.root for looking at a saveset in history mode (presently, you'll have to select the "preset file" in the history menu before clicking on pages).

Web interface to the database:

Quick overview

The default mode of operation is to start with the database in read-only mode within the Pit. Start-up parameters can be obtained via the "--help" option. If you use the Presenter as an on-line DIM histogram browser:

  1. Switch to Editor Mode via the Tool menu from the top menu bar and logout from the Database.
  2. The "DIM Histogram Browser" tree will display all the H1D, H2D and Profile histograms available on the given DIM_DNS_NODE. Check the items to be displayed, and "Add selected to Page" using the context menu of the tree.
  3. Select the histogram with the middle button (it will get a red frame) and move / resize as desired on the page. Alternatively, the "Auto Layout" button will tile the histograms on the page
  4. Start / Stop refresh, make static copy of a selected histogram with the "Histogram Zoom button" and zoom / fit on that copy.
  • Pages are transient, and are not saved to the Database
If you use the Presenter with the Database:
  • This is the default mode of operation: the available pages will be listed on the left side in the "Database Page Browser" tree. Clicking on it will load the given page, and fill the histograms if they are available on-line via DIM. The default login is in read-only mode.
To create pages:
  1. Got into Editor Mode via the Tool menu from the top menu bar, and login as "HIST_WRITER". Your database privileges are shown through the Help->About menu.
  2. Login to the database (just accept the default settings - it should work in the Pit). When using our pit OnlineHistDB, DB name changes:
    • inside pit: HISTDB
    • outside pit: LHCBR_HIST (read-only)
The Oracle RAC database is called HISTDB, and is intended to be "for real". Take care to set the proper environment External link mark if you do not use the /online/presenter shell scripts.
  1. The "Histograms in Database" tree will display all the histograms available. Filter criteria can be set using the drop-down Combobox above the tree. Histograms are normally declared to the Database via a discovery application, but you can also declare them manually via the DIM tree context menu if you have write access to the Database.
  2. Check the items to be displayed, and "Add selected to Page" using the context menu of the tree or "Set properties of checked histogram(s)": a property dialogue will be shown and the settings will apply to all histograms selected.
  3. Select the histogram on the page with the middle button (it will get a red frame) and move / resize as desired on the page. Alternatively, the "Auto Layout" button will tile the histograms on the page
  4. You can change the ROOT settings of the selected histogram using Edit->Histogram Properties... (the ROOT editor dialog appears). Most, but not all, of the ROOT display options are recorded in the DB when saving the page
  5. Save the given page to the Database using the "Save to DB" button
  6. Start / Stop refresh, make static copy of a selected histogram with the "Histogram Zoom button" and zoom / fit on that copy. Beware that modifications of the display settings of the copy are not saved!
  • Pages stored in the Database are listed in the "Pages in Database" tree. They can be loaded via the context menu.
  • Histograms loaded from the Database which cannot be connected to a live DIM service will have a white place holder.
General remarks:
  • All histograms on the page can be removed using the "New/Clear Page" button
  • Do not double-click on Cancel/Close buttons (and avoid double-clicks in general, even if the application is slow: clicking twice will only bring it down)
  • Use ROOT context menus and functionality on the static copy of the given histogram
  • Although no number limits are imposed, take care not to have much more histograms on a page than you really need (it becomes very slow, at ~100 for the moment). You can declare up to 1000 histograms to the database in one go.

Reference histogram edition

Use the following script, on a plus node, after typing once lb-run Online/latest bash:

python /group/online/presenter/RefEditor/RefEditor.py

with the following arguments (the optional --polarity argument can be used to define reference per polarity. If it is omitted, it will apply to default histograms)

List all tasks

python /group/online/presenter/RefEditor/RefEditor.py --listtasks

List histograms from a task

python /group/online/presenter/RefEditor/RefEditor.py --listhistos --task TASK

where TASK is a task name (from the list obtained with --listtasks)

List the reference histograms for a task

python /group/online/presenter/RefEditor/RefEditor.py --listreferences --task TASK [--polarity UP/DOWN]

where TASK is a task name (from the list obtained with --listtasks)

List the date and time of all savesets available for a task

python /group/online/presenter/RefEditor/RefEditor.py --listsavesets_time --task TASK

where TASK is a task name (from the list obtained with --listtasks)

List the run savesets available for a task

python /group/online/presenter/RefEditor/RefEditor.py --listsavesets_run --task TASK

where TASK is a task name (from the list obtained with --listtasks)

Show the reference for a task and histogram

python /group/online/presenter/RefEditor/RefEditor.py --showref --task TASK --histo HISTO [--polarity UP/DOWN]

where TASK is a task name (from the list obtained with --listtasks) and HISTO an histogram name (from the list obtained with --listhistos=). If polarity is specified, it will show the reference stored in the reference file used for this magnet polarity.

Show the run saveset content for a task and histogram

python /group/online/presenter/RefEditor/RefEditor.py --showsaveset --task TASK --histo HISTO --run RUN

where TASK is a task name (from the list obtained with --listtasks), HISTO an histogram name (from the list obtained with --listhistos=) and RUN a run number (from the list obtained with --listsavesets_run=).

Show the time saveset content for a task and histogram

python /group/online/presenter/RefEditor/RefEditor.py --showsaveset --task TASK --histo HISTO --time TIME

where TASK is a task name (from the list obtained with --listtasks), HISTO an histogram name (from the list obtained with --listhistos=) and TIME is a saveset's time (from the list obtained with --listsavesets_time=).

Compare a run saveset content for a task and histogram with the reference

python /group/online/presenter/RefEditor/RefEditor.py --compare --task TASK --histo HISTO --run RUN [--polarity UP/DOWN]

where TASK is a task name (from the list obtained with --listtasks), HISTO an histogram name (from the list obtained with --listhistos=) and RUN is a saveset's run number (from the list obtained with --listsavesets_run=).

Compare a time saveset content for a task and histogram with the reference

python /group/online/presenter/RefEditor/RefEditor.py --compare --task TASK --histo HISTO --time TIME [--polarity UP/DOWN]

where TASK is a task name (from the list obtained with --listtasks), HISTO an histogram name (from the list obtained with --listhistos) and TIME is a saveset's time (from the list obtained with --listsavesets_time).

Delete an histogram from the reference file for a task

python /group/online/presenter/RefEditor/RefEditor.py --delete --task TASK --histo HISTO [--polarity UP/DOWN]

where TASK is a task name (from the list obtained with --listtasks) and HISTO an histogram name (from the list obtained with --listhistos).

Copy an histogram from a run saveset into the refence file for a task

python /group/online/presenter/RefEditor/RefEditor.py --copy --task TASK --histo HISTO --run RUN [--polarity UP/DOWN]

where TASK is a task name (from the list obtained with --listtasks), HISTO an histogram name (from the list obtained with --listhistos) and RUN is a saveset's run number (from the list obtained with --listsavesets_run). If TASK is ALL, all histograms in the saveset are used as a new reference.

Copy an histogram from a time saveset into the refence file for a task

python /group/online/presenter/RefEditor/RefEditor.py --copy --task TASK --histo HISTO --time TIME [--polarity UP/DOWN]

where TASK is a task name (from the list obtained with --listtasks), HISTO an histogram name (from the list obtained with --listhistos) and TIME is a saveset's time (from the list obtained with --listsavesets_time). If TASK is ALL, all histograms in the saveset are used as a new reference.

Edit | Attach | PDF version | Print version |  | Raw View | Raw edit | Backlinks | History: r12 < r11 < r10 < r9 < r8 | More topic actions
Topic revision: r12 - 2017-06-24 - robbep
 

TWIKI.NET
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback