Always delete TObjArrays created by TString::Tokenize (Ruben)
[u/mrichter/AliRoot.git] / MUON / READMEcosmics.txt
1 // $Id$
2
3 /*! \page README_cosmics The Software testing on Cosmics Test Data
4
5
6 Seeveral macros has been developed during the Offline shifts
7 during the Feb-March 2008 cosmics runs. On this page we summarize
8 how to use these macros.
9
10 \section cosmics_s1 Software installation    
11
12 - For installing AliRoot see ALICE Offline Installation Web page at
13 http://aliceinfo.cern.ch/Offline/AliRoot/Installation.html
14
15 - and for installing alien see ALICE Offline Tutorial, slides 131 - 145 at
16 http://aliceinfo.cern.ch/Offline/Analysis/Tutorial
17
18 If we need a fast fix, it may be provided via a patch.txt file,
19 which should be then applied in this way: 
20 <pre> $&gt; cd $ALICE_ROOT
21  $&gt; patch -p0 --posix &lt; patch.txt
22  $&gt; make
23 </pre>
24
25 Eventually, we may get in situation when an important update of the MUON code 
26 is not yet included in the release, and we may then need to replace the MUON
27 from the release with the MUON from the trunk:
28 <pre> $&gt; cd $ALICE_ROOT
29  $&gt; mv MUON MUON.release
30  $&gt; svn co http://alisoft.cern.ch/AliRoot/trunk/MUON MUON
31  $&gt; rm -fr $ALICE_ROOT/lib/tgt_$ALICE_TARGET/libMUON*
32  $&gt; make
33 </pre>
34
35 \section cosmics_s2 Running reconstruction   
36
37 During the offline shifts, there has been added a a new macro 
38 runDataReconstruction.C. You have first to edit the macro and change
39 the value of <em>input</em> with the path to raw data file
40 which you want to reconstruct. Then you prepare an output directory
41 and run reconstruction in this way:
42
43 <pre> $&gt; alien-token-int
44  $&gt; . /tmp/gclient_env_$UID
45  $&gt; cd $ALICE_ROOT/MUON
46  $&gt; mkdir runXYZ_c1_out
47  $&gt; cp rootlogon.C .rootrc runDataReconstruction.C runXYZ_c1_out
48  $&gt; cd runXYZ_c1_out
49  $&gt; root
50  root[0] .x runDataReconstruction.C(1) &gt;&amp; runReco.out
51 </pre>
52
53 This will run reconstruction with the first calibration option
54 selected ("NOGAIN"); to run the same with the second calibration option
55 ("GAINCONSTANTCAPA"):
56 <pre> $&gt; cd $ALICE_ROOT/MUON
57  $&gt; mkdir runXYZ_c2_out
58  $&gt; cp rootlogon.C .rootrc runDataReconstruction.C runXYZ_c2_out
59  $&gt; cd runXYZ_c2_out
60  $&gt; root
61  root[0] .x runDataReconstruction.C(2) &gt;&amp; runReco.out
62  </pre>
63
64 \section cosmics_s3 Inspecting data with mchview
65
66 The new macro MUONOfflineShift.C will process the data
67 and generate the Root output file which can be then open with
68 the \em mchview program:
69
70 <pre> $&gt; alien-token-int
71  $&gt; . /tmp/gclient_env_$UID
72  $&gt; cd $ALICE_ROOT/MUON
73  root[0] .L MUONOfflineShift.C+
74  root[1] MUONOfflineShift("path_to_raw_file","basename of output file");
75  .q
76  
77  $&gt; mchview --use basename.root
78 </pre>
79     
80
81 \section cosmics_s4 Inspecting rec points
82
83 There has been added a new macro TestRecPoints.C.
84
85 The analysis of the trigger part needs only RecPoints: the digits are then re-created 
86 out of the local trigger information. The analysis of the tracker part needs the 
87 MUON.Digits, which can be created during reconstruction with the "SAVEDIGITS" option. 
88 (This option is switched on by default in the runDataReconstruction.C macro.)
89 The macro, then, performs the clusterization on the fly and analyses data.
90 This was necessary since, normally, the clusters are saved in the AliESDs.root 
91 but only for reconstructed tracks (which I guess will be very few in the cosmic run). 
92 Re-performing clusterization is surely more time expensive, but (I guess) is the 
93 only way to get information on all clusters even when no track is created.
94
95 To use the macro: 
96 <pre> $&gt; cd $ALICE_ROOT/MUON
97  $&gt; root
98  root[0] .L TestRecPoints.C+
99  root[1] TestRecPoints(runXYZ_c1);
100 </pre>
101
102 It is also possible to check only tracker:
103 <pre> root[1] TestRecPoints("pathToData","outputDirectory",kOnlyTracker);
104 </pre>
105
106 or only the trigger
107 <pre> root[0] TestRecPoints("pathToData","outputDirectory",kOnlyTrigger);
108 </pre>
109     
110 \section cosmics_s5 Event display
111
112 See EVE/README_MUON. 
113
114 This chapter is defined in the READMEcosmics.txt file.
115
116 */