]>
Commit | Line | Data |
---|---|---|
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 | \section eve_s3 The simplified "gentle" geometry for the event display | |
121 | ||
122 | Execute 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 | |
123 | from EVE/alice-macros. | |
124 | ||
125 | This chapter is defined in the READMEeve.txt file. | |
126 | ||
127 | */ | |
128 |