electromagnetic/TestEm10/README.md

0001 \page ExampleTestEm10 Example TestEm10
0002
0003  Test for investigation of transition radiation.
0004  Default setup for TestEm10.in and TestEm10.large_N.in is the simplified
0005  setup for ALICE XTR test beam (~2004), defined in DetectorSimpleALICE class.
0006
0007 ## GEOMETRY DEFINITION
0008
0009  The geometry setup includes "radiator" and "absorber" volumes
0010  of a box shape.
0011
0012  The "radiator" material is defined as a mixture of a gas and foil material
0013  and the "absorber" contains a gas material.
0014
0015  Several geometry setups are defined in the classes
0016  DetectorSetupX,
0017  where SetupX = ALICE06, Bari05, Barr90, Construction, Harris73, Messenger, SimpleALICE, Watase86
0018
0019  The default setup, SimpleALICE, can be changed via UI command:
0020 ```
0021 /XTRdetector/setup setup
0022      where setup = simpleALICE, alice06, bari05, harris73, watase86, barr90
0023 ```
0024
0025
0026 ## PRIMARY GENERATOR
0027
0028  The primary kinematic consists of a single particle which hits the
0029  absorber perpendicular to the input face. The type of the particle
0030  and its energy are set in the PrimaryGeneratorAction class, and can
0031  be changed via the G4 build-in commands of G4ParticleGun class (see
0032  the macros provided with this example).
0033
0034 ## DETECTOR RESPONSE
0035
0036  In this example the total energy deposited in the "absorber" volume
0037  is accounted in SensitevDetector class, and a spectrum of XTR gamma
0038  particles, all secondary gamma particles and all secondary e-
0039  particleas is accounted in StackingAction class.
0040
0041 ## PHYSICS
0042
0043  The particle's type and the physic processes which will be available
0044  in this example are set in PhysicsList class.
0045  The trasition radiation process is defined in the
0046  TransitionRadiationPhysics builder.
0047
0048  The transition radiator models can be changed simply with:
0049 ```
0050 Idle> /emphyslist/setXTRModel modelName
0051 ```
0052  See macro files for different setups provided with the example.
0053
0054 ## HISTOGRAMS
0055
0056  Testem10 produces several histo which are saved as testem10.root by default.
0057  Content of these histo:
0058   - 1. Energy deposit in absorber
0059   - 2. XTR Gamma spectrum
0060   - 3. Secondary Gamma spectrum
0061   - 4. Secondary e- spectrum
0062   - 5. Energy deposit in absorber with the same histogram parameters
0063        as in the previous version of this example (Geant4 version <=10.2)
0064
0065   The histograms are managed by G4AnalysisManager class and its Messenger.
0066   The histos can be individually activated with the command :
0067   /analysis/h1/set id nbBins  valMin valMax unit
0068   where unit is the desired unit for the histo (MeV or keV, deg or mrad, etc..)
0069
0070   One can control the name of the histograms file with the command:
0071 ```
0072 /analysis/setFileName  name  (default testem1)
0073 ```
0074
0075   It is possible to choose the format of the histogram file : root (default),
0076   hdf5, xml, csv, by changing the default file type in HistoManager.cc
0077
0078   It is also possible to print selected histograms on an ascii file:
0079 ```
0080 /analysis/h1/setAscii id
0081 ```
0082   All selected histos will be written on a file name.ascii  (default testem1)
0083
0084 ## HOW TO START ?
0085
0086  - Execute TestEm10 in 'batch' mode from macro files e.g.
0087 ```
0088 % ./TestEm10 TestEm10.in [TestEm10.large_N.in]
0089 ```
0090
0091  - Execute TestEm10 in 'interactive' mode with visualization e.g.
0092 ```
0093 % ./TestEm10
0094 ....
0095 Idle> type your commands
0096 ....
0097 ```
0098
0099 ## MACROS
0100
0101 - alice06.mac:  ALICE simplified 2006 test beam setup
0102 - bari05.mac:   setup of Bari INFN group (M. Bridgida et al, NIM A550 (2005) 157-168 (fig. 8))
0103 - barr90.mac:   NIM A294 (1990) 465-472 (fig. 11) setup
0104 - harris73.mac: NIM 107 (1973) 413-422 (fig. 3b) setup
0105 - salice.mac:   ALICE simplified 2006 test beam setup with disabled
0106                 ionisation and multiple scattering
0107 - watase86.mac: NIM A248 (1986) 379-388 (fig. 7) setup