new functionality and new class added
[u/mrichter/AliRoot.git] / MUON / READMEeve.txt
1 // $Id$
2
3 /*!
4
5 \page README_eve Event display
6
7 This README file shows how to use both the old and new EVE event display for
8 the MUON detector. The explained procedure is a complement to the visualisation
9 of the full ALICE detector discussed on the ALICE Offline page, "Visualisation": 
10 http://aliceinfo.cern.ch/Offline/Activities/Visualisation/
11
12 \section eve_s1 The old EVE event display
13
14 \subsection eve_s1_sub1 Macros
15
16 Found in $ALICE_ROOT/EVE/alice-macros and $ALICE_ROOT/EVE/macros.
17 - MUON_displaySimu.C , to be used with simulations (shows also reference 
18 tracks, Monte-Carlo tracks and hits)
19 - MUON_displayData.C , to be used with reconstructed raw data (with the option
20 SAVEDIGITS in the reconstruction, "simulation" digits are also produced and 
21 can 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 
25 from the sensitive volumes of all MUON chambers; the default geometry of the
26 event display is made of contours of the chambers extracted from the mapping
27
28 \subsection eve_s1_sub2 Usage
29
30 -# Launch the "alieve" executable
31 <pre>
32 alieve
33 </pre>
34 -# Load the following macros (.L macro.C)
35 <pre>
36 alieve_init.C
37 event_goto.C
38 MUON_displayData.C
39 or
40 MUON_displaySimu.C
41 geom_gentle_muon.C
42 </pre>
43 -# Initialize the EVE environment with your data
44 <pre>
45 alieve_init("local://$ALICE_ROOT/OCDB","directory_to_data",event_number)
46 </pre>
47 -# Display the current event
48 <pre>
49 MUON_displaySimu(0,0)   - do not show tracks
50 MUON_displaySimu(0,1)   - show tracks
51 MUON_displaySimu(1,0)   - do not tracks, read digits from produced raw data
52 MUON_displaySimu(1,1)   - show tracks, read digits from produced raw data
53 MUON_displayData(1,0)   - do not show tracks
54 MUON_displayData(1,1)   - show tracks
55 MUON_displayData(0,0)   - do not show tracks, read the saved digits
56 MUON_displayData(0,1)   - show tracks, read the saved digits
57 </pre>
58 -# Draw the "gentle" geometry (sensitive volumes)
59 <pre>
60 geom_gentle_muon()
61 </pre>
62 -# Navigate in the event list
63 <pre>
64 event_goto(n)
65 </pre>
66 -# Shift + right mouse button one a muon track opens the context menu (track 
67 and trigger information is available)
68 <pre></pre>
69 -# A new flag argument is added to the MUON_display macros for displaying the 
70 the clusters taken from the ESD (default), only those attached to the tracks, 
71 or from MUONRecPoints, all reconstructed clusters
72 <pre>
73 MUON_displaySimu(x,x,1) - clusters from ESD
74 MUON_displaySimu(x,x,0) - clusters from rec points
75 MUON_displayData(x,x,1) - clusters from ESD
76 MUON_displayData(x,x,0) - clusters from rec points
77 </pre>
78
79 \section eve_s2 The new EVE event display
80
81 \subsection eve_s1_sub3 Macros
82
83 Found 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
89 attached 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 
93 from the sensitive volumes of all MUON chambers; the default geometry of the
94 event 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>
100 alieve
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 
112 Just enable/disable the corresponding macros in the tab "DataSelection"
113 by clicking on the macro name and checking the box "Active"
114 <pre></pre>
115 -# Navigate in the event list: \n
116 Just 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
120 This chapter is defined in the READMEeve.txt file.
121
122 */
123