CRT becomes ACORDE
[u/mrichter/AliRoot.git] / EVE / README
index 0fa8ecc21913ff6a573a6f2113e905db6c28d5df..84097a6a83ecbd459b204f3606cd67e1d7744470 100644 (file)
@@ -7,8 +7,7 @@ EVE is composed of:
 3. CINT scripts that extract data, fill graphics classes and register
    them to the application.
 
-This is an early release ... expect problems and be sure that what you
-need is not supported.
+The framework is still evolving ... some things might not work as expected.
 
 
 Usage
@@ -16,19 +15,27 @@ Usage
 
 1. Initialize ALICE environment.
 
-2. Spawn 'reve' executable and invoke the alieve_init.C macro, for example:
+2. Spawn 'alieve' executable and invoke the alieve_init.C macro, for example:
 
 To load first event from current directory:
-   # reve  alieve_init.C 
+   # alieve  alieve_init.C 
 To load 5th event from directory /data/my-pp-run:
-   # reve 'alieve_init.C("/data/my-pp-run", 5)' 
+   # alieve 'alieve_init.C("/data/my-pp-run", 5)' 
 Interactively:
-   # reve
+   # alieve
    root[0] .L alieve_init.C
    root[1] alieve_init("/somedir")
 
 3. Use GUI or CINT command-line to invoke further visualization macros.
-  
+
+4. To navigate the events use macros 'event_next.C' and 'event_prev.C'.
+   These are equivalent to the command-line invocations:
+   root[x] Alieve::gEvent->NextEvent()
+or
+   root[x] Alieve::gEvent->PrevEvent()
+The general form to go to event via its number is:
+   root[x] Alieve::gEvent->GotoEvent(<event-number>)
+
 See files in EVE/alice-macros/. For specific uses these should be
 edited to suit your needs.
 
@@ -50,3 +57,22 @@ test-macros/      -- macros for tests of specific features; usually one needs
 
 bin/, Makefile and make_base.inc are used for stand-alone build of the
 packages.
+
+
+Notes
+=====
+
+1. Problems with macro-execution
+--------------------------------
+
+A failed macro-execution can leave CINT in a poorly defined state that
+prevents further execution of macros. For example:
+
+  Exception Reve::Exc_t: Event::Open failed opening ALICE ESDfriend from
+  '/alice-data/coctail_10k/AliESDfriends.root'.
+
+  root [1] Error: Function MUON_geom() is not defined in current scope  :0:
+  *** Interpreter error recovered ***
+  Error: G__unloadfile() File "/tmp/MUON_geom.C" not loaded  :0:
+
+'gROOT->Reset()' helps in most of the cases.