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