bcc784e3c08603b16fde043b34c56505cfff52d1
[u/mrichter/AliRoot.git] / MUON / README
1 /**************************************************************************
2  * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
3  *                                                                        *
4  * Author: The ALICE Off-line Project.                                    *
5  * Contributors are mentioned in the code where appropriate.              *
6  *                                                                        *
7  * Permission to use, copy, modify and distribute this software and its   *
8  * documentation strictly for non-commercial purposes is hereby granted   *
9  * without fee, provided that the above copyright notice appears in all   *
10  * copies and that both the copyright notice and this permission notice   *
11  * appear in the supporting documentation. The authors make no claims     *
12  * about the suitability of this software for any purpose. It is          *
13  * provided "as is" without express or implied warranty.                  *
14  **************************************************************************/
15
16 /* $Id$ */
17
18 ==========================================================
19 Please add  to this README file all information concerning 
20 config files, simulation, digitalization, clusterization, 
21 reconstruction and macro analysis
22
23 ==========================================================
24  How to run a MUON generation
25 ==========================================================
26 aliroot
27 root [0] gAlice->Run(10,"$ALICE_ROOT/MUON/Config_MUON_test.C");
28
29 1 single muon of 7 GeV/c in the MUON spectrometer 
30 acceptance will be simulated using geant3. 
31 Hit information will be store in the root file in the
32 execution directory.
33 If you want to change the option or to define a new directory
34 for hits, you have to do the following before:
35 root [0] gAlice->SetConfigFunction("Config( \"/home/martinez/aliroot/work_NewIO/test/\" , \"box\" );"); 
36
37 ============================================================
38  How to run MUON Digitalization
39 ============================================================
40 To process the digitalization of hits the AliRunDigitizer 
41 framework is used:
42
43 AliRunDigitizer   * manager = new AliRunDigitizer(1,1);
44 manager->SetInputStream(0,"galice.root");
45 AliMUONDigitizerv1* dMUON   = new AliMUONDigitizerv1(manager)
46 manager->AddDigitizer(dMUON);
47 manager->Exec("deb");
48
49 ============================================================
50  How to run MUON RecPoint clusterization
51 ============================================================
52 aliroot -b << EOF
53 .includepath $ALICE_ROOT/STEER
54 .includepath $ALICE_ROOT/MUON
55 .L $ALICE_ROOT/MUON/MUONrawclusters.C++
56 MUONrawclusters("galice.root",0,9999); 
57 to Load
58 gSystem->Load("$ALICE_ROOT/MUON/MUONrawclusters_C.so")
59
60 ============================================================
61  How to run MUON Trigger
62 ============================================================
63 .includepath $ALICE_ROOT/STEER
64 .includepath $ALICE_ROOT/MUON
65 .L $ALICE_ROOT/MUON/MUONtrigger.C++
66 MUONtrigger("galice.root",0,9999); 
67 To Load
68 gSystem->Load("$ALICE_ROOT/MUON/MUONtrigger_C.so")
69 ============================================================
70  How to run MUON Tracking reconstruction (old output)
71 ===========================================================
72 .includepath $ALICE_ROOT/STEER
73 .includepath $ALICE_ROOT/MUON
74 .L $ALICE_ROOT/MUON/MUONrecoNtuple.C++
75 MUONrecoNtuple(0,9999,0,"galice.root") 
76 To Load   
77 gSystem->Load("$ALICE_ROOT/MUON/MUONrecoNtuple_C.so")
78 First event and last event are given by hand, but this will change.
79
80 ===========================================================
81  How to run MUON Tracking reconstruction (new output)
82 ===========================================================
83 .includepath $ALICE_ROOT/STEER
84 .includepath $ALICE_ROOT/MUON
85 .L $ALICE_ROOT/MUON/MUONTracker.C++
86 MUONTracker("galice.root",0,9999);    
87 To Load
88 gSystem->Load("$ALICE_ROOT/MUON/MUONTracker_C.so")
89 Output in MUON.Tracks.root using the new IO 
90 as a TClonesArray of AliMUONTrack
91
92 ============================================================
93  How to run MUONCheck macro
94 ============================================================
95 To check the content of a root data file, the MUONCheck
96 provides a ascii output on screen.
97
98 To compile MUONCheck.C
99 .includepath $ALICE_ROOT/STEER
100 .includepath $ALICE_ROOT/MUON
101 .L $ALICE_ROOT/MUON/MUONCheck.C++
102 To Load
103 gSystem->Load("$ALICE_ROOT/MUON/MUONCheck_C.so")
104
105 To print Kine : (default file is galice.root )
106 MUONkine()
107
108 To print hits : (default file is galice.root if not MUONhits("toto.root""); )
109 MUONhits()  
110
111 To print digits : (default file is galice.root)
112 MUONdigits()  
113
114 To print rawcluster : (default file is galice.root)
115 MUONrecpoints()
116
117 To print trigger : (default file is galice.root)
118 MUONTestTrigger()
119
120
121 ============================================================
122  How to check the Geometry
123 ============================================================
124 gAlice->Init("$ALICE_ROOT/MUON/Config_MUON_test.C");
125 .L $ALICE/geant3/TGeant3/G3GUI.C
126 G3GUI()
127
128
129 ============================================================
130  How to run MUONdisplay
131 ============================================================
132 First you need to perform a full simulation: 
133 generation, digitalisation and clusterisation
134 .L $ALICE_ROOT/MUON/MUONdisplay.C
135 MUONdisplay(0,"galice.root")
136
137 ============================================================
138  Tracking parameters, cuts, energy loss and physics processes
139 ============================================================
140 Tracking parameters in MUON are automatically defined by GEANT
141 MUON takes the default values of CUTs  and physics processes
142 defined by the Config files, except for the gas mixture medium 
143 of the tracking chambers. The CUT's and physics processes of
144 the gas mixture medium  is then defined in the galice.cuts file
145 in the data directory. In particular ILOSS parameter MUST be
146 equal unity (1) in order simulate a realistic energy loss
147 distribution (mean value and fluctuations) in the active gas.
148
149 ============================================================
150  Tracking of particle in the magnetic field
151 ============================================================
152 GEANT has two ways for tracking charged particles in the 
153 magnetic field: HELIX et RKUTA.
154 HELIX is faster and works well if the gradient of magnetic 
155 field is small. 
156 For MUON, HELIX is a not a good approximation and we must 
157 use RKUTA to get the optimal mass resolution of the 
158 spectrometer. The choice of HELIX or RKUTA is done in the
159 config file when the magnetic field is defined:
160   AliMagFMaps* field = new AliMagFMaps("Maps","Maps", TRACKING, FACTOR, MAXB, AliMagFMaps::k4kG);
161   gAlice->SetField(field);
162 TRACKING must be 1 for RKUTA and 2 for HELIX (the default value for aliroot is 2 (HELIX))
163 FACTOR allows you to set the magnetic field to 0, just putting FACTOR=0. Default value is 1.
164 MAXB is the maximum magnetic field which is 10.T
165
166 ===========================================================
167  Still working ..............
168 ===========================================================