$Id: README,v 1.6 2004/09/29 10:00:30 gcosmo Exp $
-------------------------------------------------------------------

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

                         Examples module
                         ---------------

This module collects three sets of user examples aimed to demonstrate to
the user how to make correct use of the GEANT4 toolkit by implementing
in a correct way those user-classes which the user is supposed to
customize in order to define his/her own simulation setup.
One set of examples is oriented to "novice" users and covering all
possible general use-cases typical of an "application"-oriented kind of
development. An "extended" set of examples require some additional
libraries besides of Geant4. This set covers some specific use cases
for actual detector simulation. An "advanced" set of examples covers
the use-cases typical of a "toolkit"-oriented kind of development,
where real complete applications for different simulation studies are
provided; may require additional third party products to be built.
Most of the examples can be run both in interactive and batch mode, and 
input macro files (*.in) and reference output files (*.out) are provided.
Novice and most of the extended examples are considered part of the
system testing suite for validation of the official releases of the
GEANT4 toolkit. Novice examples are used as "acceptance"-tests for the
release process.

Novice level examples
 ExampleN01
   - Mandatory user classes
   - Demonstrates how Geant4 kernel works
 ExampleN02
   - Simplified tracker geometry with uniform magnetic field
   - Electromagnetic processes
 ExampleN03
   - Simplified calorimeter geometry
   - Electromagnetic processes
   - Various materials
 ExampleN04
   - Simplified collider detector with a readout geometry
   - Full "ordinary" processes
   - PYTHIA primary events
   - Event filtering by stack
 ExampleN05
   - Simplified BaBar calorimeter
   - EM shower parametrisation
 ExampleN06
   - Optical photon processes
 ExampleN07
   - Regions and parameterised materials

Extended level examples
 analysis
   - Histogramming through the AIDA interface
 biasing
   - Examples of event biasing and scoring
 electromagnetic
   - Specific EM physics simulation with histogramming
 eventgenerator
   - Applications using interface to primary event generators
     like HepMC
 field
   - Specific simulation setups in magnetic field
 g3tog3
   - Examples of usage of the g3tog4 converter tool
 gdml
   - Example of detector persistency through the Geometry
     Description Markup Language (GDML)
 geometry
   - Specific geometry examples and tools: binding to CAD systems,
     OLAP tool for detection of overlapping geometries
 medical
   - Specific examples for medical physics applications
 optical
   - Examples of generic optical processes simulation setups
 parallel
   - Examples of event-level parallelism in Geant4 using the
     TOP-C distribution
 persistency
   - Persistency through generic interface

Advanced level examples
 brachytherapy
   - Setup for brachytherapy Ir-192 HDR source
 composite_calorimeter
   - Test-beam simulation used in CMS against real data taken
     in 1996 in a CMS Hadron calorimeter test-beam at LHC
 cosmicray_charging
   - Simulation of electrostatic charging in the LISA mission by
     galactic cosmic ray protons and helium nuclei
 gammaray_telescope
   - Simulation of a typical telescope for gamma ray analysis
 hadrontherapy
   - Simulation of a hadron therapy beam line
 lAr_calorimeter
   - Simulation of the Liquid Argon Calorimeter of the ATLAS
     Detector at LHC
 medical_linac
   - Simulation of energy deposit in a Phantom filled with water
     for a typical linac used for intensity modulated radiation therapy
 purging_magnet
   - Simulation of electrons traveling through a 3D magnetic field of a
     strong purging magnet used for treatment head in a medical environment
 radioprotection
   - Application for the evaluation of dose in astronauts, vehicle concepts
     and Moon surface habitat configurations, in a space radiation environment
 Rich
   - Rich Test Beam Simulation
 Tiara
   - Simulation of the TIARA experiment using importance sampling
 underground_physics
   - Setup of an underground dark matter experiment
 xray_fluorescence
   - Test beam to characterize the response function of an
     HPGe detector used to measure fluorescence emissions
 xray_telescope
   - Realistic simulation of an X-ray Telescope