[807] | 1 | |
---|
| 2 | ========================================================= |
---|
| 3 | Geant4 - ULTRA-based air shower example |
---|
| 4 | ========================================================= |
---|
| 5 | |
---|
| 6 | README |
---|
| 7 | --------------------- |
---|
| 8 | |
---|
| 9 | ------------------------------------------------------------------------| |
---|
| 10 | ----> Introduction. |
---|
| 11 | | |
---|
| 12 | The ULTRA detector is a hybrid 2-component system consisting of: |
---|
| 13 | | |
---|
| 14 | |
---|
| 15 | 1) an UV detection system - the UVscope | |
---|
| 16 | 2) an array of scintillator detectors - the ETscope |
---|
| 17 | | |
---|
| 18 | The UVscope detects Cherenkov light associated to cosmic ray showers |
---|
| 19 | when it is diffusively reflected on ground. | |
---|
| 20 | The ETscope detects in coincidence the charged particles of the shower. |
---|
| 21 | | |
---|
| 22 | In the current version only the UVscope simulation is included |
---|
| 23 | ------------------------------------------------------------------------| |
---|
| 24 | ----> Description |
---|
| 25 | | |
---|
| 26 | The UVscope consists of a Fresnel lens and a PMT located in the focal |
---|
| 27 | plane, enclosed in a cylindrical aluminum housing. The lens is 457 mm | |
---|
| 28 | in diameter and is made of UV transmitting acrylic with 5.6 grooves |
---|
| 29 | per mm. The description of the geometry of the Fresnel lens makes use | |
---|
| 30 | of object parameterisation/replication capabilities. |
---|
| 31 | | |
---|
| 32 | The primary vertex generator describes a plane circular source of UV |
---|
| 33 | (3eV, about 400 nm) optical photons. | |
---|
| 34 | Depending on the user selection (see below for the relevant environment |
---|
| 35 | variables) the source can be positioned such that the photons are fired | |
---|
| 36 | to a reflecting surface or, by default, directly to the UVscope |
---|
| 37 | (no reflecting surface is present in this case). | |
---|
| 38 | Reflection at the surface can be chosen to be specular or diffuse. |
---|
| 39 | In both cases the normal to the surface makes an angle of 45 degrees | |
---|
| 40 | with the UVscope axis and the photons are emitted at an angle of |
---|
| 41 | 90 degrees with the UVscope axis. | |
---|
| 42 | If none of these variables is set no reflecting surface is used |
---|
| 43 | and the photons source is positioned at the UVscope axis. |
---|
| 44 | | |
---|
| 45 | The definition of the relevant optical boundaries, parameters and |
---|
| 46 | processes is made. | |
---|
| 47 | |
---|
| 48 | ------------------------------------------------------------------------| |
---|
| 49 | ----> SET-UP |
---|
| 50 | | |
---|
[1337] | 51 | A standard Geant4 example GNUmakefile is provided | |
---|
[807] | 52 | |
---|
| 53 | The following environment variables can be set: | |
---|
| 54 | |
---|
| 55 | setenv G4ANALYSIS_USE 1 |
---|
| 56 | |
---|
| 57 | setenv ULTRA_VERBOSE |
---|
| 58 | |
---|
| 59 | setenv ULTRA_MIRROR_USE 1 : A specular reflecting surface is used. |
---|
| 60 | setenv ULTRA_GROUND_USE 1 : A diffusive reflecting surface is used. |
---|
| 61 | |
---|
[1337] | 62 | ------------------------------------------------------------------------ |
---|
[807] | 63 | |
---|
[1337] | 64 | Setup for analysis with iAIDA : for details, see Appendix 2 of the Users Guide for Application Developers |
---|
[807] | 65 | |
---|
[1337] | 66 | Definition of environment variables (assuming AIDA_INSTALL is the directory where you installed iAIDA): |
---|
| 67 | |
---|
| 68 | setenv PATH ${PATH}:"$AIDA_INSTALL/bin" |
---|
| 69 | |
---|
| 70 | The following keywords can be used in UltraAnalysisManager.cc, |
---|
| 71 | in order to produce HBOOK, AIDA or ROOT histograms. |
---|
| 72 | |
---|
[807] | 73 | "hbook" for HBOOK histograms |
---|
| 74 | "xml" for AIDA histograms |
---|
| 75 | "root" for ROOT histograms |
---|
| 76 | |
---|
[1337] | 77 | For more information on the AIDA interface: |
---|
[807] | 78 | http://aida.freehep.org |
---|
| 79 | |
---|
[1337] | 80 | |
---|
[807] | 81 | - |
---|
| 82 | |
---|
| 83 | ----------------------------------------------------------------------- |
---|
| 84 | ----> How to run the example. | |
---|
| 85 | |
---|
| 86 | - batch mode: |
---|
| 87 | $G4WORDIR/bin/Linux-g++/Ultra UltraMacro.mac | |
---|
| 88 | | |
---|
| 89 | - Interative mode: |
---|
| 90 | 3) $G4WORDIR/bin/Linux-g++/Ultra | |
---|
| 91 | |
---|
| 92 | ------------------------------------------------------------------------ |
---|
| 93 | ----> Simulation output | |
---|
| 94 | |
---|
| 95 | if G4ANALYSIS_USE = 1 in the set-up, the output is ultra.aida | |
---|
| 96 | It contains: |
---|
| 97 | 1)1Dhistogram with the detected photons energy (eV) | |
---|
| 98 | 2)1Dhistogram with the number of detected photons per event | |
---|
| 99 | |
---|
| 100 | ------------------------------------------------------------------------ |
---|
| 101 | ----> Visualisation | |
---|
| 102 | |
---|
| 103 | a macro is provided as example of visulisation: Visualisation.mac | |
---|
| 104 | to run it : $G4WORKDIR/bin/Linux-g++/Ultra Visualisation.mac |
---|
| 105 | ------------------------------------------------------------------------ |
---|
| 106 | |
---|
| 107 | for comments and questions: bernardo@lip.pt |
---|
| 108 | for more info http://www.ge.infn.it/geant4/examples/ |
---|
| 109 | |
---|
[1337] | 110 | last modified: B. Tome 16/11/2009 |
---|
| 111 | created by : B. Tome and M.C. Espirito Santo 20/05/2004 |
---|