]>
Commit | Line | Data |
---|---|---|
1 | // $Id$ | |
2 | ||
3 | /*! | |
4 | ||
5 | \page README_mtrda Trigger DA | |
6 | ||
7 | The detector algorithm is implemented for the Muon Trigger in the AliRoot | |
8 | framework. The main code is located in MUONTRGda.cxx and it runs in the MUON | |
9 | Trigger MON (monitoring). | |
10 | ||
11 | \section mtrda_s1 The Muon Trigger Calibration | |
12 | ||
13 | The main goal of the DA is to transfer the configuration files from the detector | |
14 | data base to the FES and to put them back to the detector data base in order to be | |
15 | used for the next run, in the case when the analysis of the events in the run finds | |
16 | noisy/dead channels different from the ones already notified in the configuration | |
17 | files at the start of the run. | |
18 | In the current version, the DA will modify only the global crate configuration. | |
19 | ||
20 | The configuration files stored in the online DB are the following: | |
21 | ||
22 | - MtgGlobalCrate-[version].dat: contains the global crate information | |
23 | - MtgRegionalCrate-[version].dat: contains the regional crate information | |
24 | - MtgLocalMask-[version].dat: contains the local mask | |
25 | - MtgLocalLut-[version].dat: contains the local LUT | |
26 | - MtgCurrent.dat: contains the name list of the above files with | |
27 | their version and the flag for master/slave | |
28 | status of the DA | |
29 | - DAConfig.dat configurable parameters for the DA | |
30 | ||
31 | The copy onto the FES for the modified global masks is done for any value of | |
32 | the flag master/slave. The DA creates a file (ExportedFiles.dat) containing the | |
33 | name of the files to be transfered by the shuttle. To be able to check the change | |
34 | of version of one the files, another file is created containing the last current | |
35 | list of configuration files: MtgLastCurrent.dat. The Muon trigger electronics can | |
36 | run with two types of calibration. The two types of analysis can be done in the same | |
37 | run containing a mixture of physics events and calibration events. | |
38 | ||
39 | The SHUTTLE will process the files stored on the FES only in the PHYSICS mode. In STANDALONE | |
40 | mode the DA will work too, updating the files in the detector data base, but the SHUTTLE will | |
41 | not process them into the offline data base. | |
42 | ||
43 | \subsection mtrda_ss1 Dead channels in the global trigger input (with CALIBRATION_EVENT) | |
44 | ||
45 | The FET pulses are injected to the 21 kchannels. | |
46 | ||
47 | - The FET mode in MtgGlobalCrate.dat must be set to 0x3 | |
48 | - Data taking (typically 1000 events) | |
49 | - The DA computes the occupancy of the global input entries, if a channel is not | |
50 | responding in more than N% of the events (10% by default), it will be marked as dead | |
51 | - The DA updates the global mask file accordingly, adds the file to the data base | |
52 | and on the File Exchange Server at the beginning of the next run. | |
53 | ||
54 | \subsection mtrda_ss2 Noisy channels in global trigger input (with PHYSICS_EVENT) | |
55 | ||
56 | This events are used to check the noisy channels triggering at a rate which is | |
57 | significantly higher than the expected rate from normal physics events. | |
58 | ||
59 | - Data taking (typically 1000 events) | |
60 | - The DA computes the occupancy of the global input entries, if a channel is | |
61 | responding in more than N% of the events (10% by default), it will be marked as | |
62 | noisy | |
63 | - The DA updates the global mask file accordingly, adds the file to the data base | |
64 | and on the the File Exchange Server at the beginning of the next run. | |
65 | ||
66 | \subsection mtrda_ss3 Mixed events (PHYSICS+CALIBRATION) | |
67 | ||
68 | - If the FET mode in MtgGlobalCrate is not set to 0x3, only PHYSICS events will be used to check for | |
69 | the noisy channels | |
70 | - The algorithm is selected according to the event type returned by the raw reader | |
71 | ||
72 | \section mtrda_s2 Using the DA Online | |
73 | ||
74 | With the help of the Control Panel a configuration file is added to the database | |
75 | (DAConfig.dat) which contains parameters for running the DA (typical values are shown): | |
76 | ||
77 | - the thresholds for calculating noisy/dead inputs (0.1/0.9) | |
78 | - the minimum number of events necessary for calculating the input rates (10) | |
79 | - the maximum number of events to be analyzed in one DA execution (1000000) | |
80 | - the number of events to skip from the start of run (0) | |
81 | - the verbosity level of the DA (0, minimum of messages, 1 more messages, 2 print every event) | |
82 | - enable warnings from the raw data decoder (0, do not show warnings) | |
83 | - switch between slow/fast payload decoder (0, use the slow decoder) | |
84 | ||
85 | This file it is not "version"-ed, so it will be not recorded in MtgCurrent.dat. | |
86 | ||
87 | Test configuration files: | |
88 | ||
89 | - <a href="http://aliceinfo.cern.ch/static/Offline/dimuon/data/DAConfig.dat"> DAConfig.dat </a> | |
90 | - <a href="http://aliceinfo.cern.ch/static/Offline/dimuon/data/MtgGlobalCrate-1.dat"> MtgGlobalCrate-1.dat </a> | |
91 | - <a href="http://aliceinfo.cern.ch/static/Offline/dimuon/data/MtgRegionalCrate-1.dat">MtgRegionalCrate-1.dat </a> | |
92 | - <a href="http://aliceinfo.cern.ch/static/Offline/dimuon/data/MtgLocalMask-1.dat"> MtgLocalMask-1.dat </a> | |
93 | - <a href="http://aliceinfo.cern.ch/static/Offline/dimuon/data/MtgLocalLut-1.dat"> MtgLocalLut-1.dat </a> | |
94 | - <a href="http://aliceinfo.cern.ch/static/Offline/dimuon/data/MtgSignature-1.dat"> MtgSignature-1.dat </a> | |
95 | - <a href="http://aliceinfo.cern.ch/static/Offline/dimuon/data/MtgCurrent.dat"> MtgCurrent.dat </a> | |
96 | ||
97 | \section mtrda_s3 In case of trouble | |
98 | ||
99 | Please contact: | |
100 | ||
101 | Franck Manso: manson@clermont.in2p3.fr | |
102 | ||
103 | or | |
104 | ||
105 | Bogdan Vulpescu: vulpescu@clermont.in2p3.fr | |
106 | ||
107 | This chapter is defined in the READMEmtrda.txt file. | |
108 | */ | |
109 |