Previous commit had the bad side-effect of changing the behaviour of Raw QA to comput...
[u/mrichter/AliRoot.git] / MUON / READMEeve.txt
1 // $Id$
2
3 /*!
4
5 \page README_eve Event display
6
7 \section eve_s1 The EVE event display
8
9 This README file shows how to use the EVE event display for the MUON detector. 
10 The explained procedure is a complement to the visualisation of the full ALICE
11 detector discussed on the ALICE Offline page, "Visualisation": 
12 http://aliceinfo.cern.ch/Offline/Activities/Visualisation/
13
14 \subsection eve_s1_sub1 Macros for the event display
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
32 <pre>
33    alieve
34 </pre>
35
36 - load the following macros (.L macro.C)
37
38 <pre>
39    alieve_init.C
40    event_goto.C
41    MUON_displayData.C
42    or
43    MUON_displaySimu.C
44    geom_gentle_muon.C
45 </pre>
46
47 - initialize the EVE environment with your data
48
49 <pre>
50    alieve_init("directory_to_data",event_number)
51 </pre>
52
53 - display the current event
54
55 <pre>
56    MUON_displaySimu(0,0)   - do not show tracks
57    MUON_displaySimu(0,1)   - show tracks
58    MUON_displaySimu(1,0)   - do not tracks, read digits from produced raw data
59    MUON_displaySimu(1,1)   - show tracks, read digits from produced raw data
60    MUON_displayData(1,0)   - do not show tracks
61    MUON_displayData(1,1)   - show tracks
62    MUON_displayData(0,0)   - do not show tracks, read the saved digits
63    MUON_displayData(0,1)   - show tracks, read the saved digits
64 </pre>
65
66 - draw the "gentle" geometry (sensitive volumes)
67
68    geom_gentle_muon()
69
70 - navigate in the event list
71
72    event_goto(n)
73
74 - Shift + right mouse button one a muon track opens the context menu (track 
75 and trigger information is available)
76
77 - a new flag argument is added to the MUON_display macros for displaying the 
78 the clusters taken from the ESD (default), only those attached to the tracks, 
79 or from MUONRecPoints, all reconstructed clusters
80
81 <pre>
82 MUON_displaySimu(x,x,1) - clusters from ESD
83 MUON_displaySimu(x,x,0) - clusters from rec points
84 MUON_displayData(x,x,1) - clusters from ESD
85 MUON_displayData(x,x,0) - clusters from rec points
86 </pre>
87
88 This chapter is defined in the READMEeve.txt file.
89
90 */
91