Warning, /geant4/examples/extended/parameterisations/gflash/gflasha/README.md is written in an unsupported language. File is not indexed.
0001 \page Examplegflasha Example gflasha
0002
0003 This example demonstrating usage 'gflash' shower parameterisation
0004 in homogeneous calorimeter. Compare with glash1,2,3 the histograms
0005 have been added in this example. This makes it possible to use this
0006 example for fine tuning of GFLASH parameters.
0007
0008 This example allows to compare the shower profiles from fast simulation
0009 with full simulation by histograming of longitudinal (slice)
0010 and radial profiles with different "binning".
0011 Then GFlash fast simulation can be "tuned" via modification
0012 of the model parameters file:
0013
0014 include/ExGflashHomoShowerTuning.hh
0015
0016 in this example.
0017
0018 ## Physics List
0019
0020
0021 The Physics list factory is used in this example.
0022 The default physics list is FTFP_BERT which has EM opt0.
0023 Additionally, the G4FastSimulationPhysics physics
0024 constructor was created to insert the G4FastSimulationManagerProcess
0025 that is making the interface between the fast simulation and the tracking.
0026
0027 The default PHYSICS list may be changed via setting of the PHYSLIST environment
0028 variable, e.g.:
0029
0030 ```
0031 export PHYSLIST=FTFP_BERT_EMZ # for FTFP_BERT with opt 4 EM physics
0032 ```
0033
0034 ## Geometry Definition
0035
0036 In this example the calorimeter is a simple cube,
0037 which consists of 10 x 10 crystals of PbWO4 (CMS like).
0038
0039 Geometry, sensitive detector and hits are defined respectively in:
0040 - ExGflashDetectorConstruction
0041 - ExGflashSensitiveDetector
0042 - ExGflashHit
0043
0044 The geometry can be redefined in PreInit state via commands:
0045
0046 ```
0047 /exgflash/det/setNbCrys ncrys
0048 /exgflash/det/setCrysWidth width [cm]
0049 /exgflash/det/setCrysLength length [cm]
0050 ```
0051
0052 Materials can be chosen from Nist Materials: G4_Air G4_WATER ...
0053 e.g.:
0054 ```
0055 /exgflash/det/setMat G4_PbWO4
0056 ```
0057 see also: csi1.mac
0058
0059 ## Hit Scoring
0060
0061 The virtual cylinder sliced longitudinally (slice) and radially (ring) was used.
0062 The size of the slices and rings are expressed in radiation
0063 length units and Moliere radius (Rm) units for rings. The number
0064 of division and division size in fraction of units and can be changed.
0065 e.g.:
0066 ```
0067 /exgflash/det/setLbin 20 1. ---> 20 slices of 1. radl
0068 /exgflash/det/setRbin 5 0.25 ---> 5 rings of 0.25 Rm
0069 (MaxBin = 500 in both directions)
0070 ```
0071
0072 In ExGflashEventAction class the arrays corresponded slices and rings was
0073 created and filled with hists information. These arrays where use to fill
0074 histograms later.
0075
0076 ## Visualization
0077
0078 The Visualization Manager is set in the main().
0079 The initialization of the drawing is done via the commands /vis/...
0080 in the macro vis.mac. To get visualization use:
0081 ```
0082 /control/execute vis.mac
0083 ```
0084
0085 ## How to start ?
0086
0087 - Execute ExGflasha in 'batch' mode from macro files
0088 ```
0089 % ./ExGflasha test.mac
0090 ```
0091
0092 - Execute ExGflasha in 'interactive mode' with visualization
0093 ```
0094 % ./ExGflasha
0095 ....
0096 Idle> type your commands
0097 ....
0098 Idle> exit
0099 ```
0100
0101 The GFLASH activated via:
0102 ```
0103 /GFlash/flag 1
0104 ```
0105
0106 ## Histograms
0107
0108 ExGflasha produces several histograms:
0109 The histograms defined in ExGflashHistoManager class
0110
0111 Content of these histo:
0112
0113 - h0 : energy deposit per event
0114 - h1 : the number of hits per event
0115 - h2 : the energy per hit ( in MeV )
0116
0117 - p0 : longitudinal energy profile
0118 - p1 : radial energy profile
0119
0120 - p2 : cumulated longitudinal energy profile
0121 - p3 : cumulated radial energy profile
0122
0123 To define the output file name with histograms, use the UI command :
0124 ```
0125 /analysis/setFileName name
0126 ```
0127
0128 ## Macros
0129
0130 The macros to run in batch mode:
0131
0132 - test.mac - default macro for example testing, it show how to use different application commands: redefine the histograms and profiles, change the geometry and material, etc
0133
0134 - csi.mac - like test.mac but produce profiles in CsI Material
0135
0136 - testLong.mac - make the runs with more statistics using default geometry and histograms setting, the material is G4_PbWO4
0137
0138 - csiLong.mac - show how to run testLong.mac with different material (CsI)
0139
0140 Each macro executes two runs with fast simulation flag ON (the output file
0141 name is set to gflash01.root ) and OFF (the output file name is set to gflash00.root )
0142
0143 In addition, the ROOT macros cmpL.C, cmpR.C and cmpE.C file are provided,
0144 which can be used to draw superimposed full and fast histograms for radial
0145 and lateral profiles and also the normalized total energy deposition
0146 in calorimeter.
0147
0148 See also [Category "parameterisations/gflash"](../../html/Examples_gflash.html) documentation.