Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/examples/extended/parameterisations/Par03/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                             Example Par03
  8                             -------------
  9 
 10  This example demonstrates how to use G4FastSimHitMaker helper class
 11  to create multiple energy deposits from the fast simulation model.
 12 
 13  It requires sensitive detector class to inherit from both base classes:
 14  - G4VSensitiveDetector: for processing of detailed/non-fast simulation hits
 15  - G4VFastSimSensitiveDetector: for processing of fast sim (G4FastSim) hits
 16  Hits are placed in the same hit collection, so they can be used to
 17  compare between the full and the fast simulation.
 18 
 19  The geometry used in the example is a homogeneous cylinder of lead, with
 20  3D readout geometry (cylindrical). Analysis of energy deposits is done
 21  in the event action.
 22 
 23  1. Detector description
 24  -----------------------
 25 
 26  The detector is a homogeneous cylinder of lead. It is segmented along
 27  z, R and phi to create a readout geometry in the cylindrical coordinates.
 28 
 29  Fast simulation is attached to the region of the detector.
 30 
 31 
 32  2. Sensitive detector
 33  -----------------------
 34 
 35  Sensitive detector inherits from both base classes:
 36  - G4VSensitiveDetector: for processing of detailed/non-fast simulation hits
 37  - G4VFastSimSensitiveDetector: for processing of fast sim (G4FastSim) hits.
 38  Hits are placed in the same hit collection, with a different flag to distinguish
 39  between those originated in the full simulation, and those from the fast
 40  simulation.
 41  During visualisation, hits are represented as volumes of different colour:
 42  green for full simulation and red for fast simulation.
 43 
 44  3. Primary generation
 45  ---------------------
 46 
 47  Particle gun is used as a primary generator. The direction of particles is along
 48  the axis of symmetry of the detector (cylinder). It is positioned 10 cm in front
 49  of the entrance to the detector. 10 GeV electron is used by default. Those values
 50  can be changed using /gun/ UI commands.
 51 
 52  4. Physics List
 53  ---------------
 54 
 55  FTFP_BERT modular physics list is used. On top of it, fast simulation physics
 56  is registered for selected particles (electrons, positrons, and photons).
 57 
 58 
 59  5. User actions
 60  ----------------------------------------------------------
 61 
 62  - Par03RunAction : run action used for initialization and termination
 63                     of the run. Histograms for analysis of shower development
 64                     in the detector are created.
 65 
 66  - Par03EventAction : event action used for initialization and termination
 67                       of the event. Analysis of shower development is performed
 68                       on event-by-event basis.
 69 
 70  6. Output
 71  ---------
 72 
 73  The execution of the program (examplePar03) produces an output with histograms.
 74 
 75  The macro file examplePar03.in specifies three runs. Each run is made of 100
 76  events, for single 10 GeV electron beams. The first run is executed with fast
 77  simulation model activated with defualt parameters. The second run executes fast
 78  simulation with modified parameters. For the third run the fast simulation model
 79  is disactivated.
 80  Three output files are produced: two with shower development from the fast
 81  simulation (with different parameters), and from the full simulation.
 82 
 83  7. How to build and run the example
 84  -----------------------------------
 85 
 86 - Compile and link to generate the executable (in your CMAKE build directory):
 87   % cmake <PAR03_SOURCE>
 88   % make
 89 
 90 - Execute the application (in batch mode):
 91   % ./examplePar03 -m examplePar03.in
 92   which produces three root files: Par03_fastsim_100events.root,
 93   Par03_fastsimModified_100events.root, and Par03_fullsim_100events.root.
 94 
 95 - Execute the application (in interactive mode):
 96   % ./examplePar03
 97   which allows to visualize hits.
 98 
 99  8. UI commands
100  --------------
101 
102  UI commands useful in this example:
103 
104 - activation/disactivation of the fast simulation model:
105    /param/ActivateModel model
106    /param/InActivateModel model
107 
108 - particle gun commands
109    /gun/particle e+
110    /gun/energy 50 GeV
111    /gun/direction 0 0.2 1
112    /gun/position 0 0 0
113 
114  UI commands defined in this example:
115  - detector settings
116   /Par03/detector/print
117   /Par03/detector/setDetectorRadius 10 cm
118   /Par03/detector/setDetectorLength 30 cm
119   /Par03/detector/setDetectorMaterial G4_Pb
120   /Par03/detector/setNbOfLayers 100
121   /Par03/detector/setNbOfPhiCells 20
122   /Par03/detector/setNbOfRhoCells 100
123 
124  - fast simulation settings
125   /Par03/fastSim/print
126   /Par03/fastSim/transverseProfile/sigma 20 mm
127   /Par03/fastSim/longitudinalProfile/beta 0.6
128   /Par03/fastSim/longitudinalProfile/alpha 2.
129   /Par03/fastSim/longitudinalProfile/maxDepth 20
130   /Par03/fastSim/numberOfHits 500