Coverity fix for uninitialized variables and check for returned null value
[u/mrichter/AliRoot.git] / MUON / READMEeve.txt
CommitLineData
bc694317 1// $Id$
2
3/*!
4
5\page README_eve Event display
6
18f5e673 7This README file shows how to use both the old and new EVE event display for
8the MUON detector. The explained procedure is a complement to the visualisation
9of the full ALICE detector discussed on the ALICE Offline page, "Visualisation":
bc694317 10http://aliceinfo.cern.ch/Offline/Activities/Visualisation/
11
18f5e673 12\section eve_s1 The old EVE event display
13
14\subsection eve_s1_sub1 Macros
bc694317 15
16Found in $ALICE_ROOT/EVE/alice-macros and $ALICE_ROOT/EVE/macros.
17- MUON_displaySimu.C , to be used with simulations (shows also reference
18tracks, Monte-Carlo tracks and hits)
19- MUON_displayData.C , to be used with reconstructed raw data (with the option
20SAVEDIGITS in the reconstruction, "simulation" digits are also produced and
21can be visualized)
22- alieve_init.C , initialisation of the EVE environment
23- event_goto.C , navigation in the tree of events
24- geom_gentle_muon.C , draws a "light" geometry of the MUON detector obtained
25from the sensitive volumes of all MUON chambers; the default geometry of the
26event display is made of contours of the chambers extracted from the mapping
27
28\subsection eve_s1_sub2 Usage
29
18f5e673 30-# Launch the "alieve" executable
bc694317 31<pre>
18f5e673 32alieve
bc694317 33</pre>
18f5e673 34-# Load the following macros (.L macro.C)
bc694317 35<pre>
18f5e673 36alieve_init.C
37event_goto.C
38MUON_displayData.C
39or
40MUON_displaySimu.C
41geom_gentle_muon.C
bc694317 42</pre>
18f5e673 43-# Initialize the EVE environment with your data
bc694317 44<pre>
7d52d15d 45alieve_init("local://$ALICE_ROOT/OCDB","directory_to_data",event_number)
bc694317 46</pre>
18f5e673 47-# Display the current event
bc694317 48<pre>
18f5e673 49MUON_displaySimu(0,0) - do not show tracks
50MUON_displaySimu(0,1) - show tracks
51MUON_displaySimu(1,0) - do not tracks, read digits from produced raw data
52MUON_displaySimu(1,1) - show tracks, read digits from produced raw data
53MUON_displayData(1,0) - do not show tracks
54MUON_displayData(1,1) - show tracks
55MUON_displayData(0,0) - do not show tracks, read the saved digits
56MUON_displayData(0,1) - show tracks, read the saved digits
bc694317 57</pre>
18f5e673 58-# Draw the "gentle" geometry (sensitive volumes)
59<pre>
60geom_gentle_muon()
61</pre>
62-# Navigate in the event list
63<pre>
64event_goto(n)
65</pre>
66-# Shift + right mouse button one a muon track opens the context menu (track
bc694317 67and trigger information is available)
18f5e673 68<pre></pre>
69-# A new flag argument is added to the MUON_display macros for displaying the
bc694317 70the clusters taken from the ESD (default), only those attached to the tracks,
71or from MUONRecPoints, all reconstructed clusters
bc694317 72<pre>
73MUON_displaySimu(x,x,1) - clusters from ESD
74MUON_displaySimu(x,x,0) - clusters from rec points
75MUON_displayData(x,x,1) - clusters from ESD
76MUON_displayData(x,x,0) - clusters from rec points
77</pre>
78
18f5e673 79\section eve_s2 The new EVE event display
80
81\subsection eve_s1_sub3 Macros
82
83Found in $ALICE_ROOT/EVE/alice-macros and $ALICE_ROOT/EVE/macros.
84- muon_init.C , to launch the new display (based on visscan_init.C)
85- muon_raw.C , display digits from raw data
86- muon_digits.C , display digits from MUON.Digits.root file
87- muon_clusters.C , display clusters from MUON.RecPoints.root file
88- esd_muon_tracks.C , display tracks, clusters attached to tracks and digits
89attached to clusters (if any) from ESD
90- muon_trackRefs.C , display simulated tracks and hits in the MUON chambers
91- kine_tracks.C , display all the simulated tracks
92- geom_gentle_muon.C , draws a "light" geometry of the MUON detector obtained
93from the sensitive volumes of all MUON chambers; the default geometry of the
94event display is made of contours of the chambers extracted from the mapping
95
96\subsection eve_s1_sub4 Usage
97
98-# Launch the "alieve" executable
99<pre>
100alieve
101</pre>
102-# Initialize the EVE environment with the path to the OCDB and your data.
103 -# Reading data locally:
104<pre>
105.x muon_init.C("local://$ALICE_ROOT/OCDB","directory_to_data")
106</pre>
107 -# Reading data on the grid (link to corresponding raw data is made automatically):
108<pre>
109.x muon_init.C("raw://","alien:///alice/data/2009/LHC09c/000084039/ESDs/pass1/09000084039008.10")
110</pre>
111-# Change what to draw: \n
112Just enable/disable the corresponding macros in the tab "DataSelection"
113by clicking on the macro name and checking the box "Active"
114<pre></pre>
115-# Navigate in the event list: \n
116Just use the buttons or choose the event number in the bottom panel. You can also scan the events by checking the box "Autoload" and change the time between 2 drawing.
117<pre></pre>
118-# Leave the cursor on a track to pop-up its characteristics
119
d0420264 120\section eve_s3 The simplified "gentle" geometry for the event display
121
122Execute from aliroot the macro MUONGenerateGentleGeometry.C and place the resulting file in EVE/alice-data. This file is used by the macro geom_gentle_muon.C
123from EVE/alice-macros.
124
bc694317 125This chapter is defined in the READMEeve.txt file.
126
127*/
128