$Id: README,v 1.19 2006/05/15 14:39:20 maire Exp $
-------------------------------------------------------------------

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

                            TestEm4
                            -------

 Plot energy deposited by 9 MeV photon beam in an homogeneous medium.
	
 1- GEOMETRY DEFINITION
 
 	It is a cylinder of 5 cm radius filled with C6F6.
 	
 2- PHYSICS LIST
 
 	The particle list contains only gamma, electron,positron.
 	The physics list contains the 'standard' electromagnetic processes.
 	 
 3- AN EVENT : THE PRIMARY GENERATOR
 
 	The primary kinematic is a single 9 MeV gamma randomly shooted at the
 	middle of the cylinder. 
 	 				
 4- VISUALIZATION
 
 	The Visualization Manager is set in the main().
 	The initialisation of the drawing is done via the commands
 	/vis/.. in the macro vis.mac. This macro is
 	automatically read from the main in case of interactive running mode.
 	
 	The detector has a default view which is a transversal view of the 
 	cylinder.
 	
 	The tracks are drawn at the end of event, and erased at the end of run.
 	Optionaly one can choose to draw all particles, only the charged one,
 	or none. This command is defined in EventActionMessenger class.
 	
 5- PHYSICS SURVEY
 
   The energy deposited in C6F6 is histogramed.
 	
 6- HOW TO START ?
 
 	- compile and link to generate an executable
 		% cd examples/extended/electromagnetic/TestEm4
 		% gmake
 		
 	- execute TestEm4 in 'batch' mode from macro files
 		% TestEm4   TestEm4.in
 		
 	- execute TestEm4 in 'interactive mode' with visualization
 		% TestEm4
 		....
 		Idle> type your commands
 		....
 		Idle> exit
 		
 	- visualize the histogram (paw)
 		paw> h/file 1 testem4.hbook
 		paw> option stat
 		paw> option logy
 		paw> h/pl 1 	
  

 7- USING HISTOGRAMS

  By default the histograms are not activated. To activate histograms
  the environment variable G4ANALYSIS_USE should be defined. For instance
  uncomment the flag G4ANALYSIS_USE in GNUmakefile.

  Before compilation of the example it is optimal to clean up old files:
	gmake histclean
	gmake

  It is possible to choose the format of the histogram file (hbook, root, XML):
  comment/uncomment 1 line in the constructor of RunAction. 

  To use histograms, at least one of the AIDA implementations should be 
  available (see http://aida.freehep.org).
  
 7a - PI 

  A package including AIDA and extended interfaces also using Python is PI, 
  available from: http://cern.ch/pi

  Once installed PI or PI-Lite in a specified local area $MYPY, it is required 
  to add the installation path to $PATH, i.e. for example, for release 1.2.1 of 
  PI:
  setenv PATH ${PATH}:$MYPI/1.2.1/app/releases/PI/PI_1_2_1/rh73_gcc32/bin

  CERN users can use the PATH to the LCG area on AFS.
  Before running the example the command should be issued:
  eval `aida-config --runtime csh`

 7b -  OpenScientist

  OpenScientist is available at http://OpenScientist.lal.in2p3.fr.

  You have to "setup" the OpenScientist AIDA implementation before compiling
  (then with G4ANALYSIS_USE set) and running your Geant4 application.

 On UNIX you setup, with a csh flavoured shell : 
	csh> source <<OpenScientist install path>/aida-setup.csh 
        or with a sh flavoured shell : 
	sh> . <<OpenScientist install path>/aida-setup.sh
 On Windows : 
	DOS> call <<OpenScientist install path>/aida-setup.bat 

  You can use various file formats for writing (AIDA-XML, hbook, root).
  These formats are readable by the Lab onx interactive program
  or the OpenPAW application. See the web pages.


  With OpenPAW, on a run.hbook file, one can view the histograms
  with something like :
	OS> opaw 
        opaw> h/file 1 run.hbook  ( or opaw> h/file 1 run.aida or run.root)  
	opaw> zone 2 2 
	opaw> h/plot 1 
	opaw> h/plot 2