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 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 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 With the help of the Control Panel a configuration file is added to the database
  72 (DAConfig.txt) which contains parameters for running the DA:
  73
  74 - the thresholds for calculating noisy/dead inputs
  75 - the minimum number of events necessary for calculating the input rates
  76 - the maximum number of events to be analyzed in one DA execution
  77 - the number of events to skip from the start of run
  78 - the verbosity level of the DA
  79 - enable warnings from the raw data decoder
  80
  81 This file it is not "version"-ed, so it will be not recorded in MtgCurrent.dat.
  82
  83 \section da_s3 In case of trouble
  84
  85 Please contact:
  86
  87 Franck Manso: manson@clermont.in2p3.fr
  88
  89 or
  90
  91 Bogdan Vulpescu: vulpescu@clermont.in2p3.fr
  92
  93 This chapter is defined in the READMEmtrda.txt file.
  94 */
  95