$Id: README,v 1.16 2009/05/13 08:32:36 gbarrand Exp $
-------------------------------------------------------------------

     =========================================================
     Geant4 - an Object-Oriented Toolkit for Simulation in HEP
     =========================================================

                            AnaEx01
                            -------

  This example shows the usage of histogram and tuple manipulations using 
 an AIDA compliant system. In this example, all analysis manipulations 
 (attaching an AIDA implementation, histo booking, filling, saving 
 histos in a file, etc...) are concentrated in one class : 
    AnaEx01AnalysisManager.

  To include the analysis code, the environment variable  
    G4ANALYSIS_USE
 must be defined before doing "make". If not, at run time, no
 histograms and file will be created.

  For example, a typical session from a UNIX csh flavoured shell is :
    csh> source <aida tool>/aida-setup.csh
    csh> setenv G4ANALYSIS_USE 1
    csh> make
    csh> ${G4BIN}/${G4SYSTEM}/AnaEx01
 After execution, a file AnaEx01.aida should have been created.
 Someone can change the default file format by changing the
 value of the std::string variable format in the AnaEx01AnalysisManager
 constructor :
    // File format :
    std::string format("xml");
    //std::string format("hbook");
    //std::string format("root");
 
 Working with the OpenScientist packages :
 ---------------------------------------
  To create the analysis file, you can install the light "osc_batch"
 binary kit (See http://OpenScientist.lal.in2p3.fr ). For example
 from a UNIX sh flavoured shell :
    sh> cd /usr/local
    sh> <arrange to be su>
    sh> <get an osc_batch binary kit>
    sh> unzip -q osc_batch<platform>.zip
    sh> cd osc_batch/<version>
    sh> ./install
  
  Then you build the example with :
    <create another terminal>
    csh> source /usr/local/osc_batch/<version>/aida-setup.csh
    csh> <source setup Geant4>
    csh> setenv G4ANALYSIS_USE 1
    csh> cd <G4_install_path>/examples/extended/analysis/AnaEx01
    csh> make
    csh> ${G4BIN}/${G4SYSTEM}/AnaEx01
   
  Depending of the file format, you can visualize the produced
 file with various interactive tools (CERN/PAW, CERN/ROOT, jas).
 But if installing also an OpenScientist osc_vis binary kit,
 you shall be able to visualize all formats by using
 the osc-plot program. To install an osc_vis kit :
    sh> cd /usr/local
    sh> <arrange to be su>
    sh> <get an osc_vis binary kit>
    sh> unzip -q osc_vis<platform>.zip
    sh> cd osc_vis/<version>
    sh> ./install
  Then to browse the AnaEx01.<format> file (for exa from an UNIX sh shell) :
    <create another terminal>
    sh> . /usr/local/osc_vis/<version>/setup.sh
    sh> <setenv DISPLAY if needed>
    sh> osc-plot AnaEx01.[aida,root,hbook]

  The OpenScientist URL is : 
    http://OpenScientist.lal.in2p3.fr.

  Note that OpenScientist is installed on CERN/lxplus under :
    /afs/cern.ch/sw/contrib/[osc_batch,osc_vis].