Always delete TObjArrays created by TString::Tokenize (Ruben)
[u/mrichter/AliRoot.git] / MUON / READMEmtrda.txt
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