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 \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