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