0d9d0d179cd5d48bfd614d1e79c3224400817f72
[u/mrichter/AliRoot.git] / MUON / READMErec.txt
1 // $Id$
2
3 /*! 
4
5 \page README_rec Reconstruction
6  
7 The reconstruction is a multistage process, driven by the AliMUONReconstructor class :
8
9 - We read the RAW data, convert them (convert them back for simulated data) to 
10 AliMUONDigit. Performed by AliMUONDigitMaker. 
11 - We calibrate the digits, by subtracting pedestals and multiplying by gains. Performed
12  by AliMUONDigitCalibrator. Calibrated digits might be saved (back) to TreeD.
13 - We make clusters by associating digits, producing AliMUONRawCluster objects that end up
14   in TreeR of MUON.RecPoints#.root file(s). Steered by AliMUONClusterReconstructor. @ref AliMUONVClusterFinder "More..."
15
16 Part of the reconstruction, but not really steered by AliMUONReconstructor, is the
17  last stage, the tracking, i.e. associating clusters to form tracks. Steered by AliMUONTracker.
18  Producing AliMUONTrack objects that end up in TreeT of MUON.Tracks#.root and AliESDMuonTrack objects
19 that end up in the ESD (Event Summary Data), AliESDs.root file. @ref AliMUONVTrackReconstructor "More..."
20
21
22 \section rec_s1 How to tune the muon reconstruction
23
24 Several options and adjustable parameters allow to tune the entire reconstruction.
25 These can be changed by adding the following lines in the reconstruction macro (@ref runReconstruction.C) :
26
27 <pre>
28   AliMUONRecoParam *muonRecoParam = AliMUONRecoParam::GetLow(High)FluxParam();
29   muonRecoParam->Use...();
30   muonRecoParam->Set...();
31   ...
32   AliRecoParam::Instance()->RegisterRecoParam(muonRecoParam);
33 </pre>
34
35 Have a look at @ref AliMUONRecoParam for the complete list
36 of options/parameters with their purpose.
37
38
39 \section rec_s2 How to convert MUON digit/cluster/track into ESD pad/cluster/track and vice versa
40
41 The class @ref AliMUONESDInterface is doing the job.
42 There are 2 ways of using this class:
43 1) using the static methods to convert the objects one by one (and possibly put them
44    into the provided store).
45 2) loading an entire ESDEvent and using the getters and/or the iterators
46    to access the corresponding MUON objects.
47 Note: You can change (via static method) the type of the store this class is using.
48
49 This chapter is defined in the READMErec.txt file.
50
51 */