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