| 1 | $Id: README,v 1.1 2007/08/16 10:32:04 vnivanch Exp $
|
|---|
| 2 | -------------------------------------------------------------------
|
|---|
| 3 |
|
|---|
| 4 | =========================================================
|
|---|
| 5 | Geant4 - an Object-Oriented Toolkit for Simulation in HEP
|
|---|
| 6 | =========================================================
|
|---|
| 7 |
|
|---|
| 8 | monopole
|
|---|
| 9 | --------
|
|---|
| 10 | V.Ivanchenko, M.Vladymyrov
|
|---|
| 11 | CERN, Geneva, Switzerland
|
|---|
| 12 | Lebedev Physical Institute, Moscow, Russia
|
|---|
| 13 |
|
|---|
| 14 |
|
|---|
| 15 | This example is devoted to the energy deposited by classical magnetic
|
|---|
| 16 | monopole.
|
|---|
| 17 |
|
|---|
| 18 |
|
|---|
| 19 |
|
|---|
| 20 | 1- GEOMETRY DEFINITION
|
|---|
| 21 |
|
|---|
| 22 | The geometry consists of a single block of a homogenous material,
|
|---|
| 23 | placed in a world.
|
|---|
| 24 |
|
|---|
| 25 | Four parameters define the geometry :
|
|---|
| 26 | - the material of the box
|
|---|
| 27 | - the thickness of the box
|
|---|
| 28 | - the tranverse dimension of the box
|
|---|
| 29 | - the maximal step size in target
|
|---|
| 30 |
|
|---|
| 31 | The default is 10 cm of alumunium, step is limited by 5mm.
|
|---|
| 32 | Equivalent UI commands are following:
|
|---|
| 33 | /testex/det/setMat G4_Al
|
|---|
| 34 | /testex/det/sizeX 10 cm
|
|---|
| 35 | /testex/det/sizeYZ 5 cm
|
|---|
| 36 | /testex/det/setStepSize 5 mm
|
|---|
| 37 |
|
|---|
| 38 | The default geometry is constructed in DetectorConstruction class,
|
|---|
| 39 | but all of the above parameters can be changed interactively via
|
|---|
| 40 | the commands defined in the DetectorMessenger class. After changing
|
|---|
| 41 | material and/or dimentions one must update the detector construction:
|
|---|
| 42 | /testex/det/update
|
|---|
| 43 |
|
|---|
| 44 | 2- PHYSICS LIST
|
|---|
| 45 |
|
|---|
| 46 | Physics Lists include standard QGSP physics and additional builder
|
|---|
| 47 | for monopole physics.
|
|---|
| 48 |
|
|---|
| 49 | 3- AN EVENT : THE PRIMARY GENERATOR
|
|---|
| 50 |
|
|---|
| 51 | The primary kinematic consists of a single particle which hits the
|
|---|
| 52 | block perpendicular to the input face. The type of the particle
|
|---|
| 53 | and its energy are set in the PrimaryGeneratorAction class, and can
|
|---|
| 54 | changed via the G4 build-in commands of ParticleGun class (see
|
|---|
| 55 | the macros provided with this example).
|
|---|
| 56 | The default is monopole 100 GeV
|
|---|
| 57 |
|
|---|
| 58 | In addition one can define randomly the impact point of the incident
|
|---|
| 59 | particle. The corresponding interactive command is built in
|
|---|
| 60 | PrimaryGeneratorMessenger class.
|
|---|
| 61 |
|
|---|
| 62 | A RUN is a set of events.
|
|---|
| 63 |
|
|---|
| 64 |
|
|---|
| 65 | 4- VISUALIZATION
|
|---|
| 66 |
|
|---|
| 67 | The Visualization Manager is set in the main() for interactive session.
|
|---|
| 68 | The initialisation of the drawing is done via the command
|
|---|
| 69 | /control/execute vis.mac
|
|---|
| 70 |
|
|---|
| 71 | The detector has a default view which is a longitudinal view of the box.
|
|---|
| 72 |
|
|---|
| 73 | The tracks are drawn at the end of event, and erased at the end of run.
|
|---|
| 74 | Optionaly one can choose to draw all particles, only the charged one,
|
|---|
| 75 | or none. This command is defined in EventActionMessenger class.
|
|---|
| 76 |
|
|---|
| 77 |
|
|---|
| 78 | 5- HOW TO START ?
|
|---|
| 79 |
|
|---|
| 80 | - compile and link to generate an executable
|
|---|
| 81 | % cd monopole
|
|---|
| 82 | % gmake
|
|---|
| 83 |
|
|---|
| 84 | - execute Test in 'batch' mode from macro files
|
|---|
| 85 | % monopole monopole.in
|
|---|
| 86 |
|
|---|
| 87 | - execute Test in 'interactive mode' with visualization
|
|---|
| 88 | % monopole
|
|---|
| 89 | ....
|
|---|
| 90 | Idle> type your commands
|
|---|
| 91 | ....
|
|---|
| 92 | Idle> exit
|
|---|
| 93 |
|
|---|
| 94 |
|
|---|
| 95 | 6- HISTOGRAMS
|
|---|
| 96 |
|
|---|
| 97 | The result is five histograms:
|
|---|
| 98 | - Monopole eneregy deposition in current material
|
|---|
| 99 | - dedx for proton
|
|---|
| 100 | - dedx for monopole
|
|---|
| 101 | - range for proton in current material
|
|---|
| 102 | - range for monopole in current material
|
|---|
| 103 |
|
|---|
| 104 | The histogram is saved in hbook (default monopole.hbook, but can be changed
|
|---|
| 105 | using testex/run/HistoName and testex/run/HistoType comands)
|
|---|
| 106 | Limit of bin size can be set with testex/run/binSize (default 5mm). Real size
|
|---|
| 107 | is chosen as a minimal between this and step limit (see Geometry section)
|
|---|
| 108 |
|
|---|
| 109 | Note that, by default, histograms are disabled. To activate them, uncomment
|
|---|
| 110 | G4ANALYSIS_USE in GNUmakefile.
|
|---|
| 111 |
|
|---|
| 112 | 7- Using histograms
|
|---|
| 113 | -------------------
|
|---|
| 114 |
|
|---|
| 115 | By default the histograms are not activated. To activate histograms
|
|---|
| 116 | the environment variable G4ANALYSIS_USE should be defined. For instance
|
|---|
| 117 | uncomment the flag G4ANALYSIS_USE in GNUmakefile.
|
|---|
| 118 |
|
|---|
| 119 | To use histograms any of implementations of AIDA interfaces should
|
|---|
| 120 | be available (see http://aida.freehep.org).
|
|---|
| 121 |
|
|---|
| 122 | A package including AIDA and extended interfaces also using Python
|
|---|
| 123 | is PI, available from: http://cern.ch/pi .
|
|---|
| 124 |
|
|---|
| 125 | Once installed PI or PI-Lite in a specified local area $MYPY, it is
|
|---|
| 126 | required to add the installation path to $PATH, i.e. for example,
|
|---|
| 127 | for release 1.2.1 of PI:
|
|---|
| 128 |
|
|---|
| 129 | setenv PATH ${PATH}:$MYPI/1.2.1/app/releases/PI/PI_1_2_1/rh73_gcc32/bin
|
|---|
| 130 |
|
|---|
| 131 | CERN users can use the PATH to the LCG area on AFS.
|
|---|
| 132 |
|
|---|
| 133 | Before compilation of the example it is optimal to clean up old files:
|
|---|
| 134 |
|
|---|
| 135 | gmake histclean
|
|---|
| 136 | gmake
|
|---|
| 137 |
|
|---|
| 138 | Before running the example the command should be issued:
|
|---|
| 139 |
|
|---|
| 140 | eval `aida-config --runtime csh`
|
|---|
| 141 |
|
|---|
