Main changes:
[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 da_s1 The Muon Trigger Calibration
12
13 The main goal of the DA is the transfer of the modified configuration files to 
14 the FES and to put them in the detector data base. In the current version, the 
15 DA will modify only the global crate configuration.
16
17 The configuration files stored in the online DB are the following:
18
19 - MtgGlobalCrate-<version>.dat:   contains the global crate information
20 - MtgRegionalCrate-<version>.dat: contains the regional crate information
21 - MtgLocalMask-<version>.dat:     contains the local mask
22 - MtgLocalLut-<version>.dat:      contains the local LUT 
23 - MtgCurrent.dat:                 contains the name list of the above files with their version 
24                                   and the flag for master/slave status on the DA
25
26 The copy onto the FES for the modified global masks is only done for any value of 
27 the flag master/slave. The DA creates a file (ExportedFiles.dat) containing the 
28 name of the files to be transfered by the shuttle. To be able to check the change 
29 of version of one the files, another file is created containing the last current
30 list of configuration files: MtgLastCurrent.dat. The Muon trigger electronics can 
31 run with two types of calibration. New: the two types can be done in the same
32 run containing a mixture of physics events with calibration events injected every 
33 50 seconds.
34
35 \subsection da_ss1  ELECTRONICS_CALIBRATION_RUN (calibration)
36
37 This procedure allows to check dead channels. The FET pulses are injected to the 21 kchannels.
38
39 The typical ECS sequence for calib is :
40
41 - Switch ON the electronics LV
42 - Load Configuration via the MTS package
43 - Enable FET pulse 
44 - Data taking (typically 1000 events)
45 - The DA computes the occupancy of the global input entries, if a channel is not 
46 responding in more than N% of the events (10% by default), it will be marked as dead 
47 - The DA updates the global mask file accordingly, adds the file to the data base 
48 and on the the File Exchange Server at the beginning of the next run. 
49
50 Then the SHUTTLE process the ASCII files and store the configuration on the OCDB
51
52 \subsection da_ss2  DETECTOR_CALIBRATION_RUN (pedestal)
53
54 This procedure checks the noisy channels. Normal physics events are used.
55
56 The typical ECS sequence for calibration is :
57
58 - Switch ON the electronics LV
59 - Load Configuration via the MTS package
60 - Data taking (typically 1000 events)
61 - The DA computes the occupancy of the global input entries, if a channel is 
62 responding in more than N% of the events (10% by default), it will be marked as 
63 noisy
64 - The DA updates the global mask file accordingly, adds the file to the data base 
65 and on the the File Exchange Server at the beginning of the next run. 
66
67 Then the SHUTTLE process the ASCII files and store the configuration on the OCDB
68
69 \section da_s2 Using the DA Online
70
71 You have a line command help. To have it just type :
72
73 \verbatim
74 > MUONTRGda.exe -h
75
76 ******************* MUONTRGda.exe usage **********************
77 MUONTRGda.exe -options, the available options are :
78 -h help                   (this screen)
79
80  Input
81 -f <raw data file>
82
83  Output
84
85  Options
86 -p <thr value ped (deadc)> (default = 0.1)
87 -c <thr value cal (noise)> (default = 0.1)
88 -l <print level>           (default = 0)
89 -s <skip events>           (default = 0)
90 -n <max events>            (default = 1000000)
91 -w <decoder warnings>      (default = 0)
92
93 \endverbatim
94
95  
96 \section da_s3 In case of trouble
97
98 Please contact:
99
100 Franck Manso: manson@clermont.in2p3.fr
101
102 or 
103
104 Bogdan Vulpescu: vulpescu@clermont.in2p3.fr
105
106 This chapter is defined in the READMEmtrda.txt file.
107 */
108