Version:
[ ReleaseNotes ] [ 1.0 ] [ 1.1 ] [ 2.0 ] [ 3.0 ] [ 3.1 ] [ 3.2 ] [ 4.0 ] [ 4.0.p1 ] [ 4.0.p2 ] [ 4.1 ] [ 4.1.p1 ] [ 5.0 ] [ 5.0.p1 ] [ 5.1 ] [ 5.1.p1 ] [ 5.2 ] [ 5.2.p1 ] [ 5.2.p2 ] [ 6.0 ] [ 6.0.p1 ] [ 6.1 ] [ 6.2 ] [ 6.2.p1 ] [ 6.2.p2 ] [ 7.0 ] [ 7.0.p1 ] [ 7.1 ] [ 7.1.p1 ] [ 8.0 ] [ 8.0.p1 ] [ 8.1 ] [ 8.1.p1 ] [ 8.1.p2 ] [ 8.2 ] [ 8.2.p1 ] [ 8.3 ] [ 8.3.p1 ] [ 8.3.p2 ] [ 9.0 ] [ 9.0.p1 ] [ 9.0.p2 ] [ 9.1 ] [ 9.1.p1 ] [ 9.1.p2 ] [ 9.1.p3 ] [ 9.2 ] [ 9.2.p1 ] [ 9.2.p2 ] [ 9.2.p3 ] [ 9.2.p4 ] [ 9.3 ] [ 9.3.p1 ] [ 9.3.p2 ] [ 9.4 ] [ 9.4.p1 ] [ 9.4.p2 ] [ 9.4.p3 ] [ 9.4.p4 ] [ 9.5 ] [ 9.5.p1 ] [ 9.5.p2 ] [ 9.6 ] [ 9.6.p1 ] [ 9.6.p2 ] [ 9.6.p3 ] [ 9.6.p4 ] [ 10.0 ] [ 10.0.p1 ] [ 10.0.p2 ] [ 10.0.p3 ] [ 10.0.p4 ] [ 10.1 ] [ 10.1.p1 ] [ 10.1.p2 ] [ 10.1.p3 ] [ 10.2 ] [ 10.2.p1 ] [ 10.2.p2 ] [ 10.2.p3 ] [ 10.3 ] [ 10.3.p1 ] [ 10.3.p2 ] [ 10.3.p3 ] [ 10.4 ] [ 10.4.p1 ] [ 10.4.p2 ] [ 10.4.p3 ] [ 10.5 ] [ 10.5.p1 ] [ 10.6 ] [ 10.6.p1 ] [ 10.6.p2 ] [ 10.6.p3 ] [ 10.7 ] [ 10.7.p1 ] [ 10.7.p2 ] [ 10.7.p3 ] [ 10.7.p4 ] [ 11.0 ] [ 11.0.p1 ] [ 11.0.p2 ] [ 11.0.p3, ] [ 11.0.p4 ] [ 11.1 ] [ 11.1.1 ] [ 11.1.2 ] [ 11.1.3 ] [ 11.2 ] [ 11.2.1 ] [ 11.2.2 ] [ 11.3.0 ]
1 -------------------------------------------------------------------
2
3 =========================================================
4 Geant4 - an Object-Oriented Toolkit for Simulation in HEP
5 =========================================================
6
7 Chem3
8 -------
9
10 This example is provided by the Geant4-DNA collaboration.
11
12 These processes and models are further described at:
13 http://geant4-dna.org
14
15 Any report or published results obtained using the Geant4-DNA software shall
16 cite the following Geant4-DNA collaboration publications:
17 Phys. Med. 31 (2015) 861-874
18 Med. Phys. 37 (2010) 4692-4708
19
20 How to implement user actions in the chemistry module.
21
22 1 - GEOMETRY DEFINITION
23
24 It is a simple box which represents a 'semi infinite' homogeneous medium.
25
26 Two parameters define the geometry :
27 - the material of the box -- for Geant4-DNA it has to be water.
28 - the full size of the box.
29
30 The default geometry is constructed in DetectorConstruction class, but all of
31 the above parameters can be changed interactively via the commands defined in
32 the DetectorMessenger class.
33
34 2 - PHYSICS LIST
35
36 The physics list is initialized in G4EmDNAChemistry, together with chemical
37 stage models configuration.
38
39 3 - AN EVENT: THE PRIMARY GENERATOR
40
41 The primary kinematic consists of a single particle starting at the center of
42 the sphere. The type of the particle and its energy are set in the
43 PrimaryGeneratorAction class, and can be changed via the G4 build-in commands
44 of G4ParticleGun class.
45 The chemistry module is triggered in the StackingAction class when all
46 physical tracks have been processed.
47
48 4 - HOW TO START ?
49
50 Run the example from build directory.
51
52 To run the example in batch mode:
53 ./chem3 -mac beam.in
54 or
55 ./chem3
56 then the macro beam.in is processed by default
57
58 In interactive mode, run:
59 ./chem3 -gui
60 or
61 ./chem3 -gui gui.mac
62
63 The user interface will be launched. Continue using /run/beamOn 1 command.
64 By default, the vis.mac visualization macro is called.
65 The vis_vm,.mac macro is used only in the context of the G4DNA tutorial
66 hands-ons.
67
68 5 - OUTPUT
69
70 Physics initialization and the defined reaction table are printed.
71 G4ITStepManager processes the chemical stage time step after time step.
72 Chemical reactions are printed.
73 In the GUI window a cummulative trajectory of the chemical species is drawn.
74
75 The functions in TimeStepAction show how to get species
76 ID, positions at each time step or in a chemical reaction
77
78 6 - TIME EVOLUTION VISUALIZATION
79
80 User can start a visualization of the chemical track evolution in time and space
81 using /control/execute movie.mac. (The movie.mac macro then executes
82 the movie_prep.mac, movie_chemistry.mac and movie_physics.mac macros.)
83 Note, that in default setup the simulation requires machine with 6 GB of RAM.
84 To lower memory requirements, either decrease energy of the incident electron
85 in prep.mac or/and shorten the simulation using SetEndTime setting in
86 src/ActionInitialization.cc.
