Project

General

Profile

Adding Triggers » History » Version 6

Andrew Norman, 11/21/2014 10:09 AM

1 2 Andrew Norman
h1. Adding/Updating Triggers
2 2 Andrew Norman
3 2 Andrew Norman
Adding new triggers to the DAQ systems is easy but can have dire consequences if done improperly and can impact the ability of the experiment to collect data.  The following procedures are the MINIMUM set of requirements that need to be met before a trigger is added to the system.  In many cases, authors of triggers will be asked to perform additional studies and provide additional supporting documentation.
4 2 Andrew Norman
5 2 Andrew Norman
h2. All Trigger Changes
6 2 Andrew Norman
7 2 Andrew Norman
All trigger changes are required to be accompanied by the following supporting information and documentation.
8 2 Andrew Norman
9 2 Andrew Norman
# Technical Note stored in Nova-DocDB describing in detail the trigger.  This should include the physics motivation for the trigger, description of the algorithms and flow of the trigger logic, plots detailing the performance of the selection.
10 2 Andrew Norman
# Projected rates (decisions issued and bandwidth) for the trigger determined by using recent zero-bias 5 ms readout data from the detector/detectors on which the trigger will run.
11 2 Andrew Norman
## Rates must be presented as a function of tunable parameters in the algorithms
12 2 Andrew Norman
## Rates must be presented in Hertz
13 2 Andrew Norman
## Rates must include the data bandwidth (i.e. rate * event size) 
14 2 Andrew Norman
# Efficiency projects for the trigger determined by using recent Monte Carlo simulations of the detector/detectors on which the trigger will run and based off of the processes the trigger is designed to detect.
15 2 Andrew Norman
## Efficiencies must be presented as a function of tunable parameters in the algorithms
16 2 Andrew Norman
# Purity projections for the trigger determined by using recent Monte Carlo background simulation or (as appropriate) zero bias data from the detector/detectors that the trigger will run on.
17 2 Andrew Norman
## Purities must be presented as a function of tunable parameters in the algorithms
18 2 Andrew Norman
19 2 Andrew Norman
h2. New Triggers
20 2 Andrew Norman
21 3 Andrew Norman
New triggers require additional infrastructure/configurations to be added to the DAQ.  The following are the steps that need to be taken to enable a new trigger:
22 3 Andrew Norman
23 3 Andrew Norman
# An entry/entries must be allocated in the trigger tables for the trigger
24 3 Andrew Norman
## Contact A.Norman (anorman@fnal.gov) for trigger allocations and assignments
25 4 Andrew Norman
## The @daqdataformats@ library within the DAQ must be updated and rebuilt
26 4 Andrew Norman
### Entries must be made in @TriggerDefines.h@
27 4 Andrew Norman
### Entries must be made in @TriggerDefines.cpp@
28 4 Andrew Norman
## The Global trigger must be made aware of the new trigger
29 4 Andrew Norman
### Entries in the @GtDataTrig.cpp@ for @TrigNameMap@ and @ValidTrigTypes@
30 5 Andrew Norman
### The Global trigger must be rebuilt
31 5 Andrew Norman
## Add configuration entries into the global trigger corresponding to the trigger
32 5 Andrew Norman
### Include prescale values
33 5 Andrew Norman
### Include throttle values
34 6 Andrew Norman
## An entry should be added to the Trigger Scalar configuration files for the detector configurations where your trigger will run.  It should include the nominal trigger rate envelopes.
35 6 Andrew Norman
### Update the entries corresponding to the total trigger rates to reflect new projected system rates.
36 1 Andrew Norman
37 1 Andrew Norman
38 1 Andrew Norman
h2. Existing Triggers
39 6 Andrew Norman
40 6 Andrew Norman
Existing triggers that require a change (algorithm or configuration) must follow the following steps:
41 6 Andrew Norman
42 6 Andrew Norman
## Update configuration entries into the global trigger corresponding to the trigger
43 6 Andrew Norman
### Include prescale values
44 6 Andrew Norman
### Include throttle values
45 6 Andrew Norman
## Update the Trigger Scalar configuration files for the detector configurations where your trigger will run to reflect the nominal trigger rate envelopes.
46 6 Andrew Norman
### Update the entries corresponding to the total trigger rates to reflect new projected system rates.