| 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 | |
|
|---|
| 51 | -example enviroment with the compiler 3.2.3
|
|---|
| 52 | -a standard Geant4 example GNUmakefile is provided |
|
|---|
| 53 |
|
|---|
| 54 | setup with: |
|
|---|
| 55 | compiler = gcc-3.2.3
|
|---|
| 56 | G4SYSTEM = linux-g++ |
|
|---|
| 57 |
|
|---|
| 58 | The following environment variables can be set: |
|
|---|
| 59 |
|
|---|
| 60 | setenv G4ANALYSIS_USE 1
|
|---|
| 61 |
|
|---|
| 62 | setenv ULTRA_VERBOSE
|
|---|
| 63 |
|
|---|
| 64 | setenv ULTRA_MIRROR_USE 1 : A specular reflecting surface is used.
|
|---|
| 65 | setenv ULTRA_GROUND_USE 1 : A diffusive reflecting surface is used.
|
|---|
| 66 |
|
|---|
| 67 | Setup for analysis with AIDA 3.2.1, PI 1.3.3.
|
|---|
| 68 | The download instructions for the PI UltraLite+Hbook version
|
|---|
| 69 | can be found at:
|
|---|
| 70 | http://cern.ch/pi/pi-ultraLite-133.html
|
|---|
| 71 |
|
|---|
| 72 | Definition of environment variables (assuming you used the directory
|
|---|
| 73 | "PiUltraLite-1.3.3" in your home directory):
|
|---|
| 74 |
|
|---|
| 75 | setenv PI_VERSION 1_3_3
|
|---|
| 76 | setenv PI_DIR ${HOME}/PiUltraLite-1.3.3
|
|---|
| 77 | setenv PATH ${PATH}:"${HOME}/PiUltraLite-1.3.3/bin"
|
|---|
| 78 | eval `aida-config -r csh` |
|
|---|
| 79 | ------------------------------------------------------------
|
|---|
| 80 | The following keywords can be used in order to produce HBOOK, AIDA or ROOT
|
|---|
| 81 | histograms
|
|---|
| 82 | "hbook" for HBOOK histograms
|
|---|
| 83 | "xml" for AIDA histograms
|
|---|
| 84 | "root" for ROOT histograms
|
|---|
| 85 |
|
|---|
| 86 | For more information on the analysis tools:
|
|---|
| 87 | http://aida.freehep.org
|
|---|
| 88 | http://www.cern.ch/PI
|
|---|
| 89 |
|
|---|
| 90 | -
|
|---|
| 91 |
|
|---|
| 92 | -----------------------------------------------------------------------
|
|---|
| 93 | ----> How to run the example. |
|
|---|
| 94 |
|
|---|
| 95 | - batch mode:
|
|---|
| 96 | $G4WORDIR/bin/Linux-g++/Ultra UltraMacro.mac |
|
|---|
| 97 | |
|
|---|
| 98 | - Interative mode:
|
|---|
| 99 | 3) $G4WORDIR/bin/Linux-g++/Ultra |
|
|---|
| 100 |
|
|---|
| 101 | ------------------------------------------------------------------------
|
|---|
| 102 | ----> Simulation output |
|
|---|
| 103 |
|
|---|
| 104 | if G4ANALYSIS_USE = 1 in the set-up, the output is ultra.aida |
|
|---|
| 105 | It contains:
|
|---|
| 106 | 1)1Dhistogram with the detected photons energy (eV) |
|
|---|
| 107 | 2)1Dhistogram with the number of detected photons per event |
|
|---|
| 108 |
|
|---|
| 109 | ------------------------------------------------------------------------
|
|---|
| 110 | ----> Visualisation |
|
|---|
| 111 |
|
|---|
| 112 | a macro is provided as example of visulisation: Visualisation.mac |
|
|---|
| 113 | to run it : $G4WORKDIR/bin/Linux-g++/Ultra Visualisation.mac
|
|---|
| 114 | ------------------------------------------------------------------------
|
|---|
| 115 |
|
|---|
| 116 | for comments and questions: bernardo@lip.pt
|
|---|
| 117 | for more info http://www.ge.infn.it/geant4/examples/
|
|---|
| 118 |
|
|---|
| 119 | last modified: B. Tome and M.C. Espirito Santo 20/05/2004
|
|---|
