MUON/READMEmchda.txt

   1 // $Id$
   2
   3 /*!
   4
   5 \page README_mchda Tracking DA
   6
   7 The detector algorithms are implemented for the Muon Tracking in the AliRoot framework.
   8 We currently have 3 DAs for MCH :
   9
  10 - MUONTRKPEDda.cxx for PEDESTAL runs, running at the end of data taking on each LDC.
  11 - MUONTRKGAINda.cxx for CALIBRATION runs, running at the end of data taking on each LDC.
  12 - MUONTRKOCCda.cxx for PHYSICS runs, running during data taking on each LDC.
  13
  14 \section da_s1 The Muon Tracking Calibration
  15
  16 The Muon tracking chambers needs three types of calibration in order to work properly
  17 (to be more precise pedestals are required, gains are needed to get the best charge measurement possible, and the occupancy
  18  is needed in order not to spend all the reconstruction time in hot-spots).
  19
  20 \subsection da_ss1 Pedestals
  21
  22 The front-end electronics performs an online zero suppression using a threshold level.
  23 Those threshold levels for all channels (~ 1 million) have to be computed in a dedicated
  24 PEDESTALS runs. During this runs the zero suppression is OFF and the pedestal level and the noise is obtained for each channel. The threshold for the FEE is obtained adding the pedestal
  25 level to 3 sigmas of the noise.
  26
  27 The typical ECS sequence for pedestals is :
  28
  29 - Switch ON the electronics LV
  30 - Boot the CROCUS
  31 - Configuration
  32 - Zero suppression OFF
  33 - Data taking (typically 400 events)
  34 - The DA computes the mean and sigma (it runs in each LDC)
  35 - The DA writes one ASCII file per LDC with the results in the File Exchange Server
  36
  37 Then the SHUTTLE process the ASCII files and store the result on the OCDB
  38
  39 \subsection da_ss2 Electronics gain
  40
  41 In order to perform the required spatial resolution or the tracking chambers (~ 100 microns),
  42 we need to calibrate the gain of each channel. The gain is computed using dedicated runs where
  43 a signal is send to the chambers FEE.
  44
  45 The typical ECS sequence for calibration is :
  46
  47 - Switch ON the electronics LV
  48 - Boot the CROCUS
  49 - Configuration
  50 - Zero suppression OFF
  51 - Loop of 10 data taking (typically 400 events) each with a different signal
  52 - The DA computes the mean and sigma (it runs in each LDC) for each run
  53 - The DA write one ASCII file per LDC with the results in the File Exchange Server at the
  54 end of the 10 runs sequence
  55
  56 Then the SHUTTLE process the ASCII files and store the result on the OCDB
  57
  58 \subsection da_ss3 Occupancy
  59
  60 For PHYSICS (or STANDALONE) runs, the MUONTRKOCCda, which is a monitoring DA, keep track of how many times
  61  each channel has been hit during the run. The output is an ASCII file containing the needed information to
  62  compute the occupancy values. This file is written to the DAQ FXS so the SHUTTLE can transfer it to 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 > MUONTRKPEDda.exe -h
  70
  71 ******************* ./MUONTRKPEDda.exe usage **********************
  72 ./MUONTRKPEDda.exe -options, the available options are :
  73 -h help                   (this screen)
  74
  75  Input
  76 -f <raw data file>        (default = )
  77
  78  Output
  79 -a <Flat ASCII file>      (default = )
  80
  81  Options
  82 -b <output directory>     (default = .)
  83 -c <FES switch>           (default = 1)
  84 -d <print level>          (default = 1)
  85 -g <plot level>           (default = 0)
  86 -i <nb linear points>     (default = 6)
  87 -l <DAC level>            (default = 0)
  88 -m <max date events>      (default = 1000000)
  89 -s <skip events>          (default = 0)
  90 -n <max events>           (default = 1000000)
  91 -r root file data for gain(default = MUONTRKda_gain.data)
  92 -e <execute ped/gain>     (default = ped)
  93 -e <gain create>           make gain & create a new root file
  94 -e <gain>                  make gain & update root file
  95 -e <gain compute>          make gain & compute gains
  96 \endverbatim
  97
  98
  99 \section da_s3 Using the DA Offline
 100
 101 The DAs normally runs with a RAW data DATE format as input
 102  If you get a file in root format (e.g. from alien), you can de-rootify it using the
 103   "deroot" program which is part of aliroot. Note that PED and GAIN DAs work with ROOT input files as well.
 104
 105 \section da_s4 In case of trouble
 106
 107 Please contact :
 108
 109 Jean-Luc Charvet : jean-luc.charvet@cea.fr
 110 or
 111 Alberto Baldisseri : a.baldisseri@cea.fr
 112 or
 113 Laurent Aphecetche : laurent.aphecetche@subatech.in2p3.fr (for OCC DA)
 114
 115 This chapter is defined in the READMEMchda.txt file.
 116 */
 117