Added TRD to EINCLUDE.

[u/mrichter/AliRoot.git] / EVE / README

EVE - Event Visualization Environment
=====================================

EVE is composed of:
1. small application kernel;
2. graphics classes with editors and OpenGL renderers;
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.


Usage
=====

1. Initialize ALICE environment.

2. Spawn 'alieve' executable and invoke the alieve_init.C macro, for example:

To load first event from current directory:
   # alieve  alieve_init.C 
To load 5th event from directory /data/my-pp-run:
   # alieve 'alieve_init.C("/data/my-pp-run", 5)' 
Interactively:
   # 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.


Directory structure
===================

EVE is split into two modules: REVE (ROOT part, not dependent on
AliROOT) and ALIEVE (ALICE specific part). For the time being both
modules are kept in AliROOT CVS.

Alieve/ and Reve/ -- sources

macros/		  -- macros for bootstraping and internal steering
alice-macros/	  -- macros for ALICE visualization
alica-data/	  -- data files used by ALICE macros
test-macros/      -- macros for tests of specific features; usually one needs
                     to copy and edit them

bin/, Makefile and make_base.inc are used for stand-alone build of the
packages.