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