| Geant4 Cross Reference |
1 1
2 ========================================= 2 =========================================================
3 Geant4 - ULTRA-based air shower 3 Geant4 - ULTRA-based air shower example
4 ========================================= 4 =========================================================
5 5
6 README 6 README
7 --------------------- 7 ---------------------
8 8
9 ---------------------------------------------- << 9 ------------------------------------------------------------------------|
10 ----> Introduction. 10 ----> Introduction.
11 << 11 |
12 The ULTRA detector is a hybrid 2-component sys 12 The ULTRA detector is a hybrid 2-component system consisting of:
>> 13 |
13 14
14 << 15 1) an UV detection system - the UVscope |
15 1) an UV detection system - the UVscope <<
16 2) an array of scintillator detectors - the ET 16 2) an array of scintillator detectors - the ETscope
17 << 17 |
18 The UVscope detects Cherenkov light associated 18 The UVscope detects Cherenkov light associated to cosmic ray showers
19 when it is diffusively reflected on ground. << 19 when it is diffusively reflected on ground. |
20 The ETscope detects in coincidence the charged 20 The ETscope detects in coincidence the charged particles of the shower.
21 << 21 |
22 In the current version only the UVscope simula 22 In the current version only the UVscope simulation is included
23 ---------------------------------------------- << 23 ------------------------------------------------------------------------|
24 ----> Description 24 ----> Description
25 << 25 |
26 The UVscope consists of a Fresnel lens and a P 26 The UVscope consists of a Fresnel lens and a PMT located in the focal
27 plane, enclosed in a cylindrical aluminum hous << 27 plane, enclosed in a cylindrical aluminum housing. The lens is 457 mm |
28 in diameter and is made of UV transmitting acr 28 in diameter and is made of UV transmitting acrylic with 5.6 grooves
29 per mm. The description of the geometry of the << 29 per mm. The description of the geometry of the Fresnel lens makes use |
30 of object parameterisation/replication capabil 30 of object parameterisation/replication capabilities.
31 << 31 |
32 The primary vertex generator describes a plane 32 The primary vertex generator describes a plane circular source of UV
33 (3eV, about 400 nm) optical photons. << 33 (3eV, about 400 nm) optical photons. |
34 Depending on the selected detector configurati << 34 Depending on the user selection (see below for the relevant environment
35 positioned such that the photons are fired << 35 variables) the source can be positioned such that the photons are fired |
36 to a reflecting surface or, by default, direct 36 to a reflecting surface or, by default, directly to the UVscope
37 (no reflecting surface is present in this case << 37 (no reflecting surface is present in this case). |
38 Reflection at the surface can be chosen to be 38 Reflection at the surface can be chosen to be specular or diffuse.
39 In both cases the normal to the surface makes << 39 In both cases the normal to the surface makes an angle of 45 degrees |
40 with the UVscope axis and the photons are emit 40 with the UVscope axis and the photons are emitted at an angle of
41 90 degrees with the UVscope axis. << 41 90 degrees with the UVscope axis. |
42 If none of these variables is set no reflectin 42 If none of these variables is set no reflecting surface is used
43 and the photons source is positioned at the UV 43 and the photons source is positioned at the UVscope axis.
44 << 44 |
45 The definition of the relevant optical boundar 45 The definition of the relevant optical boundaries, parameters and
46 processes is made. << 46 processes is made. |
47 47
48 ---------------------------------------------- << 48 ------------------------------------------------------------------------|
49 ----> SET-UP 49 ----> SET-UP
50 << 50 |
51 A standard Geant4 example GNUmakefile and a CM << 51 -example enviroment with the compiler 3.2.3
52 provided, for building with cmake << 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: |
53 59
54 The following environment variable can be set << 60 setenv G4ANALYSIS_USE 1
55 additional verbosity during program running: <<
56 61
57 1) GNUmakefile << 62 setenv ULTRA_VERBOSE
58 63
59 setenv ULTRA_VERBOSE << 64 setenv ULTRA_MIRROR_USE 1 : A specular reflecting surface is used.
>> 65 setenv ULTRA_GROUND_USE 1 : A diffusive reflecting surface is used.
60 66
61 or << 67 setup for analysis with PI 1.2.1 for user with account on lxplus:
>> 68 setenv PI_VERSION 1_2_1
>> 69 setenv PATH ${PATH}:"/afs/cern.ch/sw/geant4/dev/PI/Linux-g++/bin"
>> 70 eval `aida-config -r csh` |
62 71
63 2) cmake -DULTRA_VERBOSE=ON "path to source" << 72 the following keywords can be used in order to produce HBOOK, AIDA or ROOT histograms
>> 73 "hbook" for HBOOK histograms
>> 74 "xml" for AIDA histograms
>> 75 "root" for ROOT histograms
>> 76
>> 77 for more information on PI
>> 78 http://wenaus.home.cern.ch/wenaus/peb-app/
>> 79 http://lcgapp.cern.ch/project/pi/
64 80
65 81
66 ---------------------------------------------- 82 ------------------------------------------------------------------------
>> 83 ----> How to run the example. |
67 84
68 The analysis is performed using the native Gea << 85 - batch mode:
69 (g4tools). In the default case, the output his << 86 $G4WORDIR/bin/Linux-g++/Ultra UltraMacro.mac |
70 in a ROOT file. << 87 |
71 << 88 - Interative mode:
72 The output file can be written in other format << 89 3) $G4WORDIR/bin/Linux-g++/Ultra |
73 changing the G4AnalysisManager default file ty <<
74 <<
75 ---------------------------------------------- <<
76 ----> How to run the example. <<
77 <<
78 From the directory where the Ultra binary re <<
79 <<
80 ./Ultra "macro name" for running in batch mo <<
81 <<
82 ./Ultra for running in interative mode. <<
83 The macro VisDirect.mac is executed. <<
84 <<
85 Several macros are available for interactive <<
86 While in interactive mode type the command <<
87 /control/execute "name_of_macro", <<
88 where "name_of_macro" is one of the followin <<
89 <<
90 Direct.mac - a beam of photons is shot direc <<
91 Mirror.mac - the beam is directed to a specu <<
92 Ground.mac - the beam is directed to a diffu <<
93 90
94 ---------------------------------------------- 91 ------------------------------------------------------------------------
95 ----> Simulation output << 92 ----> Simulation output |
96 93
97 the output is ultra.root << 94 if G4ANALYSIS_USE = 1 in the set-up, the output is ultra.aida |
98 It contains: 95 It contains:
99 1)1Dhistogram with the detected photons energ << 96 1)1Dhistogram with the detected photons energy (eV) |
100 2)1Dhistogram with the number of detected pho << 97 2)1Dhistogram with the number of detected photons per event |
101 98
>> 99 ------------------------------------------------------------------------
>> 100 ----> Visualisation |
102 101
103 To plot these histograms run the ROOT macro 'd << 102 a macro is provided as example of visulisation: Visualisation.mac |
104 > root do_plots.C << 103 to run it : $G4WORKDIR/bin/Linux-g++/Ultra Visualisation.mac
105 ---------------------------------------------- 104 ------------------------------------------------------------------------
106 105
107 for comments and questions: bernardo@lip.pt 106 for comments and questions: bernardo@lip.pt
108 for more info http://www.ge.infn.it/geant4/exa 107 for more info http://www.ge.infn.it/geant4/examples/
109 108
110 last modified: B. Tome 08/11/2019 << 109 last modified: B. Tome and M.C. Espirito Santo 20/05/2004
111 created by : B. Tome and M.C. Espirito Sant <<