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 |
---|