========================================================= Geant4 - ULTRA-based air shower example ========================================================= README --------------------- ------------------------------------------------------------------------| ----> Introduction. | The ULTRA detector is a hybrid 2-component system consisting of: | 1) an UV detection system - the UVscope | 2) an array of scintillator detectors - the ETscope | The UVscope detects Cherenkov light associated to cosmic ray showers when it is diffusively reflected on ground. | The ETscope detects in coincidence the charged particles of the shower. | In the current version only the UVscope simulation is included ------------------------------------------------------------------------| ----> Description | The UVscope consists of a Fresnel lens and a PMT located in the focal plane, enclosed in a cylindrical aluminum housing. The lens is 457 mm | in diameter and is made of UV transmitting acrylic with 5.6 grooves per mm. The description of the geometry of the Fresnel lens makes use | of object parameterisation/replication capabilities. | The primary vertex generator describes a plane circular source of UV (3eV, about 400 nm) optical photons. | Depending on the user selection (see below for the relevant environment variables) the source can be positioned such that the photons are fired | to a reflecting surface or, by default, directly to the UVscope (no reflecting surface is present in this case). | Reflection at the surface can be chosen to be specular or diffuse. In both cases the normal to the surface makes an angle of 45 degrees | with the UVscope axis and the photons are emitted at an angle of 90 degrees with the UVscope axis. | If none of these variables is set no reflecting surface is used and the photons source is positioned at the UVscope axis. | The definition of the relevant optical boundaries, parameters and processes is made. | ------------------------------------------------------------------------| ----> SET-UP | -example enviroment with the compiler 3.2.3 -a standard Geant4 example GNUmakefile is provided | setup with: | compiler = gcc-3.2.3 G4SYSTEM = linux-g++ | The following environment variables can be set: | setenv G4ANALYSIS_USE 1 setenv ULTRA_VERBOSE setenv ULTRA_MIRROR_USE 1 : A specular reflecting surface is used. setenv ULTRA_GROUND_USE 1 : A diffusive reflecting surface is used. Setup for analysis with AIDA 3.2.1, PI 1.3.3. The download instructions for the PI UltraLite+Hbook version can be found at: http://cern.ch/pi/pi-ultraLite-133.html Definition of environment variables (assuming you used the directory "PiUltraLite-1.3.3" in your home directory): setenv PI_VERSION 1_3_3 setenv PI_DIR ${HOME}/PiUltraLite-1.3.3 setenv PATH ${PATH}:"${HOME}/PiUltraLite-1.3.3/bin" eval `aida-config -r csh` | ------------------------------------------------------------ The following keywords can be used in order to produce HBOOK, AIDA or ROOT histograms "hbook" for HBOOK histograms "xml" for AIDA histograms "root" for ROOT histograms For more information on the analysis tools: http://aida.freehep.org http://www.cern.ch/PI - ----------------------------------------------------------------------- ----> How to run the example. | - batch mode: $G4WORDIR/bin/Linux-g++/Ultra UltraMacro.mac | | - Interative mode: 3) $G4WORDIR/bin/Linux-g++/Ultra | ------------------------------------------------------------------------ ----> Simulation output | if G4ANALYSIS_USE = 1 in the set-up, the output is ultra.aida | It contains: 1)1Dhistogram with the detected photons energy (eV) | 2)1Dhistogram with the number of detected photons per event | ------------------------------------------------------------------------ ----> Visualisation | a macro is provided as example of visulisation: Visualisation.mac | to run it : $G4WORKDIR/bin/Linux-g++/Ultra Visualisation.mac ------------------------------------------------------------------------ for comments and questions: bernardo@lip.pt for more info http://www.ge.infn.it/geant4/examples/ last modified: B. Tome and M.C. Espirito Santo 20/05/2004