dna/chem2/README.md

0001 \page ExampleChem2 Example chem2
0002
0003 ## General description
0004
0005   This example is provided by the Geant4-DNA collaboration.
0006
0007   These processes and models are further described at:
0008   http://geant4-dna.org
0009
0010   Any report or published results obtained using the Geant4-DNA software shall
0011   cite the following Geant4-DNA collaboration publications:
0012   Phys. Med. 31 (2015) 861-874
0013   Med. Phys. 37 (2010) 4692-4708
0014
0015   How to activate chemistry code.
0016
0017   How to set minimum time step limits using TimeStepAction.
0018
0019 ## GEOMETRY DEFINITION
0020
0021   It is a simple box which represents a 'semi infinite' homogeneous medium.
0022
0023   Two parameters define the geometry :
0024    - the material of the box,
0025    - the full size of the box.
0026
0027   The default geometry is constructed in DetectorConstruction class.
0028
0029 ## PHYSICS LIST
0030
0031   PhysicsList is Geant4 modular physics list using G4EmDNAPhysics &
0032   G4EmDNAChemistry constructors.
0033
0034 ## AN EVENT: THE PRIMARY GENERATOR
0035
0036   The primary kinematic consists of a single particle starting at the center of
0037   the box. The type of the particle and its energy are set in the
0038   PrimaryGeneratorAction class, and can be changed via the G4 build-in commands
0039   of G4ParticleGun class.
0040   The chemistry module is triggered in the StackingAction class when all
0041   physical tracks have been processed.
0042
0043 ## OUTPUT
0044
0045   Physics initialization and the defined reaction table are printed.
0046   G4ITStepManager processes the chemical stage time step after time step.
0047   Chemical reactions are printed.
0048
0049 ## HOW TO START
0050
0051   To run the example in batch mode
0052
0053       ./chem2 -mac beam.in
0054
0055   or
0056
0057       ./chem2
0058
0059   then the macro beam.in is processed by default
0060
0061   In interactive mode, run:
0062
0063       ./chem2 -gui
0064
0065   or
0066
0067       ./chem2 -gui gui.mac