TriggerRateTool

What is the Trigger Rate Tool?

The Trigger Rate Tool is designed to allow checks on the trigger rate offline, i.e. requesting a particular run from the past. For the moment it just shows the selected triggers as a function of the LB, allowing trigger experts to flag each LB properly.

Where to find it

The latest version (v.2 for the moment) of the tool can be found on lxplus in this folder /afs/cern.ch/user/g/gartoni/public/Trigger_Rate_Tool.
All previous versions will be maintained in this folder instead /afs/cern.ch/user/g/gartoni/public/Trigger_Rate_Tool/Old_Versions.

Running the tool

For the moment the tool is simply a root macro and all you need to do in order to launch it is the following:

> root
> .L trig_rate_tool_v2.C
> trig_rate_tool("working mode","run number","string containing desired triggers")

Choosing the working mode

In order for this tool to work, it needs to read the Trigger Presenter files; once launched, it will automatically look for the correct file in the local directory or in /tmp. In case you don't have the file on your computer, the tool will behave accordingly to the working mode you have chosen. The possibilities are:

Working locally

You can tell the tool to download the file from the web using the command wget; the file will be placed in your /tmp directory and it can be used multiple times by the tool. To obtain this all you need to do is set the "working mode" option to "local".

Reading the file via http protocol

In case you don't want to download the file, you can simply read it through the web each time you use the tool; in this case the "working mode" option should be set to "http" (notice that this usage of the tool can be slower than the other).

Selecting the triggers

The tool allows you to see the trigger rates normalized with luminosity taken from mbts; in addition to this you can see the ratio between different triggers.
You must specify each trigger you'd like to see and separate them with a colon :; in case you want a ratio between two triggers, you need to write

"Trigger 1/Trigger 2"

.
Let's say you want to see the trigger rate for L1_MU0_TAP, L2_mu4_input, L2_mu6_input and L2_mu10_input and the ratios L2_mu4_input/L2_mu6_input and L2_mu4_input/L2_mu10_input on run 142195; you will need to call the tool with these options:

trig_rate_tool("local","142195","L2_mu4_input:L2_mu6_input:L1_MU0_TAP:L2_mu10_input:L2_mu4_input/L2_mu6_input:L2_mu4_input/L2_mu10_input")

The output of the tool will be:

For any question, idea or improvement, send me a mail: Giacomo.Artoni@cernNOSPAMPLEASE.ch

-- GiacomoArtoni - 04-Feb-2010