Project

General

Profile

Adding Triggers » History » Version 2

Andrew Norman, 11/21/2014 09:52 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 2 Andrew Norman
New triggers require
22 2 Andrew Norman
23 2 Andrew Norman
h2. Existing Triggers
24 1 Andrew Norman
25 1 Andrew Norman
Adding triggers to the DAQ involves a number of things.  Follow the outline of steps below when adding a new trigger:
26 1 Andrew Norman
27 1 Andrew Norman
# Have a place in the trigger tables allocated for your trigger
28 1 Andrew Norman
# Have the daqdataformats library updated to reflect the allocation (TriggerDefines.h and TriggerDefines.cpp updated)
29 1 Andrew Norman
# Add your trigger to the Global Trigger configuration
30 1 Andrew Norman
# If your trigger is a DDT then make sure there is a handler in the GTData module that supports your trigger
31 1 Andrew Norman
# Add an entry in the TriggerScalars configuration file for your trigger