- Disentangle masks effect from trigger chamber efficiency estimation.
[u/mrichter/AliRoot.git] / MUON / READMEcosmics.txt
CommitLineData
e3a26974 1// $Id$
2
3/*! \page README_cosmics The Software testing on Cosmics Test Data
4
5
6Seeveral macros has been developed during the Offline shifts
7during the Feb-March 2008 cosmics runs. On this page we summarize
8how to use these macros.
9
10\section cosmics_s1 Software installation
11
12- For installing AliRoot see ALICE Offline Installation Web page at
13http://aliceinfo.cern.ch/Offline/AliRoot/Installation.html
14
15- and for installing alien see ALICE Offline Tutorial, slides 131 - 145 at
16http://aliceinfo.cern.ch/Offline/Analysis/Tutorial
17
18If we need a fast fix, it may be provided via a patch.txt file,
19which 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
25Eventually, we may get in situation when an important update of the MUON code
26is not yet included in the release, and we may then need to replace the MUON
27from 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
37During the offline shifts, there has been added a a new macro
38runDataReconstruction.C. You have first to edit the macro and change
39the value of <em>input</em> with the path to raw data file
40which you want to reconstruct. Then you prepare an output directory
41and 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
53This will run reconstruction with the first calibration option
54selected ("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
66The new macro MUONOfflineShift.C will process the data
67and generate the Root output file which can be then open with
68the \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
83There has been added a new macro TestRecPoints.C.
84
85The analysis of the trigger part needs only RecPoints: the digits are then re-created
86out of the local trigger information. The analysis of the tracker part needs the
87MUON.Digits, which can be created during reconstruction with the "SAVEDIGITS" option.
88(This option is switched on by default in the runDataReconstruction.C macro.)
89The macro, then, performs the clusterization on the fly and analyses data.
90This was necessary since, normally, the clusters are saved in the AliESDs.root
91but only for reconstructed tracks (which I guess will be very few in the cosmic run).
92Re-performing clusterization is surely more time expensive, but (I guess) is the
93only way to get information on all clusters even when no track is created.
94
95To 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
102It is also possible to check only tracker:
103<pre> root[1] TestRecPoints("pathToData","outputDirectory",kOnlyTracker);
104</pre>
105
106or only the trigger
107<pre> root[0] TestRecPoints("pathToData","outputDirectory",kOnlyTrigger);
108</pre>
109
110\section cosmics_s5 Event display
111
112See EVE/README_MUON.
113
114This chapter is defined in the READMEcosmics.txt file.
115
116*/