In READMEeve.txt:
authorivana <ivana@f7af4fe6-9843-0410-8265-dc069ae4e863>
Thu, 3 Dec 2009 14:41:22 +0000 (14:41 +0000)
committerivana <ivana@f7af4fe6-9843-0410-8265-dc069ae4e863>
Thu, 3 Dec 2009 14:41:22 +0000 (14:41 +0000)
Adding instructions for using new EVE event display
(Philippe P.)

MUON/READMEeve.txt

index 2e2469e..14e6049 100644 (file)
@@ -4,14 +4,14 @@
 
 \page README_eve Event display
 
-\section eve_s1 The EVE event display
-
-This README file shows how to use the EVE event display for the MUON detector. 
-The explained procedure is a complement to the visualisation of the full ALICE
-detector discussed on the ALICE Offline page, "Visualisation": 
+This README file shows how to use both the old and new EVE event display for
+the MUON detector. The explained procedure is a complement to the visualisation
+of the full ALICE detector discussed on the ALICE Offline page, "Visualisation": 
 http://aliceinfo.cern.ch/Offline/Activities/Visualisation/
 
-\subsection eve_s1_sub1 Macros for the event display
+\section eve_s1 The old EVE event display
+
+\subsection eve_s1_sub1 Macros
 
 Found in $ALICE_ROOT/EVE/alice-macros and $ALICE_ROOT/EVE/macros.
 - MUON_displaySimu.C , to be used with simulations (shows also reference 
@@ -27,57 +27,48 @@ event display is made of contours of the chambers extracted from the mapping
 
 \subsection eve_s1_sub2 Usage
 
-- launch the "alieve" executable
-
+-# Launch the "alieve" executable
 <pre>
-   alieve
+alieve
 </pre>
-
-- load the following macros (.L macro.C)
-
+-# Load the following macros (.L macro.C)
 <pre>
-   alieve_init.C
-   event_goto.C
-   MUON_displayData.C
-   or
-   MUON_displaySimu.C
-   geom_gentle_muon.C
+alieve_init.C
+event_goto.C
+MUON_displayData.C
+or
+MUON_displaySimu.C
+geom_gentle_muon.C
 </pre>
-
-- initialize the EVE environment with your data
-
+-# Initialize the EVE environment with your data
 <pre>
-   alieve_init("directory_to_data",event_number)
+alieve_init("directory_to_data",event_number)
 </pre>
-
-- display the current event
-
+-# Display the current event
 <pre>
-   MUON_displaySimu(0,0)   - do not show tracks
-   MUON_displaySimu(0,1)   - show tracks
-   MUON_displaySimu(1,0)   - do not tracks, read digits from produced raw data
-   MUON_displaySimu(1,1)   - show tracks, read digits from produced raw data
-   MUON_displayData(1,0)   - do not show tracks
-   MUON_displayData(1,1)   - show tracks
-   MUON_displayData(0,0)   - do not show tracks, read the saved digits
-   MUON_displayData(0,1)   - show tracks, read the saved digits
+MUON_displaySimu(0,0)   - do not show tracks
+MUON_displaySimu(0,1)   - show tracks
+MUON_displaySimu(1,0)   - do not tracks, read digits from produced raw data
+MUON_displaySimu(1,1)   - show tracks, read digits from produced raw data
+MUON_displayData(1,0)   - do not show tracks
+MUON_displayData(1,1)   - show tracks
+MUON_displayData(0,0)   - do not show tracks, read the saved digits
+MUON_displayData(0,1)   - show tracks, read the saved digits
 </pre>
-
-- draw the "gentle" geometry (sensitive volumes)
-
-   geom_gentle_muon()
-
-- navigate in the event list
-
-   event_goto(n)
-
-- Shift + right mouse button one a muon track opens the context menu (track 
+-# Draw the "gentle" geometry (sensitive volumes)
+<pre>
+geom_gentle_muon()
+</pre>
+-# Navigate in the event list
+<pre>
+event_goto(n)
+</pre>
+-# Shift + right mouse button one a muon track opens the context menu (track 
 and trigger information is available)
-
-- a new flag argument is added to the MUON_display macros for displaying the 
+<pre></pre>
+-# A new flag argument is added to the MUON_display macros for displaying the 
 the clusters taken from the ESD (default), only those attached to the tracks, 
 or from MUONRecPoints, all reconstructed clusters
-
 <pre>
 MUON_displaySimu(x,x,1) - clusters from ESD
 MUON_displaySimu(x,x,0) - clusters from rec points
@@ -85,6 +76,47 @@ MUON_displayData(x,x,1) - clusters from ESD
 MUON_displayData(x,x,0) - clusters from rec points
 </pre>
 
+\section eve_s2 The new EVE event display
+
+\subsection eve_s1_sub3 Macros
+
+Found in $ALICE_ROOT/EVE/alice-macros and $ALICE_ROOT/EVE/macros.
+- muon_init.C , to launch the new display (based on visscan_init.C)
+- muon_raw.C , display digits from raw data
+- muon_digits.C , display digits from MUON.Digits.root file
+- muon_clusters.C , display clusters from MUON.RecPoints.root file
+- esd_muon_tracks.C , display tracks, clusters attached to tracks and digits
+attached to clusters (if any) from ESD
+- muon_trackRefs.C , display simulated tracks and hits in the MUON chambers
+- kine_tracks.C , display all the simulated tracks
+- geom_gentle_muon.C , draws a "light" geometry of the MUON detector obtained 
+from the sensitive volumes of all MUON chambers; the default geometry of the
+event display is made of contours of the chambers extracted from the mapping
+
+\subsection eve_s1_sub4 Usage
+
+-# Launch the "alieve" executable
+<pre>
+alieve
+</pre>
+-# Initialize the EVE environment with the path to the OCDB and your data.
+   -# Reading data locally:
+<pre>
+.x muon_init.C("local://$ALICE_ROOT/OCDB","directory_to_data")
+</pre>
+   -# Reading data on the grid (link to corresponding raw data is made automatically):
+<pre>
+.x muon_init.C("raw://","alien:///alice/data/2009/LHC09c/000084039/ESDs/pass1/09000084039008.10")
+</pre>
+-# Change what to draw: \n 
+Just enable/disable the corresponding macros in the tab "DataSelection"
+by clicking on the macro name and checking the box "Active"
+<pre></pre>
+-# Navigate in the event list: \n
+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.
+<pre></pre>
+-# Leave the cursor on a track to pop-up its characteristics
+
 This chapter is defined in the READMEeve.txt file.
 
 */