$Id: README,v 1.3 2001/10/23 15:24:08 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
Extended level examples
analysis
- Histogramming through the AIDA interface
electromagnetic
- Specific EM physics simulation with histogramming
field
- Specific simulation setups in magnetic field
g3tog3
- Examples of usage of the g3tog4 converter tool
persistency
- Persistency through the HepODBMS interface
Advanced level examples
brachytherapy
- Setup for brachytherapy Ir-192 HDR source
gammaray_telescope
- Simulation of a typical telescope for gamma ray analysis
xray_telescope
- Realistic simulation of an X-ray Telescope