runAndEvent/RE05/README.md

0001 \page ExampleRE05 Example RE05
0002
0003  Example RE05 has a simplified collider detector geometry. This example
0004 demonstrates the following features. \n
0005  It was moved in extended examples from novice/N04 with removal of
0006 novice examples.
0007
0008 ## PYTHIA primary events
0009
0010  RE05PrimaryGeneratorAction has G4HEPEvtInterface as the generator.
0011 G4HEPEvtInterface accesses to "pythia_event.data", which contains three
0012 events of Higgs generation produced by PYTHIA. "pythia_main.f" is an
0013 example FORTRAN code of PYTHIA for generating this event sample.
0014
0015 ## Readout geometry
0016
0017  RE05DetectorConstruction defines a simplified collider detecor
0018 geometry, a tracker made of cylindrical tubes, a calorimeter made of
0019 cylindrical tubes, and muon trackers made of planes.
0020
0021  The cylindrical calorimeter is made of tubes of lead and a scintillator.
0022 Energy deposition in the scintillator is accumulated by RE05CalorimeterSD
0023 sensitive detector, which is assigned to a dedicated parallel world,
0024 RE05CalorimeterParallelWorld, which defines the phi-z cell.
0025
0026 ## Physics processes
0027
0028  The example uses the QBBC physics list, which includes electromagnetic
0029 and hadronic interactions.
0030
0031 ## Event filtering by the stacking mechanism
0032
0033  Higgs events in "pythia_event.data" have two lepton pairs produced
0034 by the Higgs decay via Z0. At the first stage of each event, only the
0035 primary muons are tracked without tracking secondaries. then the number
0036 of hits on the muon trackers are examined. At the next stage, only
0037 the primary charged particles are tracked only inside the barrel
0038 tracking area and the isolation of the primary muons are examined.
0039 At the third stage, all particles in the RoI (Region of Interest) along
0040 the isolated muons are tracked. All these examinations are applied in
0041 RE05StackingAction.
0042
0043 ## Input macro files
0044
0045 - exampleRE05.in:
0046
0047   Read "pythia_event.data" and run 10 events. This macro file
0048   demonstrates the feature described in the previous section.
0049
0050   N.B. For release 11.3, this macro is temporarily altered to shoot
0051   muons by particle gun. Once HepMC3 interface becomes ready, this
0052   example will be overhauled and this macro file will be updated
0053   accordingly.
0054
0055 - exampleRE05.EMtest.in and exampleRE05.EMtest.large_N.in
0056
0057   Alternative macros with shooting muons for checking EM physics.
0058
0059 ## How to start
0060
0061 - Execute RE05 in 'batch' mode from macro files
0062 ```
0063 % ./exampleRE05   exampleRE05.in
0064 ```
0065
0066 - Execute RE05 in 'interactive mode' with visualization
0067 ```
0068 % ./exampleRE05
0069 ....
0070 Idle> type your commands. For instance:
0071 Idle> /run/beamOn 3
0072 ....
0073 Idle> exit
0074 ```