Warning, /geant4/examples/extended/medical/dna/chem3/README is written in an unsupported language. File is not indexed.
0001 -------------------------------------------------------------------
0002
0003 =========================================================
0004 Geant4 - an Object-Oriented Toolkit for Simulation in HEP
0005 =========================================================
0006
0007 Chem3
0008 -------
0009
0010 This example is provided by the Geant4-DNA collaboration.
0011
0012 These processes and models are further described at:
0013 http://geant4-dna.org
0014
0015 Any report or published results obtained using the Geant4-DNA software shall
0016 cite the following Geant4-DNA collaboration publications:
0017 Phys. Med. 31 (2015) 861-874
0018 Med. Phys. 37 (2010) 4692-4708
0019
0020 How to implement user actions in the chemistry module.
0021
0022 1 - GEOMETRY DEFINITION
0023
0024 It is a simple box which represents a 'semi infinite' homogeneous medium.
0025
0026 Two parameters define the geometry :
0027 - the material of the box -- for Geant4-DNA it has to be water.
0028 - the full size of the box.
0029
0030 The default geometry is constructed in DetectorConstruction class, but all of
0031 the above parameters can be changed interactively via the commands defined in
0032 the DetectorMessenger class.
0033
0034 2 - PHYSICS LIST
0035
0036 The physics list is initialized in G4EmDNAChemistry, together with chemical
0037 stage models configuration.
0038
0039 3 - AN EVENT: THE PRIMARY GENERATOR
0040
0041 The primary kinematic consists of a single particle starting at the center of
0042 the sphere. The type of the particle and its energy are set in the
0043 PrimaryGeneratorAction class, and can be changed via the G4 build-in commands
0044 of G4ParticleGun class.
0045 The chemistry module is triggered in the StackingAction class when all
0046 physical tracks have been processed.
0047
0048 4 - HOW TO START ?
0049
0050 Run the example from build directory.
0051
0052 To run the example in batch mode:
0053 ./chem3 -mac beam.in
0054 or
0055 ./chem3
0056 then the macro beam.in is processed by default
0057
0058 In interactive mode, run:
0059 ./chem3 -gui
0060 or
0061 ./chem3 -gui gui.mac
0062
0063 The user interface will be launched. Continue using /run/beamOn 1 command.
0064 By default, the vis.mac visualization macro is called.
0065 The vis_vm,.mac macro is used only in the context of the G4DNA tutorial
0066 hands-ons.
0067
0068 5 - OUTPUT
0069
0070 Physics initialization and the defined reaction table are printed.
0071 G4ITStepManager processes the chemical stage time step after time step.
0072 Chemical reactions are printed.
0073 In the GUI window a cummulative trajectory of the chemical species is drawn.
0074
0075 The functions in TimeStepAction show how to get species
0076 ID, positions at each time step or in a chemical reaction
0077
0078 6 - TIME EVOLUTION VISUALIZATION
0079
0080 User can start a visualization of the chemical track evolution in time and space
0081 using /control/execute movie.mac. (The movie.mac macro then executes
0082 the movie_prep.mac, movie_chemistry.mac and movie_physics.mac macros.)
0083 Note, that in default setup the simulation requires machine with 6 GB of RAM.
0084 To lower memory requirements, either decrease energy of the incident electron
0085 in prep.mac or/and shorten the simulation using SetEndTime setting in
0086 src/ActionInitialization.cc.
