To resize the main window, drag any of its corners or borders with the left mouse button.
To grab a snapshot of the main window, select "Grab Screenshot" from the File menu. A "Save Image As ..." dialog will appear. Type a file name, noting the directory in which the file is saved. The image type will depend on the suffix of the file name chosen.
The tabs displayed can be configured as described in Section Configuring the GUI.
To save a plot (e.g., for posting on ATLOG), right-click on the plot, and select "Save Image". A preview window will open, displaying the plot and a legend. Click the "Save Image" button. A "Save Image As ..." dialog will appear. Type a file name, noting the directory in which the file is saved. The image type will depend on the suffix of the file name chosen.
To zoom into a plot, drag the left mouse button horizontally in the region below the horizontal axis, or vertically in the region to the left of the vertical axis.
To unzoom, right-click on the plot and select "Unzoom".
If, when zooming into a time axis, the mouse is released beyond the maximum of the axis, the maximum of the plot will not be fixed. In other words, the zoomed-in plot will continue to update.
To identify a trend, click on a point in the trend with the left mouse button. A tooltip will appear, displaying the name of the trend while the mouse button is pressed.
When a spike appears in a plot of trigger rates, more than one trigger may be involved. This, however, may not be immediately obvious: if several triggers drawn on the same plot have identical rates, only the trend drawn last will be visible. To determine which triggers contribute to a spike, drag the middle mouse button inside the plot, and select a rectangular region that encloses the spike. When the middle mouse button is released, a message window will appear, listing the names of the trends that have points in the selected region of the plot.
The Tables tab contains one or more sub-tabs, each of which displays a table.
Select any combination of cells from any combination of the available tables by left-clicking the cells or dragging the left mouse button. Pressing the Ctrl button while clicking the cells will allow you to select non-contiguous cells. Next, click the "Plot" button. A new window will open, displaying the trends corresponding to the cells selected in the tables.
Before making a new selection, click the "Clear" button to ensure that all the previously highlighted cells in all the tables are cleared.
Select any combination of cells from any combination of the available tables by left-clicking the cells or dragging the left mouse button. Pressing the Ctrl button while clicking the cells will allow you to select non-contiguous cells. These will be plotted on the y-axis. Select a cell for the x-axis by double clicking. If this cell is in the same tab as the previously selected cells, use the Ctrl key. Next, click the "Plot Correlation" button. A new window will open, displaying the trends corresponding to the cells selected in the tables.
Before making a new selection, click the "Clear" button to ensure that all the previously highlighted cells in all the tables are cleared. The cell selected by double-clicking will however be saved, until you make a new double-click selection.
In the field labelled "Filter", type some text or a regular expression. If all characters are lower-case the search will be case-insensitive, otherwise case-sensitive. The entries in the tables will then be filtered to display only those entries that have names matching the text or regular expression.
To un-filter, simply erase the text in the "Filter" field.
The TRP GUI can be configured to have one or more plot tabs. Each plot tab can be configured to display one or more plots. Each of these plots can in turn be configured display one or more trends. Plot tabs should be used to display default plots that all shifters should monitor.
The configuration file is specified with the -c option:
trp -c /path/file.xml
The XML file should be well-formed. In particular, it must contain
exactly one root element called <settings>
.
Use the <general>
element
to specify the TDAQ partition, the TRP server, and the trigger database,
as well as the history size
(i.e., the maximum number of points to display in the plots).
Note that if a partition is specified on the command line with the -p option,
it will override the partition specified in the configuration file.
If no partition is specified on the command line or in the configuration file,
then the environment variable $TDAQ_PARTITION will be used.
If no such environment variable is defined, the partition name
will be set to "ATLAS".
Use the <threads>
element
to list the TRP threads to subscribe to.
For each thread, a table will be displayed in the Tables tab.
Use the alias
attribute of the <thread>
element to specify the name that will be displayed on the sub-tab of the table.
Each plot tab is defined within a <plotpage>
element.
The name of the tab is specified by the <title>
element.
To add plots to a plot tab, use nested <plot>
elements
within the <plotpage>
element.
A <title>
for the plot is optional.
Add one or more <trend>
elements to the plot.
For each trend, specify the <thread>
number, as well as
an <x>
and a <y>
title.
Note that the thread number 0 corresponds to the first thread listed in the
<threads>
element described in the previous paragraph.
A sample configuration file follows.
<?xml version="1.0" encoding="ISO-8859-1"?>
<settings>
<general>
<triggerdb>TRIGGERDB</triggerdb>
<partition>TDAQ</partition>
<server>ISS_TRP</server>
<history>200</history>
</general>
<threads>
<thread alias="L1">L1_Rate</thread>
<thread alias="L2">L2_Rate</thread>
<thread alias="EF">EF_Rate</thread>
</threads>
<plotpage>
<title>Plots</title>
<plot>
<title>Plot 1</title>
<trend>
<thread>0</thread>
<x>total</x>
<y>input</y>
</trend>
<trend>
<thread>1</thread>
<x>total</x>
<y>input</y>
</trend>
</plot>
</plotpage>
</settings>