Back to home page

EIC code displayed by LXR

 
 

    


Warning, /geant4/examples/extended/hadronic/Hadr06/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                             Hadr06
0007                             ------
0008 
0009    Survey energy deposition and particle's flux from an hadronic cascade.
0010    Use PhysicsConstructor objects rather than predefined G4 PhysicsLists.   
0011 
0012         
0013  1- MATERIALS AND GEOMETRY DEFINITION
0014  
0015    The geometry is a single sphere (absorber) of an homogenous material.
0016     
0017    Two parameters define the geometry :
0018         - the radius of the sphere         
0019         - the material of the sphere
0020         
0021    The default geometry (R=30 cm of water) is built in 
0022    DetectorConstruction, but the above parameters can be changed interactively 
0023    via commands defined in DetectorMessenger.
0024    
0025    The absorber is surrounded by a World volume (vacuum)
0026    
0027    A function, and its associated UI command, allows to build a material
0028    directly from a single isotope.
0029    
0030    To be identified by the ThermalScattering module, the elements composing a
0031    material must have a specific name (see G4ParticleHPThermalScatteringNames.cc)
0032    Examples of such materials are build in DetectorConstruction.
0033         
0034  2- PHYSICS LIST
0035    
0036   "Full" set of physics processes are registered, but via PhysicsConstructor
0037   objects rather than complete pre-defined G4 physics lists. This alternative 
0038   way gives more freedom to register physics.
0039 
0040   Physics constructors are either constructors provided in Geant4 (with G4 prefix)
0041   or 'local'. They include : HadronElastic, HadronInelastic, IonsInelastic, GammaNuclear,
0042   RadioactiveDecay and Electomagnetic.
0043   (see geant4/source/physics_lists/constructors)
0044 
0045   HadronElasticPhysicsHP include a model for thermalized neutrons, under the control of a command
0046   defined in NeutronHPMesseger.
0047 
0048   GammmaNuclearPhysics is a subset of G4BertiniElectroNuclearBuilder.
0049 
0050   ElectromagneticPhysics is a simplified version of G4EmStandardPhysics.
0051 
0052   Several hadronic physics options are controlled by environment variables.
0053   To trigger them, see Hadr06.cc
0054          
0055  3- AN EVENT : THE PRIMARY GENERATOR
0056  
0057    The primary kinematic is a single particle randomly shooted at the 
0058    centre of the sphere. The type of the particle and its energy are set in 
0059    PrimaryGeneratorAction (neutron 14 MeV), and can be changed via the G4 
0060    build-in commands of ParticleGun class (see the macros provided with 
0061    this example).
0062         
0063  4- PHYSICS
0064 
0065    The program computes and plots energy deposited in the interaction volume
0066    (absorber) and the flux of particles leaving this volume.
0067    Processes invoked and particles generated during hadronic cascade are listed.
0068 
0069  5- HISTOGRAMS
0070          
0071    The test contains 24 built-in 1D histograms:  
0072    
0073             1     "total energy deposit"
0074             2     "Edep (MeV/mm) profile along radius"            
0075             3     "total kinetic energy flow"
0076             4     "energy spectrum of gamma at creation"
0077             5     "energy spectrum of e+- at creation"
0078             6     "energy spectrum of neutrons at creation"
0079             7     "energy spectrum of protons at creation"
0080             8     "energy spectrum of deuterons at creation"
0081             9     "energy spectrum of alphas at creation"
0082             10    "energy spectrum of all others ions at creation"
0083             11    "energy spectrum of all others baryons at creation"
0084             12    "energy spectrum of all others mesons at creation"
0085             13    "energy spectrum of all others leptons (neutrinos) at creation"
0086             14    "energy spectrum of emerging gamma"
0087             15    "energy spectrum of emerging e+-"
0088             16    "energy spectrum of emerging neutrons"
0089             17    "energy spectrum of emerging protons"
0090             18    "energy spectrum of emerging deuterons"
0091             19    "energy spectrum of emerging alphas"
0092             20    "energy spectrum of all others emerging ions"
0093             21    "energy spectrum of all others emerging baryons"
0094             22    "energy spectrum of all others emerging mesons"
0095             23    "energy spectrum of all others emerging leptons (neutrinos)"
0096             24    "total energy released : edep + eflow"            
0097                   
0098    The histograms are managed by the HistoManager class and its Messenger. 
0099    The histos can be individually activated with the command :
0100    /analysis/h1/set id nbBins  valMin valMax unit 
0101    where unit is the desired unit for the histo (MeV or keV, cm or mm, etc..)
0102    
0103    One can control the name of the histograms file with the command:
0104    /analysis/setFileName  name  (default Hadr06)
0105    
0106    It is possible to choose the format of the histogram file : root (default),
0107    xml, csv, by using namespace in HistoManager.hh
0108        
0109    It is also possible to print selected histograms on an ascii file:
0110    /analysis/h1/setAscii id
0111    All selected histos will be written on a file name.ascii (default Hadr04) 
0112                                         
0113  6- VISUALIZATION
0114  
0115    The Visualization Manager is set in the main().
0116    The initialisation of the drawing is done via the commands
0117    /vis/... in the macro vis.mac. To get visualisation:
0118    > /control/execute vis.mac
0119         
0120    The tracks are drawn at the end of event, and erased at the end of run.   
0121    gamma green   
0122    neutron yellow
0123    negative particles (e-, ...) red
0124    positive particles (e+, ions, ...) blue
0125         
0126  7- HOW TO START ?
0127  
0128    Execute Hadr06 in 'batch' mode from macro files :
0129         % Hadr06   run1.mac
0130                 
0131    Execute Hadr06 in 'interactive mode' with visualization :
0132         % Hadr06
0133         Idle> control/execute vis.mac
0134         ....
0135         Idle> type your commands
0136         ....
0137         Idle> exit
0138         
0139  Macros provided in this example:
0140   - hadr06.in: macro used in Geant4 testing to produce hadr06.out
0141   - graphite.mac: neutron,14 MeV, in graphite
0142   - run1.mac: neutron,14 MeV, in Li7
0143   - singleFission.mac: single fission in U235
0144   
0145   Macros to be run interactively:
0146   - debug.mac: water with thermal scattering
0147   - fission.mac: U235
0148   - vis.mac: To activate visualization
0149