new functionality and new class added
[u/mrichter/AliRoot.git] / MUON / READMEcalign.txt
1 // $Id$
2
3 /*! 
4
5 \page README_calign Offline Calibration and Alignment
6  
7 \section calign_s1 Offline monitoring of the Alignment and Calibration
8
9 The macro MUONClusterInfo.C reads the ESDs or RecPoints and creates a tree of 
10 AliMUONClusterInfo objects which can be conveniently used to plot track to 
11 cluster residuals, cluster and pads properties.
12
13 Usage:
14 <pre>
15 root [0] .L $ALICE_ROOT/MUON/MUONClusterInfo.C+
16 root [1] MUONClusterInfo(nevents, esdFileName, inFileName, outFileName); 
17 </pre>
18
19  1) <code> if ( esdFileName != "" ) </code>: 
20
21  Loop over ESD event and fill AliMUONClusterInfo object with cluster + 
22  corresponding track parameters.
23
24  2) <code> if ( inFileName != "" ) </code>:
25   
26  Loop over RecPoints and fill AliMUONClusterInfo object with cluster not 
27  attached to a track;
28
29  3) Write results in a new root file.
30
31 \section calign_s2 How to run offline calibration and alignment tasks
32
33 AliMUONAlignmentTask:
34  
35 It is an AliAnalysisTask to align the MUON spectrometer. The Task reads 
36 as input ESDs and feeds the MUONTracks to AliMUONAlignment. The alignment 
37 itself is performed by AliMillepede. A OCDB entry is written with the 
38 alignment parameters. A list of graph are written to monitor the alignment 
39 parameters. 
40
41 AliMUONReAlignTask:
42
43 It is an AliAnalysisTask to realign the MUON spectrometer. The Task reads 
44 as input ESDs moves the clusters of a MUONTrack acoording to the re aligned 
45 geometry taken from a misalignment file in the OCDB and refit the track. 
46 Then it produces a AliMUONClusterInfo object for each cluster. The output is 
47 a TTree of AliMUONClusterInfo.
48
49 AliMUONChamberCalibrationTask:
50
51 It is a AliAnalysisTaskSE to recalibrate the MUON spectrometers. The output is 
52 a TTree of AliMUONClusterInfo. 
53
54
55 The AliMUON*Task are designed to run in an analyis train of the Analysis 
56 Framework. The macros AddTaskMuon*.C can be used to add the task to an 
57 analysis train. An usage example based on the new standard AnalysisTrainNew.C 
58 will be provided soon. 
59
60
61 This chapter is defined in the READMEcalign.txt file.
62
63 */