Warning, /geant4/examples/extended/hadronic/Hadr04/README is written in an unsupported language. File is not indexed.
0001
0002 =========================================================
0003 Geant4 - an Object-Oriented Toolkit for Simulation in HEP
0004 =========================================================
0005
0006 Hadr04
0007 ------
0008
0009 This example is focused on neutronHP physics, especially neutron transport,
0010 including thermal scattering.
0011 See A.R. Garcia, E. Mendoza, D. Cano-Ott presentation at G4 Hadronic group
0012 meeting (04/2013) and note on G4NeutronHP package
0013
0014 1- MATERIALS AND GEOMETRY DEFINITION
0015
0016 It is a single box representing a 'quasi infinite' homogeneous medium.
0017 Two parameters define the geometry :
0018 - the material of the box,
0019 - the (full) size of the box.
0020
0021 The default geometry (1 m3 of pressurized water) is built in
0022 DetectorConstruction, but the above parameters can be changed interactively
0023 via commands defined in DetectorMessenger.
0024
0025 A function, and its associated UI command, allows to build a material
0026 directly from a single isotope.
0027
0028 To be identified by the ThermalScattering module, the elements composing a
0029 material must have a specific name (see G4NeutronHPThermalScatteringNames.cc)
0030 Examples of such materials are build in DetectorConstruction.
0031
0032 2- PHYSICS LIST
0033
0034 Only processes of neutronHP package are registered : neutronElastic
0035 (including thermalScattering), neutronInelastic, nCapture; nFission.
0036 See class NeutronHPphysics.
0037 No other hadronic nor electromagnetic processes are registered.
0038
0039 A command allows to select or not ThermalScattering model.
0040
0041 Several hadronic physics options are controlled by environment variables.
0042 To select them, see Hadr04.cc
0043
0044 NB. class NeutronHPphysics can be reused with other physicsConstructors,
0045 as neutron processes are deleted before to be re-created.
0046
0047
0048 3- AN EVENT : THE PRIMARY GENERATOR
0049
0050 The primary kinematic is a single particle randomly shooted at the
0051 centre of the box. The type of the particle and its energy are set in
0052 PrimaryGeneratorAction (neutron 2 MeV), and can be changed via the G4
0053 build-in commands of ParticleGun class (see the macros provided with
0054 this example).
0055
0056 4- PHYSICS
0057
0058 All secondaries are killed in StackingAction. Therefore an event consists of
0059 the transport of the primary neutron. Then one survey the thermal and non
0060 thermal part of this parcours.
0061
0062
0063 5- HISTOGRAMS
0064
0065 The test contains 7 built-in 1D histograms, which are managed by
0066 G4AnalysisManager and its Messenger. The histos can be individually
0067 activated with the command :
0068 /analysis/h1/set id nbBins valMin valMax unit
0069 where unit is the desired unit for the histo (MeV or keV, etc..)
0070 (see the macros xxxx.mac).
0071
0072 1 "incident neutron: nb of collisions above 1 eV"
0073 2 "incident neutron: total track length above 1 eV"
0074 3 "incident neutron: time of flight above 1 eV"
0075 4 "incident neutron: nb of collisions below 1 eV"
0076 5 "incident neutron: total track length below 1*eV"
0077 6 "incident neutron: time of flight below 1 eV"
0078 7 "incident neutron: energy distribution below 1*eV"
0079
0080 The histograms are managed by the HistoManager class and its Messenger.
0081 The histos can be individually activated with the command :
0082 /analysis/h1/set id nbBins valMin valMax unit
0083 where unit is the desired unit for the histo (MeV or keV, deg or mrad, etc..)
0084
0085 One can control the name of the histograms file with the command:
0086 /analysis/setFileName name (default Hadr04)
0087
0088 It is possible to choose the format of the histogram file : root (default),
0089 xml, csv, by using namespace in HistoManager.hh
0090
0091 It is also possible to print selected histograms on an ascii file:
0092 /analysis/h1/setAscii id
0093 All selected histos will be written on a file name.ascii (default Hadr04)
0094
0095 6- VISUALIZATION
0096
0097 The Visualization Manager is set in the main().
0098 The initialisation of the drawing is done via the commands
0099 /vis/... in the macro vis.mac. To get visualisation:
0100 > /control/execute vis.mac
0101
0102 The detector has a default view which is a longitudinal view of the box.
0103 The tracks are drawn at the end of event, and erased at the end of run.
0104
0105 7- HOW TO START ?
0106
0107 Execute Hadr04 in 'batch' mode from macro files :
0108 % Hadr04 run01.mac
0109
0110 Execute Hadr04 in 'interactive mode' with visualization :
0111 % Hadr04
0112 Idle> control/execute vis.mac
0113 ....
0114 Idle> type your commands
0115 ....
0116 Idle> exit
0117
0118 Macros provided in this example:
0119 - hadr04.in: macro used in Geant4 testing
0120 - graphite.mac: neutron (2 MeV) in graphite
0121 - run01.mac: neutron (2 MeV) in Water_ts
0122
0123 Macros to be run interactively:
0124 - debug.mac: neutron (2 MeV) in Water_ts
0125 - vis.mac: To activate visualization
