Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/examples/extended/electromagnetic/TestEm4/README

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                             TestEm4
  8                             -------
  9 
 10  Plot energy deposited by 9 MeV photon beam in an homogeneous medium.
 11   
 12  1- GEOMETRY DEFINITION
 13  
 14   It is a cylinder of 5 cm radius filled with C6F6.
 15   
 16  2- PHYSICS LIST
 17  
 18   The particle list contains only gamma, electron,positron.
 19   The physics list contains the 'standard' electromagnetic processes.
 20    
 21  3- AN EVENT : THE PRIMARY GENERATOR
 22  
 23   The primary kinematic is a single 9 MeV gamma randomly shooted at the
 24   middle of the cylinder. 
 25           
 26  4- VISUALIZATION
 27  
 28   The Visualization Manager is set in the main().
 29   The initialisation of the drawing is done via the commands
 30   /vis/.. in the macro vis.mac. This macro is
 31   automatically read from the main in case of interactive running mode.
 32   
 33   The detector has a default view which is a transversal view of the 
 34   cylinder.
 35   
 36   The tracks are drawn at the end of event, and erased at the end of run.
 37   Optionaly one can choose to draw all particles, only the charged one,
 38   or none. This command is defined in EventActionMessenger class.
 39   
 40  5- PHYSICS SURVEY
 41  
 42    The energy deposited in C6F6 is histogramed.
 43   
 44  6- HOW TO START ?
 45  
 46   - execute TestEm4 in 'batch' mode from macro files
 47     % TestEm4   TestEm4.in
 48     
 49   - execute TestEm4 in 'interactive mode' with visualization
 50     % TestEm4
 51     ....
 52     Idle> type your commands
 53     ....
 54     Idle> exit
 55     
 56          macro verbose.mac illustrate capability of verbosity   
 57 
 58  7- USING HISTOGRAMS
 59 
 60  The format of the histogram file can be : root (default),
 61  xml, csv, by selecting g4nnn.hh in RunAction.hh
 62 
 63  8- RANDOM NUMBERS HANDLING
 64  
 65    CLHEP provides several random number engines. In this example the Ranecu
 66    engine is choosen at beginning of the main (TestEm4.cc).
 67   
 68    By default, G4RunManager does not save the rndm seed.
 69    To do so the user must set in BeginOfRunAction:
 70    G4RunManager::GetRunManager()->SetRandomNumberStore(true);
 71   
 72    Then the rndm seed is systematically saved at beginning of run
 73    (currentRun.rndm) and beginning of event (currentEvent.rndm)
 74    Therefore, in case of abnormal end, the seed of the last event processed
 75    is available in currentEvent.rndm
 76   
 77    Even in case of normal run processing, the user may wish to preserve the
 78    rndm seed of selected events. At any time in the event, put the
 79    following statement:
 80    if (condition) G4RunManager::GetRunManager()->rndmSaveThisEvent();
 81    currentEvent.rndm will be copied to runXXevntYY.rndm
 82    (see SteppingAction::UserSteppingAction() )
 83   
 84    To restart a run from a given rndm seed, use the UI command :
 85    /random/resetEngineFrom  fileName 
 86   
 87    The macro rndmSeed.mac shows how to save and reset the random number
 88    seed between runs, from UI commands.