]>
Commit | Line | Data |
---|---|---|
5a5a1232 | 1 | EVE - Event Visualization Environment |
2 | ===================================== | |
3 | ||
4 | EVE is composed of: | |
5 | 1. small application kernel; | |
6 | 2. graphics classes with editors and OpenGL renderers; | |
7 | 3. CINT scripts that extract data, fill graphics classes and register | |
8 | them to the application. | |
9 | ||
7c56a308 | 10 | The framework is still evolving ... some things might not work as expected. |
5a5a1232 | 11 | |
12 | ||
13 | Usage | |
14 | ===== | |
15 | ||
16 | 1. Initialize ALICE environment. | |
17 | ||
5987168b | 18 | 2. Spawn 'alieve' executable and invoke the alieve_init.C macro, for example: |
5a5a1232 | 19 | |
20 | To load first event from current directory: | |
5987168b | 21 | # alieve alieve_init.C |
5a5a1232 | 22 | To load 5th event from directory /data/my-pp-run: |
5987168b | 23 | # alieve 'alieve_init.C("/data/my-pp-run", 5)' |
5a5a1232 | 24 | Interactively: |
5987168b | 25 | # alieve |
5a5a1232 | 26 | root[0] .L alieve_init.C |
27 | root[1] alieve_init("/somedir") | |
28 | ||
29 | 3. Use GUI or CINT command-line to invoke further visualization macros. | |
71d91e82 | 30 | |
31 | 4. To navigate the events use macros 'event_next.C' and 'event_prev.C'. | |
32 | These are equivalent to the command-line invocations: | |
33 | root[x] Alieve::gEvent->NextEvent() | |
34 | or | |
35 | root[x] Alieve::gEvent->PrevEvent() | |
36 | The general form to go to event via its number is: | |
37 | root[x] Alieve::gEvent->GotoEvent(<event-number>) | |
38 | ||
528fcc86 | 39 | See files in EVE/alice-macros/ from the ROOT browser that is spawned |
40 | automatically with the application. They can be executed directly from | |
41 | the browser (by dpouble-clicking on their icon) or via standard ROOT's | |
42 | macro execution methods using '.x' and '.L'. If you want to pass the | |
43 | arguments to the macros, use '.L' as this gives you automatic tab | |
44 | completion. | |
45 | ||
46 | For specific uses you can copy them and edit them to suit your needs. | |
5a5a1232 | 47 | |
48 | ||
49 | Directory structure | |
50 | =================== | |
51 | ||
52 | EVE is split into two modules: REVE (ROOT part, not dependent on | |
53 | AliROOT) and ALIEVE (ALICE specific part). For the time being both | |
54 | modules are kept in AliROOT CVS. | |
55 | ||
56 | Alieve/ and Reve/ -- sources | |
57 | ||
58 | macros/ -- macros for bootstraping and internal steering | |
59 | alice-macros/ -- macros for ALICE visualization | |
60 | alica-data/ -- data files used by ALICE macros | |
915dabe1 | 61 | test-macros/ -- macros for tests of specific features; usually one needs |
62 | to copy and edit them | |
5a5a1232 | 63 | |
64 | bin/, Makefile and make_base.inc are used for stand-alone build of the | |
65 | packages. | |
7c56a308 | 66 | |
67 | ||
be55f120 | 68 | Examples |
69 | ======== | |
70 | ||
71 | 1. Run the interface for visual scanning: | |
72 | ||
73 | alieve -mode 2 trackcount_init.C | |
74 | ||
75 | ||
7c56a308 | 76 | Notes |
77 | ===== | |
78 | ||
79 | 1. Problems with macro-execution | |
80 | -------------------------------- | |
81 | ||
82 | A failed macro-execution can leave CINT in a poorly defined state that | |
83 | prevents further execution of macros. For example: | |
84 | ||
85 | Exception Reve::Exc_t: Event::Open failed opening ALICE ESDfriend from | |
86 | '/alice-data/coctail_10k/AliESDfriends.root'. | |
87 | ||
88 | root [1] Error: Function MUON_geom() is not defined in current scope :0: | |
89 | *** Interpreter error recovered *** | |
90 | Error: G__unloadfile() File "/tmp/MUON_geom.C" not loaded :0: | |
91 | ||
92 | 'gROOT->Reset()' helps in most of the cases. | |
be55f120 | 93 | |
94 | This has been fixed for most cases. |