Update of the content
[u/mrichter/AliRoot.git] / MUON / READMEmtrda.txt
index 7f62b125dda87609114bc072e2f0a7b1cbb72538..b138c2cff403f097847aa70d61e0af0868a0a8d2 100644 (file)
@@ -4,13 +4,18 @@
 
 \page README_mtrda Trigger DA
  
-The detector algorithm is implemented for the Muon Trigger in the AliRoot framework.
-The main code is located in MUONTRGda.cxx and it runs in the MUON Trigger MON (monitoring).
+The detector algorithm is implemented for the Muon Trigger in the AliRoot 
+framework. The main code is located in MUONTRGda.cxx and it runs in the MUON 
+Trigger MON (monitoring).
 
 \section da_s1 The Muon Trigger Calibration
 
-The main goal of the DA is the transfer of the modified configuration files to the FES and to put them in the
-detector data base. In the current version the DA will modify the global crate configuration only (new).
+The main goal of the DA is to transfer the configuration files from the detector
+data base to the FES and to put them back to the detector data base in order to be
+used for the next run, in the case when the analysis of the events in the run finds 
+noisy/dead channels different from the ones already notified in the configuration 
+files at the start of the run. 
+In the current version, the DA will modify only the global crate configuration.
 
 The configuration files stored in the online DB are the following:
 
@@ -18,71 +23,66 @@ The configuration files stored in the online DB are the following:
 - MtgRegionalCrate-<version>.dat: contains the regional crate information
 - MtgLocalMask-<version>.dat:     contains the local mask
 - MtgLocalLut-<version>.dat:      contains the local LUT 
-- MtgCurrent.dat:                 contains the name list of the above files with their version 
-                                  and the flag for master/slave status on the DA
+- MtgCurrent.dat:                 contains the name list of the above files with 
+                                  their version and the flag for master/slave
+                                  status of the DA
+- DAConfig.dat                    configurable parameters for the DA
 
-The copy onto the FES for the modified local masks is only done when the flag is set to master for the DA.
-The DA creates a file (ExportedFiles.dat) containing the name of the files to be transfered by the shuttle.
-To be able to check the change of version of one the files, another file is created containing the last current
-list of configuration files: MtgLastCurrent.dat.
-The Muon trigger electronics could run with two types of calibration. New: the two types can be done in the same
-run containing a mixture of physics events with calibration events injected every 50 seconds.
+The copy onto the FES for the modified global masks is done for any value of 
+the flag master/slave. The DA creates a file (ExportedFiles.dat) containing the 
+name of the files to be transfered by the shuttle. To be able to check the change 
+of version of one the files, another file is created containing the last current
+list of configuration files: MtgLastCurrent.dat. The Muon trigger electronics can 
+run with two types of calibration. The two types of analysis can be done in the same
+run containing a mixture of physics events and calibration events.
 
-\subsection da_ss1  ELECTRONICS_CALIBRATION_RUN (calib)
+The SHUTTLE will process the files stored on the FES only in the PHYSICS mode. In STANDALONE
+mode the DA will work too, updating the files in the detector data base, but the SHUTTLE will
+not process them into the offline data base.
 
-This procedure allows to check dead channels. The FET pulses are injected to the 21 kchannels.
+\subsection da_ss1  Dead channels in the global trigger input (with CALIBRATION_EVENT)
 
-The typical ECS sequence for calib is :
+The FET pulses are injected to the 21 kchannels.
 
-- Switch ON the electronics LV
-- Load Configuration via the MTS package
-- Enable FET pulse 
+- The FET mode in MtgGlobalCrate.dat must be set to 0x3
 - Data taking (typically 1000 events)
-- The DA computes the occupancy of the global input entries, if a channel is not responding in N% of the case 
-  (10% by default), it will be marked as dead 
-- The DA updates the global mask file accordingly, adds the file to the data base and on the the File Exchange 
-  Server at the beginning of the next run. 
+- The DA computes the occupancy of the global input entries, if a channel is not 
+responding in more than N% of the events (10% by default), it will be marked as dead 
+- The DA updates the global mask file accordingly, adds the file to the data base 
+and on the File Exchange Server at the beginning of the next run. 
 
-Then the SHUTTLE process the ASCII files and store the configuration on the OCDB
+\subsection da_ss2  Noisy channels in global trigger input (with PHYSICS_EVENT)
 
-\subsection da_ss2  DETECTOR_CALIBRATION_RUN (ped)
+This events are used to check the noisy channels triggering at a rate which is 
+significantly higher than the expected rate from normal physics events.
 
-This procedure checks the noisy channels. A normal physics run is performed.
-
-The typical ECS sequence for calibration is :
-
-- Switch ON the electronics LV
-- Load Configuration via the MTS package
 - Data taking (typically 1000 events)
-- The DA computes the occupancy of the global input entries, if a channel is responding in N% of the case (90% 
-  by default), it will be marked as noisy
-- The DA updates the global mask file accordingly, adds the file to the data base and on the the File Exchange 
-  Server at the beginning of the next run. 
+- The DA computes the occupancy of the global input entries, if a channel is 
+responding in more than N% of the events (10% by default), it will be marked as 
+noisy
+- The DA updates the global mask file accordingly, adds the file to the data base 
+and on the the File Exchange Server at the beginning of the next run. 
 
-Then the SHUTTLE process the ASCII files and store the configuration on the OCDB
-
-\section da_s2 Using the DA Online
+\subsection da_ss3 Mixed events (PHYSICS+CALIBRATION)
 
-You have a line command help. To have it just type :
+- If the FET mode in MtgGlobalCrate is not set to 0x3, only PHYSICS events will be used to check for
+the noisy channels
+- The algorithm is selected according to the event type returned by the raw reader 
 
-\verbatim
-> MUONTRGda.exe -h
-
-******************* MUONTRGda.exe usage **********************
-MUONTRGda.exe -options, the available options are :
--h help                   (this screen)
-
- Input
--f <raw data file>        (default = )
+\section da_s2 Using the DA Online
 
- Options
--t <threshold values>     (default = 0.1)
--d <print level>          (default = 0)
--s <skip events>          (default = 0)
--n <max events>           (default = 1000000)
+With the help of the Control Panel a configuration file is added to the database
+(DAConfig.dat) which contains parameters for running the DA (typical values are shown):
 
-\endverbatim
+- the thresholds for calculating noisy/dead inputs (0.1/0.9)
+- the minimum number of events necessary for calculating the input rates (10)
+- the maximum number of events to be analyzed in one DA execution (1000000)
+- the number of events to skip from the start of run (0)
+- the verbosity level of the DA (0, minimum of messages, 1 more messages, 2 print every event)
+- enable warnings from the raw data decoder (0, do not show warnings)
+- switch between slow/fast payload decoder (0, use the slow decoder)
 
+This file it is not "version"-ed, so it will be not recorded in MtgCurrent.dat.
  
 \section da_s3 In case of trouble