| 1 |
|
|---|
| 2 | =========================================================
|
|---|
| 3 | Geant4 - Radiation monitor example
|
|---|
| 4 | =========================================================
|
|---|
| 5 |
|
|---|
| 6 | README
|
|---|
| 7 | ---------------------
|
|---|
| 8 |
|
|---|
| 9 | 0. INTRODUCTION
|
|---|
| 10 |
|
|---|
| 11 | The Radiation monitor example derives from a Geant4 application whose scope
|
|---|
| 12 | is to study of the effects of a chip carrier on silicon radiation monitoring
|
|---|
| 13 | devices used in the LHC environment. Further details are available at the
|
|---|
| 14 |
|
|---|
| 15 | http://www.ge.infn.it/~geant4/hep/radmon
|
|---|
| 16 |
|
|---|
| 17 | website.
|
|---|
| 18 |
|
|---|
| 19 |
|
|---|
| 20 |
|
|---|
| 21 | 1. HOW TO BUILD
|
|---|
| 22 |
|
|---|
| 23 | Run gmake from the
|
|---|
| 24 |
|
|---|
| 25 | $G4INSTALL/examples/advanced/radiation_monitor
|
|---|
| 26 |
|
|---|
| 27 | directory. The executable
|
|---|
| 28 |
|
|---|
| 29 | $G4WORKDIR/bin/Radmon
|
|---|
| 30 |
|
|---|
| 31 | will be built.
|
|---|
| 32 |
|
|---|
| 33 | If you set the environment variable G4VIS_USE, the geant4 visualisation
|
|---|
| 34 | module will be build.
|
|---|
| 35 |
|
|---|
| 36 | If you set the environment variable G4ANALYSIS_USE, the analysis will be
|
|---|
| 37 | built. Analysis module is based on AIDA 3.2.1 and was tested with PI 1.3.5.
|
|---|
| 38 | Probably analysis will run also on previous AIDA versions, but it is no
|
|---|
| 39 | garateed
|
|---|
| 40 |
|
|---|
| 41 |
|
|---|
| 42 |
|
|---|
| 43 | 2. COMMAND LINE SYNTAX
|
|---|
| 44 |
|
|---|
| 45 | Run
|
|---|
| 46 |
|
|---|
| 47 | $G4WORKDIR/bin/Radmon -h
|
|---|
| 48 |
|
|---|
| 49 | for command line help. The following output will be printed out
|
|---|
| 50 | _____________________________________________________________________________
|
|---|
| 51 |
|
|---|
| 52 | Usage: Radmon [-h|-H|-?] [-b] [-v] [<filename>]
|
|---|
| 53 |
|
|---|
| 54 | -h -H -? Usage help
|
|---|
| 55 | -b Force non-interactive mode
|
|---|
| 56 | -v Verbose output
|
|---|
| 57 | <filename> Name of the macro to be run
|
|---|
| 58 |
|
|---|
| 59 | If ".startup.mac" is present, it will be run before anything else.
|
|---|
| 60 | _____________________________________________________________________________
|
|---|
| 61 |
|
|---|
| 62 | -v options adds some extra messages during initialization phase.
|
|---|
| 63 | At the end of initialization, .startup.mac file is run (if present) and then
|
|---|
| 64 | <filename> is run (if specified on the command line). After having run these
|
|---|
| 65 | two files, if -b option is omitted, the interactive session starts.
|
|---|
| 66 |
|
|---|
| 67 |
|
|---|
| 68 |
|
|---|
| 69 | 3. USER INTERFACE
|
|---|
| 70 |
|
|---|
| 71 | Geometry, Materials, Physics, Beam type, Sensible volumes, Quantities to be
|
|---|
| 72 | stored for the analysis are all defined interactively (or in macro files)
|
|---|
| 73 | through the user interface. This allows a high level of flexibility in the
|
|---|
| 74 | setup definition, without need to rebuild the code. Gemetry types, Physics
|
|---|
| 75 | list, Beam types, Quantities to be stored for the analysis are all
|
|---|
| 76 | modularired using abstract classes. If current modules satisfy your
|
|---|
| 77 | requirements, you will not need to add code, but only to modify macro files
|
|---|
| 78 | or insert commands interactively through command line.
|
|---|
| 79 |
|
|---|
| 80 | 3.1 RADMON PROPRETARY UI COMMANDS
|
|---|
| 81 |
|
|---|
| 82 | The introduced user interface commands are:
|
|---|
| 83 |
|
|---|
| 84 | /radmon/application/EnableRunsDump
|
|---|
| 85 | /radmon/application/DisableRunsDump
|
|---|
| 86 | /radmon/application/DumpEventsEvery
|
|---|
| 87 | /radmon/application/DisableEventsDump
|
|---|
| 88 | /radmon/application/EnableTracksVisualisation
|
|---|
| 89 | /radmon/application/DisableTracksVisualisation
|
|---|
| 90 | /radmon/detectorFactory/Dump
|
|---|
| 91 | /radmon/detector/EnableEnvironment
|
|---|
| 92 | /radmon/detector/DisableEnvironment
|
|---|
| 93 | /radmon/detector/SetEnvironmentType
|
|---|
| 94 | /radmon/detector/SetEnvironmentAttribute
|
|---|
| 95 | /radmon/detector/ClearEnvironmentAttribute
|
|---|
| 96 | /radmon/detector/CreateMultilayer
|
|---|
| 97 | /radmon/detector/RemoveMultilayer
|
|---|
| 98 | /radmon/detector/SetMultilayerWidth
|
|---|
| 99 | /radmon/detector/SetMultilayerHeight
|
|---|
| 100 | /radmon/detector/AppendLayerToMultilayer
|
|---|
| 101 | /radmon/detector/RemoveLayerFromMultilayer
|
|---|
| 102 | /radmon/detector/RemoveAllLayersFromMultilayer
|
|---|
| 103 | /radmon/detector/SetLayerThickness
|
|---|
| 104 | /radmon/detector/SetLayerType
|
|---|
| 105 | /radmon/detector/SetLayerAttribute
|
|---|
| 106 | /radmon/detector/ClearLayerAttribute
|
|---|
| 107 | /radmon/detector/CreatePlacement
|
|---|
| 108 | /radmon/detector/RemovePlacement
|
|---|
| 109 | /radmon/detector/SetPlacementPosition
|
|---|
| 110 | /radmon/detector/SetPlacementRotation
|
|---|
| 111 | /radmon/detector/SetRelativePlacementPosition
|
|---|
| 112 | /radmon/detector/SetRelativePlacementRotation
|
|---|
| 113 | /radmon/detector/DumpLayout
|
|---|
| 114 | /radmon/detector/Load
|
|---|
| 115 | /radmon/detector/Save
|
|---|
| 116 | /radmon/materials/CreateElement
|
|---|
| 117 | /radmon/materials/CreateMaterial
|
|---|
| 118 | /radmon/materials/AddComponentByAtoms
|
|---|
| 119 | /radmon/materials/AddComponentByFraction
|
|---|
| 120 | /radmon/materials/SetMaterialColor
|
|---|
| 121 | /radmon/materials/SetMaterialTrasparency
|
|---|
| 122 | /radmon/materials/SetMaterialVisibility
|
|---|
| 123 | /radmon/materials/SetMaterialStyle
|
|---|
| 124 | /radmon/materials/Dump
|
|---|
| 125 | /radmon/materials/Insert
|
|---|
| 126 | /radmon/materials/Save
|
|---|
| 127 | /radmon/subPhysicsListFactory/Dump
|
|---|
| 128 | /radmon/physics/AddPhysicsList
|
|---|
| 129 | /radmon/physics/RemovePhysicsList
|
|---|
| 130 | /radmon/physics/SetPhysicsListAttribute
|
|---|
| 131 | /radmon/physics/ClearPhysicsListAttribute
|
|---|
| 132 | /radmon/physics/DumpLayout
|
|---|
| 133 | /radmon/physics/Load
|
|---|
| 134 | /radmon/physics/Save
|
|---|
| 135 | /radmon/generatorsFactory/Dump
|
|---|
| 136 | /radmon/generator/InsertSource
|
|---|
| 137 | /radmon/generator/SetRelativeSourceIntensity
|
|---|
| 138 | /radmon/generator/RemoveSource
|
|---|
| 139 | /radmon/generator/AppendSourceAlgorithm
|
|---|
| 140 | /radmon/generator/SetSourceAlgorithmType
|
|---|
| 141 | /radmon/generator/RemoveSourceAlgorithm
|
|---|
| 142 | /radmon/generator/SetSourceAlgorithmAttribute
|
|---|
| 143 | /radmon/generator/ClearSourceAlgorithmAttribute
|
|---|
| 144 | /radmon/generator/Load
|
|---|
| 145 | /radmon/generator/Save
|
|---|
| 146 | /radmon/generator/DumpLayout
|
|---|
| 147 | /radmon/dataAnalysisFactory/Dump
|
|---|
| 148 | /radmon/analysis/SetOutputFileName
|
|---|
| 149 | /radmon/analysis/SetOutputFileFormat
|
|---|
| 150 | /radmon/analysis/CreateSensitiveDetector
|
|---|
| 151 | /radmon/analysis/SetSensitiveDetectorType
|
|---|
| 152 | /radmon/analysis/RemoveSensitiveDetector
|
|---|
| 153 | /radmon/analysis/CreateSensitiveDetectorType
|
|---|
| 154 | /radmon/analysis/RemoveSensitiveDetectorType
|
|---|
| 155 | /radmon/analysis/AppendDataAnalysisToSensitiveDetectorType
|
|---|
| 156 | /radmon/analysis/SetDataAnalysisType
|
|---|
| 157 | /radmon/analysis/RemoveDataAnalysis
|
|---|
| 158 | /radmon/analysis/SetDataAnalysisAttribute
|
|---|
| 159 | /radmon/analysis/ClearDataAnalysisAttribute
|
|---|
| 160 | /radmon/analysis/DumpLayout
|
|---|
| 161 | /radmon/analysis/Load
|
|---|
| 162 | /radmon/analysis/Save
|
|---|
| 163 |
|
|---|
| 164 | Details of the commands will be given in each specific section.
|
|---|
| 165 |
|
|---|
| 166 | A common feature to all the code is the presence of 'attributes'. Each
|
|---|
| 167 | module of geometry, physics, beam type, analysis can have specific
|
|---|
| 168 | parameters that define its behaviour. These parameters are set through
|
|---|
| 169 | 'attributes'. Next sections will document for each implemented module, the required and optional
|
|---|
| 170 | attributes, their meaning and their format.
|
|---|
| 171 |
|
|---|
| 172 | Everything in the Radmon application is case sensitive.
|
|---|
| 173 |
|
|---|
| 174 |
|
|---|
| 175 |
|
|---|
| 176 | 4. APPLICATION
|
|---|
| 177 |
|
|---|
| 178 | Application commands sets the behaviour of helper user actions:
|
|---|
| 179 |
|
|---|
| 180 | Command: /radmon/application/EnableRunsDump
|
|---|
| 181 | Parameters: [none]
|
|---|
| 182 | Description: Enables the print out of the run number at the begin of the run
|
|---|
| 183 |
|
|---|
| 184 | Command: /radmon/application/DisableRunsDump
|
|---|
| 185 | Parameters [none]
|
|---|
| 186 | Description: Disables the print out of the run number
|
|---|
| 187 |
|
|---|
| 188 | Command: /radmon/application/DumpEventsEvery
|
|---|
| 189 | Parameters <n> [integer]
|
|---|
| 190 | Description: Enables the print out of the event number at the beginning of
|
|---|
| 191 | the event (1 out of <n> events)
|
|---|
| 192 |
|
|---|
| 193 | Command: /radmon/application/DisableEventsDump
|
|---|
| 194 | Parameters [none]
|
|---|
| 195 | Description: Disables the print out of the event number
|
|---|
| 196 |
|
|---|
| 197 | Command: /radmon/application/EnableTracksVisualisation
|
|---|
| 198 | Parameters [none]
|
|---|
| 199 | Description: Enables the display of the tracks at the end of the run
|
|---|
| 200 | Requires: G4VIS_USE environment variable at build time
|
|---|
| 201 | See also: /vis/scene/endOfEventAction [Geant4 built-in UI command]
|
|---|
| 202 |
|
|---|
| 203 | Command: /radmon/application/DisableTracksVisualisation
|
|---|
| 204 | Parameters [none]
|
|---|
| 205 | Description: Disables the display of the tracks
|
|---|
| 206 | Requires: G4VIS_USE environment variable at build time
|
|---|
| 207 |
|
|---|
| 208 |
|
|---|
| 209 |
|
|---|
| 210 | 5. GEOMETRY
|
|---|
| 211 |
|
|---|
| 212 | Geometry is completely built interactively. Two concepts are available:
|
|---|
| 213 |
|
|---|
| 214 | - Environment
|
|---|
| 215 | - Multi-layers
|
|---|
| 216 |
|
|---|
| 217 | 5.1 ENVIRONMENT
|
|---|
| 218 |
|
|---|
| 219 | Defines the geometry in which "multi-layers" will be placed. The environment
|
|---|
| 220 | defines the world volume and eventually other volumes that are not
|
|---|
| 221 | "multi-layers" volumes. For example the "TestBeam" environment type
|
|---|
| 222 | (currently not implemented) will define all the geometries of the test beam
|
|---|
| 223 | except from the tested chips+packagings.
|
|---|
| 224 |
|
|---|
| 225 | Command: /radmon/detector/DisableEnvironment
|
|---|
| 226 | Parameters: [none]
|
|---|
| 227 | Description: Disables the usage of specific environments. The world volume
|
|---|
| 228 | will be a sphere of RADMON_VACUUM (vacuum) large enough to contain
|
|---|
| 229 | all the placed multi-layers
|
|---|
| 230 |
|
|---|
| 231 | Command: /radmon/detector/EnableEnvironment
|
|---|
| 232 | Parameters: [none]
|
|---|
| 233 | Description: Enables the usage of a specific environment. The enviroment is
|
|---|
| 234 | defined through the next commands
|
|---|
| 235 |
|
|---|
| 236 | Command: /radmon/detector/SetEnvironmentType
|
|---|
| 237 | Parameters: <type> [string]
|
|---|
| 238 | Description: Fix the environment type to the type <type>. For a list of
|
|---|
| 239 | available strings use /radmon/detectorFactory/Dump command
|
|---|
| 240 | See also: /radmon/detectorFactory/Dump (Chapter 5.3)
|
|---|
| 241 |
|
|---|
| 242 | Command: /radmon/detector/SetEnvironmentAttribute
|
|---|
| 243 | Parameters: <name> [string], <value> [string]
|
|---|
| 244 | Description: Configure the selected environment type setting the attribute
|
|---|
| 245 | <name> to the value <value>. Each environment type has its own
|
|---|
| 246 | attributes. Attributes are detailed in Chapter 5.4
|
|---|
| 247 |
|
|---|
| 248 | Command: /radmon/detector/ClearEnvironmentAttribute
|
|---|
| 249 | Parameters: <name> [string]
|
|---|
| 250 | Description: Removes the attribute <name> from the environment
|
|---|
| 251 | configuration.
|
|---|
| 252 |
|
|---|
| 253 | 5.2 MULTILAYERS
|
|---|
| 254 |
|
|---|
| 255 | Multilayers are wafer made up of different layers. Several multilayers can
|
|---|
| 256 | be defined. A instance of a multilayer is called placed multilayer. A placed
|
|---|
| 257 | multilayer has a position and a rotation relative to the world volume. More
|
|---|
| 258 | placed multilayers can be instanced for each multilayer type.
|
|---|
| 259 |
|
|---|
| 260 | 5.2.1 MULTILAYERS
|
|---|
| 261 |
|
|---|
| 262 | Command: /radmon/detector/CreateMultilayer
|
|---|
| 263 | Parameters: <name> [string]
|
|---|
| 264 | Description: Creates a multilayer with name <name>
|
|---|
| 265 |
|
|---|
| 266 | Command: /radmon/detector/RemoveMultilayer
|
|---|
| 267 | Parameters: <name> [string]
|
|---|
| 268 | Description: If defined and without placed instances, removes the multilayer
|
|---|
| 269 | named <name>. If the multilayer has placed instances. You will
|
|---|
| 270 | have to remove the placed instances with
|
|---|
| 271 | /radmon/detector/RemovePlacement command.
|
|---|
| 272 | See Also: /radmon/detector/RemovePlacement (Chapter 5.2.2)
|
|---|
| 273 |
|
|---|
| 274 | Command: /radmon/detector/SetMultilayerWidth
|
|---|
| 275 | Parameters: <name> [string], <width> [length]
|
|---|
| 276 | Description: Defines the multilayer width. the second argument is a space
|
|---|
| 277 | separated string with a real number and a unit of length
|
|---|
| 278 |
|
|---|
| 279 | Command: /radmon/detector/SetMultilayerHeight
|
|---|
| 280 | Parameters: <name> [string], <height> [length]
|
|---|
| 281 | Description: Defines the multilayer height
|
|---|
| 282 |
|
|---|
| 283 | Command: /radmon/detector/AppendLayerToMultilayer
|
|---|
| 284 | Parameters: <name> [string], <label> [string]
|
|---|
| 285 | Description: Adds a layer to the multilayer named <name>. The layer will be
|
|---|
| 286 | referenced by the label <label>
|
|---|
| 287 | The multilayer thickness is alogn the z axis. Width is along x
|
|---|
| 288 | axis and height along y axis. Appended layers are placed
|
|---|
| 289 | consecutively along the z direction. The first appended layer
|
|---|
| 290 | has a z coordinate lower than the second appended layer.
|
|---|
| 291 | AppendLayerToMultilayer stacks the layers on top of the previous
|
|---|
| 292 | ones. The origin of reference system for the multilayer is
|
|---|
| 293 | placed in its center.
|
|---|
| 294 |
|
|---|
| 295 | Example:
|
|---|
| 296 |
|
|---|
| 297 | /radmon/detector/AppendLayerToMultilayer mly1 ly1
|
|---|
| 298 | /radmon/detector/AppendLayerToMultilayer mly1 ly2
|
|---|
| 299 | /radmon/detector/AppendLayerToMultilayer mly1 ly3
|
|---|
| 300 |
|
|---|
| 301 | Width mly1
|
|---|
| 302 | <----------------------------------------->
|
|---|
| 303 | _________________________________________ ...
|
|---|
| 304 | | | ^
|
|---|
| 305 | | ly3 | | Thickness ly3
|
|---|
| 306 | |_________________ z ^ __________________|...v
|
|---|
| 307 | | | ly2 | ^ Thickness ly2
|
|---|
| 308 | |_________________ +---> x _____________|...v
|
|---|
| 309 | | O | ^
|
|---|
| 310 | | ly1 | | Thickness ly1
|
|---|
| 311 | | | |
|
|---|
| 312 | |_________________________________________|...v
|
|---|
| 313 |
|
|---|
| 314 |
|
|---|
| 315 | Command: /radmon/detector/RemoveLayerFromMultilayer
|
|---|
| 316 | Parameters: <name> [string], <label> [string]
|
|---|
| 317 | Description: Removes the layer named <label> from the multilayer named
|
|---|
| 318 | <name>
|
|---|
| 319 |
|
|---|
| 320 | Command: /radmon/detector/RemoveAllLayersFromMultilayer
|
|---|
| 321 | Parameters: <name> [string]
|
|---|
| 322 | Description: Removes all the layers form the multilayer.
|
|---|
| 323 |
|
|---|
| 324 | Command: /radmon/detector/SetLayerThickness
|
|---|
| 325 | Parameters: <name> [string], <label> [string], <thickness> [length]
|
|---|
| 326 | Description: Sets the thickness of a layer named <label> defined in
|
|---|
| 327 | multilayer named <name> to <thickness>
|
|---|
| 328 |
|
|---|
| 329 | Command: /radmon/detector/SetLayerType
|
|---|
| 330 | Parameters: <name> [string], <label> [string], <type> [string]
|
|---|
| 331 | Description: Defines the layer type for a layer named <label> defined in
|
|---|
| 332 | multilayer named <name>. The type <type> must be one of the
|
|---|
| 333 | available modules. (Chapter 5.4)
|
|---|
| 334 | See also: /radmon/detectorFactory/Dump (Chapter 5.3)
|
|---|
| 335 |
|
|---|
| 336 | Command: /radmon/detector/SetLayerAttribute
|
|---|
| 337 | Parameters: <name> [string], <label> [string], <attribute> [string],
|
|---|
| 338 | <value> [string]
|
|---|
| 339 | Description: Sets the attribute <attribute> to value <value> for a layer
|
|---|
| 340 | named <label> defined in multilayer named <name>.
|
|---|
| 341 | See also: Chapter 5.4
|
|---|
| 342 |
|
|---|
| 343 | Command: /radmon/detector/ClearLayerAttribute
|
|---|
| 344 | Parameters: <name> [string], <label> [string], <attribute> [string]
|
|---|
| 345 | Description: Removes the attribute <attribute> from a layer named <label>
|
|---|
| 346 | defined in multilayer named <name>.
|
|---|
| 347 |
|
|---|
| 348 | 5.2.2 PLACED MULTILAYERS
|
|---|
| 349 |
|
|---|
| 350 | Command: /radmon/detector/CreatePlacement
|
|---|
| 351 | Parameters: <name> [string], <type> [string]
|
|---|
| 352 | Description: Insert in the geometry a multilayer object named <type>. The
|
|---|
| 353 | inserted instance of the multilayer will be referenced though
|
|---|
| 354 | the label <name>
|
|---|
| 355 |
|
|---|
| 356 | Command: /radmon/detector/RemovePlacement
|
|---|
| 357 | Parameters: <name> [string]
|
|---|
| 358 | Description: Removes the multilayer instance named <name> from the geometry
|
|---|
| 359 |
|
|---|
| 360 | Command: /radmon/detector/SetPlacementPosition
|
|---|
| 361 | Parameters: <name> [string], <x> [real], <y> [real], <z> [real],
|
|---|
| 362 | <unit> [unit of length]
|
|---|
| 363 | Description: Set the absolute position of the multilayer instance named
|
|---|
| 364 | <name>
|
|---|
| 365 |
|
|---|
| 366 | Command: /radmon/detector/SetPlacementRotation
|
|---|
| 367 | Parameters: <name> [string], <theta> [real], <phi> [real], <delta> [real],
|
|---|
| 368 | <unit> [unit of angle]
|
|---|
| 369 | Description: Set the absolute direction of the multilayer instance named
|
|---|
| 370 | <name>. The multilayer is rtated by an angle <delta> along the
|
|---|
| 371 | axis defined by <theta> and <phi> angles
|
|---|
| 372 |
|
|---|
| 373 | Command: /radmon/detector/SetRelativePlacementPosition
|
|---|
| 374 | Parameters: <name> [string], <reference> [string], <x> [real], <y> [real],
|
|---|
| 375 | <z> [real], <unit> [unit of length]
|
|---|
| 376 | Description: Set the relative position of the multilayer instance named
|
|---|
| 377 | <name> relative to the coordinates system of another placed
|
|---|
| 378 | multilayer named <reference>
|
|---|
| 379 |
|
|---|
| 380 | Command: /radmon/detector/SetRelativePlacementRotation
|
|---|
| 381 | Parameters: <name> [string], <reference> [string], <theta> [real],
|
|---|
| 382 | <phi> [real], <delta> [real], <unit> [unit of angle]
|
|---|
| 383 | Description: Set the absolute direction of the multilayer instance named
|
|---|
| 384 | <name> relative to the coordinates system of another placed
|
|---|
| 385 | multilayer named <reference>. The multilayer is rtated by an
|
|---|
| 386 | angle <delta> along the axis defined by <theta> and <phi>
|
|---|
| 387 | angles
|
|---|
| 388 |
|
|---|
| 389 | 5.3 OTHER GEOMETRY COMMANDS
|
|---|
| 390 |
|
|---|
| 391 | Command: /radmon/detectorFactory/Dump
|
|---|
| 392 | Parameters: [none]
|
|---|
| 393 | Description: Dumps the complete list of implemented geometry modules. A
|
|---|
| 394 | geometry module can be used either for the definition of the
|
|---|
| 395 | enviroment type or for the definition of a layer type. Further
|
|---|
| 396 | details of the implemented geometry modules are available in
|
|---|
| 397 | Chapter 5.4
|
|---|
| 398 |
|
|---|
| 399 | Command: /radmon/detector/DumpLayout
|
|---|
| 400 | Parameters: [none]
|
|---|
| 401 | Description: Dumps all the details of the current geometry configuration
|
|---|
| 402 |
|
|---|
| 403 | Command: /radmon/detector/Load
|
|---|
| 404 | Parameters: <file name> [string]
|
|---|
| 405 | Description: Loads the geometry data from <file name> file
|
|---|
| 406 | Note: This command is not implemented. It is provided for further
|
|---|
| 407 | developments
|
|---|
| 408 |
|
|---|
| 409 | Command: /radmon/detector/Save
|
|---|
| 410 | Parameters: <file name> [string]
|
|---|
| 411 | Description: Stores the geometry data in <file name> file
|
|---|
| 412 | Note: This command is not implemented. It is provided for further
|
|---|
| 413 | developments
|
|---|
| 414 |
|
|---|
| 415 | 5.4 AVAILABLE GEOMETRY MODULES
|
|---|
| 416 |
|
|---|
| 417 | Available geometry modules are the following:
|
|---|
| 418 |
|
|---|
| 419 | FlatVolume
|
|---|
| 420 | FlatVolumeWithHole
|
|---|
| 421 | FlatVolumeWithGround
|
|---|
| 422 | FlatVolumeWithGroundAndKeyMarks
|
|---|
| 423 | FlatVolumeWithGroundAndKeyMarksAndHole
|
|---|
| 424 | FlatVolumeWithTracks
|
|---|
| 425 | FlatVolumeWithPins
|
|---|
| 426 | FlatVolumeWithTracksAndHole
|
|---|
| 427 | FlatVolumeWithPads
|
|---|
| 428 | CarvedFlatVolume
|
|---|
| 429 | CarvedFlatVolumeWithHole
|
|---|
| 430 | CarvedFlatVolumeWithTracks
|
|---|
| 431 | CarvedFlatVolumeWithPins
|
|---|
| 432 | CarvedFlatVolumeWithTracksAndHole
|
|---|
| 433 | CarvedFlatVolumeWithGround
|
|---|
| 434 | CarvedFlatVolumeWithGroundAndKeyMarks
|
|---|
| 435 | CarvedFlatVolumeWithGroundAndKeyMarksAndHole
|
|---|
| 436 |
|
|---|
| 437 | Technically any geometry model could be used in the environment type
|
|---|
| 438 | definition, but the only one that is really relevant is FlatVolume. All the
|
|---|
| 439 | other modules are implemented for specific packagin geometry requirements:
|
|---|
| 440 |
|
|---|
| 441 | The * symbol used in next definitions is used to group modules categories.
|
|---|
| 442 |
|
|---|
| 443 | Modules: *FlatVolume* (modules containing FlatVolume word)
|
|---|
| 444 | Description: Builds a uniform box
|
|---|
| 445 | Attributes: Width defines the box width (size along x). This
|
|---|
| 446 | attribute is needed only when the module is used
|
|---|
| 447 | in the environment definition.
|
|---|
| 448 | Height defines the box height (size along y). This
|
|---|
| 449 | attribute is needed only when the module is used
|
|---|
| 450 | in the environment definition. Sa
|
|---|
| 451 | Thickness defines the box thickness (size along z). This
|
|---|
| 452 | attribute is needed only when the module is used
|
|---|
| 453 | in the environment definition
|
|---|
| 454 | Material Defines the material type. Materials names are
|
|---|
| 455 | defined through materials commands (Chapter 6)
|
|---|
| 456 | VisAttributes [OPTIONAL] Defines the visualization style of the
|
|---|
| 457 | volume. This attribute is optional. If omitted
|
|---|
| 458 | devault material visualization style will be used
|
|---|
| 459 | (Chapter 6)
|
|---|
| 460 | SensitiveDetector [OPTIONAL] Refers to a defined sensitive
|
|---|
| 461 | detector. When particles will pass through
|
|---|
| 462 | this volume, information will be stored according to
|
|---|
| 463 | the configuration of the referred sensitive
|
|---|
| 464 | detector. See Chapter 9 for further details.
|
|---|
| 465 |
|
|---|
| 466 | Width, Height and Thikness sizes are defined by a space separated string
|
|---|
| 467 | containing a real number followed by a unit of measure for length. Example:
|
|---|
| 468 | '10.5 cm'
|
|---|
| 469 |
|
|---|
| 470 | VisAttributes has the following format:
|
|---|
| 471 |
|
|---|
| 472 | - [OPTIONAL] Either word hidden or word visible can be present. If hidden
|
|---|
| 473 | the volume will be invisible, if visible the volume will be shown
|
|---|
| 474 | - [OPTIONAL] Either word solid or word wireframe can be present. If solid
|
|---|
| 475 | the volume will be drawn as a solid volume. If wireframe, the volume will be
|
|---|
| 476 | drawn as a wireframe solid.
|
|---|
| 477 | - [OPTIONAL] 3 or 4 real numbers between 0 and 1. The 3 numbers are the red,
|
|---|
| 478 | green and blue color components. Optionally the 4th component is the alpha
|
|---|
| 479 | channel.
|
|---|
| 480 |
|
|---|
| 481 | Example: 'solid visible 1. 1. 0. 0.5' a visible solid volume yellow and 50%
|
|---|
| 482 | transparent.
|
|---|
| 483 |
|
|---|
| 484 | Modules: Carved*
|
|---|
| 485 | Description: Carves the border of the box with circular holes the holes span
|
|---|
| 486 | through the whole box thickness. Holes can be plated with
|
|---|
| 487 | another material along the z direction. Plating thickness is
|
|---|
| 488 | set through attributes
|
|---|
| 489 | Attributes: HolesAlongWidth the number (integer) of holes to apply along
|
|---|
| 490 | the x direction for each side of the box
|
|---|
| 491 | HolesAlongHeight the number (integer) of holes to apply along
|
|---|
| 492 | the y direction for each side of the box
|
|---|
| 493 | HolesRadius radius of the holes
|
|---|
| 494 | HolesStep separation between two holes
|
|---|
| 495 | DepositOnHolesThickness [OPTIONAL] thickness of the plating
|
|---|
| 496 | DepositOnHolesMaterial [OPTIONAL] material used for the
|
|---|
| 497 | plating
|
|---|
| 498 | DepositOnHolesVisAttributes [OPTIONAL] visualisation attributes
|
|---|
| 499 | used to display the plating
|
|---|
| 500 |
|
|---|
| 501 | __ |
|
|---|
| 502 | \
|
|---|
| 503 | \ |
|
|---|
| 504 | HOLE | |
|
|---|
| 505 | | <-------> HolesRadius
|
|---|
| 506 | / :____ :
|
|---|
| 507 | __/.... | \ :
|
|---|
| 508 | | ^ |__ * \ : * = DEPOSIT
|
|---|
| 509 | | | HolesStep \ \:
|
|---|
| 510 | |__.....v \ |
|
|---|
| 511 | \ ^ HOLE | |
|
|---|
| 512 | \ | HolesRadius /: |
|
|---|
| 513 | HOLE |..v __/.:./:......
|
|---|
| 514 | | | :/ : ^ DepositOnHolesThickness
|
|---|
| 515 | / |____/..:......v
|
|---|
| 516 | __/ | : :
|
|---|
| 517 | | | <--> DepositOnHolesThickness
|
|---|
| 518 | |________ _ _ _ _ _ _
|
|---|
| 519 | |
|
|---|
| 520 |
|
|---|
| 521 | Modules: *WithGround*
|
|---|
| 522 | Description: Inserts a box inside the original one, centered and made of
|
|---|
| 523 | another material. The box spans through the whole thickness of
|
|---|
| 524 | the mother volume
|
|---|
| 525 | Attributes: GroundWidth width of the ground box
|
|---|
| 526 | GroundScaleWidth [ALTERNATIVE] width of the ground box given
|
|---|
| 527 | as a fraction (real number only)
|
|---|
| 528 | GroundHeight height of the ground box
|
|---|
| 529 | GroundScaleHeight [ALTERNATIVE] height of the ground box
|
|---|
| 530 | given as a fraction
|
|---|
| 531 | GroundMaterial material used for the ground box
|
|---|
| 532 | GroundVisAttributes [OPTIONAL] visualisation attributes used to
|
|---|
| 533 | display the box
|
|---|
| 534 |
|
|---|
| 535 | Modules: *WithHole, *AndHole
|
|---|
| 536 | Description: Makes a hole inside the original volume. The hole is centered
|
|---|
| 537 | and spans through the whole thickness of the mother volume
|
|---|
| 538 | Attributes: HoleWidth width of the hole box
|
|---|
| 539 | HoleScaleWidth [ALTERNATIVE] width of the hole box given
|
|---|
| 540 | as a fraction
|
|---|
| 541 | HoleHeight height of the hole box
|
|---|
| 542 | HoleScaleHeight [ALTERNATIVE] height of the hole box given
|
|---|
| 543 | as a fraction
|
|---|
| 544 |
|
|---|
| 545 | Modules: *WithTracks
|
|---|
| 546 | Description: Adds tracks from the borders to de center tracks thickness
|
|---|
| 547 | spans through the whole thickness of the mother volume.
|
|---|
| 548 | Attributes: HolesAlongWidth See Carved*
|
|---|
| 549 | HolesAlongHeight See Carved*
|
|---|
| 550 | HolesRadius See Carved*
|
|---|
| 551 | HolesStep See Carved*
|
|---|
| 552 | TracksMaterial defines the material for the tracks
|
|---|
| 553 | TracksVisAttributes [OPTIONAL] visualisation attributes used to
|
|---|
| 554 | display the tracks
|
|---|
| 555 |
|
|---|
| 556 | Modules: *WithPins
|
|---|
| 557 | Description: Adds pins near the box borders. Pins thickness spans through
|
|---|
| 558 | the whole thickness of the mother volume.
|
|---|
| 559 | Attributes: HolesAlongWidth See Carved*
|
|---|
| 560 | HolesAlongHeight See Carved*
|
|---|
| 561 | HolesRadius See Carved*
|
|---|
| 562 | HolesStep See Carved*
|
|---|
| 563 | PinLength size of the pin in the direction orthogonal
|
|---|
| 564 | to the mother volume border
|
|---|
| 565 | MarkedPin a index between 1 and
|
|---|
| 566 | (HolesAlongWidth+HolesAlongHeight)*2
|
|---|
| 567 | identifing the pin to mark with a triangle
|
|---|
| 568 | if 0 no pins will be marked
|
|---|
| 569 | MarkedPinLength height of the triangle
|
|---|
| 570 | PinsMaterial defines the material for the pins
|
|---|
| 571 | PinsVisAttributes [OPTIONAL] visualisation attributes used to
|
|---|
| 572 | display the pins
|
|---|
| 573 |
|
|---|
| 574 | Modules: *WithPads
|
|---|
| 575 | Description: Adds pads in the box. Pads thickness spans through the whole
|
|---|
| 576 | thickness of the mother volume.
|
|---|
| 577 | Attributes: PadsWidth_<index> width of the pads. Index must be >0
|
|---|
| 578 | PadsHeight_<index> height of the pads. Index must be >0
|
|---|
| 579 | PadsMaterial_<index> material of the pads. Index must be >0
|
|---|
| 580 | PadsVisAttributes_<index> [OPTIONAL] visualisation attributes
|
|---|
| 581 | of the pads. Index must be >0
|
|---|
| 582 | PadsPosition_<index> position of the pads
|
|---|
| 583 |
|
|---|
| 584 | Pad position is a list of pads. Each pad is devined by 3 numbers grouped
|
|---|
| 585 | togheter by round brakets and separated by comma. The first number is the
|
|---|
| 586 | position along x relative to the center, the second one is the position
|
|---|
| 587 | along y relative to the center and the third (optional is a rotation angle).
|
|---|
| 588 | Example: '(0.315 mm, 0.315 mm) (0.105 mm, 0.315 mm, 10 deg)'
|
|---|
| 589 |
|
|---|
| 590 | Modules: *AndKeyMarks
|
|---|
| 591 | Description: Adds marks used to identify the pin #1.
|
|---|
| 592 | Attributes: HolesAlongWidth See Carved*
|
|---|
| 593 | HolesAlongHeight See Carved*
|
|---|
| 594 | HolesRadius See Carved*
|
|---|
| 595 | HolesStep See Carved*
|
|---|
| 596 | GroundWidth See *WithGround*
|
|---|
| 597 | GroundScaleWidth See *WithGround*
|
|---|
| 598 | GroundHeight See *WithGround*
|
|---|
| 599 | GroundScaleHeight See *WithGround*
|
|---|
| 600 | GroundMaterial See *WithGround*
|
|---|
| 601 | GroundVisAttributes See *WithGround*
|
|---|
| 602 | MarkedPinRadius the mark is a circular hole. This attribute
|
|---|
| 603 | defines thee hole radius
|
|---|
| 604 | MarkedPinStep the shift from the box border of the mark
|
|---|
| 605 | center in the direction orthogonal to the
|
|---|
| 606 | border itself
|
|---|
| 607 | MarkedPin See *WithPins
|
|---|
| 608 |
|
|---|
| 609 |
|
|---|
| 610 |
|
|---|
| 611 | 6. MATERIALS
|
|---|
| 612 |
|
|---|
| 613 | A material is defined specifing its elements, their fraction and the mass
|
|---|
| 614 | density. An element is defined by its molecular density, its atomic number.
|
|---|
| 615 | Materials and elements can be added interactively within Geant4 but cannot
|
|---|
| 616 | be removed once added.
|
|---|
| 617 |
|
|---|
| 618 | Command: /radmon/materials/CreateElement
|
|---|
| 619 | Parameters: <name> [string], <abbreviation> [string], <z> [integer],
|
|---|
| 620 | <molar density> [real], <unit> [molar density unit]
|
|---|
| 621 | Description: Creates an element according to the provided parameters
|
|---|
| 622 |
|
|---|
| 623 | Command: /radmon/materials/CreateMaterial
|
|---|
| 624 | Parameters: <name> [string], <mass density> [real],
|
|---|
| 625 | <unit> [mass density unit], <n> [integer]
|
|---|
| 626 | Description: Creates a material ccording to the provided parameters. <n> is
|
|---|
| 627 | the number of components. Components are then defined through
|
|---|
| 628 | AddComponent* commands. All <n> components must be defined
|
|---|
| 629 | using the same command (either AddComponentByAtoms or
|
|---|
| 630 | AddComponentByFraction)
|
|---|
| 631 | See also: /radmon/materials/AddComponentByAtoms,
|
|---|
| 632 | /radmon/materials/AddComponentByFraction
|
|---|
| 633 |
|
|---|
| 634 | Command: /radmon/materials/AddComponentByAtoms
|
|---|
| 635 | Parameters: <name> [string], <element> [string], <nAtoms> [integer]
|
|---|
| 636 | Description: Defines the amount of atoms of the component. <element> must be
|
|---|
| 637 | a previously defined element
|
|---|
| 638 |
|
|---|
| 639 | Command: /radmon/materials/AddComponentByFraction
|
|---|
| 640 | Parameters: <name> [string], <component> [string], <fraction> [real]
|
|---|
| 641 | Description: Defines the fraction of a specific component. <component> must
|
|---|
| 642 | be a previously defined element or material. Fractions must sum
|
|---|
| 643 | to 1
|
|---|
| 644 |
|
|---|
| 645 | Command: /radmon/materials/SetMaterialColor
|
|---|
| 646 | Parameters: <name> [string], <red> [real], <green> [real], <blue> [real]
|
|---|
| 647 | Description: Defines the default color for this material
|
|---|
| 648 |
|
|---|
| 649 | Command: /radmon/materials/SetMaterialTrasparency
|
|---|
| 650 | Parameters: <name> [string], <alpha> [real]
|
|---|
| 651 | Description: Defines the default alpha channel level for this material
|
|---|
| 652 |
|
|---|
| 653 | Command: /radmon/materials/SetMaterialVisibility
|
|---|
| 654 | Parameters: <name> [string], <mode> [string]
|
|---|
| 655 | Description: Defines the default visibility for this material. <mode> must
|
|---|
| 656 | be hidden or visible
|
|---|
| 657 |
|
|---|
| 658 | Command: /radmon/materials/SetMaterialStyle
|
|---|
| 659 | Parameters: <name> [string], <mode> [string]
|
|---|
| 660 | Description: Defines the default style for this material. <mode> must be
|
|---|
| 661 | solid or wireframe
|
|---|
| 662 |
|
|---|
| 663 | Command: /radmon/materials/Dump
|
|---|
| 664 | Parameters: [none]
|
|---|
| 665 | Description: Dumps all the details of the materials defined
|
|---|
| 666 |
|
|---|
| 667 | Command: /radmon/materials/Load
|
|---|
| 668 | Parameters: <file name> [string]
|
|---|
| 669 | Description: Loads the materials from <file name> file. Previously defined
|
|---|
| 670 | materials are kept
|
|---|
| 671 | Note: This command is not implemented. It is provided for further
|
|---|
| 672 | developments
|
|---|
| 673 |
|
|---|
| 674 | Command: /radmon/materials/Save
|
|---|
| 675 | Parameters: <file name> [string]
|
|---|
| 676 | Description: Stores the materials in <file name> file
|
|---|
| 677 | Note: This command is not implemented. It is provided for further
|
|---|
| 678 | developments
|
|---|
| 679 |
|
|---|
| 680 |
|
|---|
| 681 |
|
|---|
| 682 | 7. PHYSICS
|
|---|
| 683 |
|
|---|
| 684 | Physics must be defined before /run/initialize command. After inizialization
|
|---|
| 685 | of the Geant4 kernel no more changes can be applyed. Physics is defined
|
|---|
| 686 | recalling several modules. A system to identify mutual exclusive physics
|
|---|
| 687 | modules is provided. Even if not very used, physics modules can have
|
|---|
| 688 | attributes too.
|
|---|
| 689 |
|
|---|
| 690 | 7.1 BASIC PHYSICS COMMANDS
|
|---|
| 691 |
|
|---|
| 692 | Command: /radmon/physics/AddPhysicsList
|
|---|
| 693 | Parameters: <name> [string]
|
|---|
| 694 | Description: Inserts the physics module named <name>
|
|---|
| 695 |
|
|---|
| 696 | Command: /radmon/physics/RemovePhysicsList
|
|---|
| 697 | Parameters: <name> [string]
|
|---|
| 698 | Description: Removes the physics module named <name>
|
|---|
| 699 |
|
|---|
| 700 | Command: /radmon/physics/SetPhysicsListAttribute
|
|---|
| 701 | Parameters: <name> [string], <attribute> [string],
|
|---|
| 702 | <value> [string]
|
|---|
| 703 | Description: Sets the attribute <attribute> to value <value> in module
|
|---|
| 704 | <name>
|
|---|
| 705 |
|
|---|
| 706 | Command: /radmon/physics/ClearPhysicsListAttribute
|
|---|
| 707 | Parameters: <name> [string], <attribute> [string]
|
|---|
| 708 | Description: Removes the attribute <attribute> from module <name>
|
|---|
| 709 |
|
|---|
| 710 | 7.2 OTHER PHYSICS COMMANDS
|
|---|
| 711 |
|
|---|
| 712 | Command: /radmon/subPhysicsListFactory/Dump
|
|---|
| 713 | Parameters: [none]
|
|---|
| 714 | Description: Dumps all the available physics modules
|
|---|
| 715 |
|
|---|
| 716 | Command: /radmon/physics/DumpLayout
|
|---|
| 717 | Parameters: [none]
|
|---|
| 718 | Description: Dumps the list of selected physics modules
|
|---|
| 719 |
|
|---|
| 720 | Command: /radmon/physics/Load
|
|---|
| 721 | Parameters: <file name> [string]
|
|---|
| 722 | Description: Loads the physics from <file name> file.
|
|---|
| 723 | Note: This command is not implemented. It is provided for further
|
|---|
| 724 | developments
|
|---|
| 725 |
|
|---|
| 726 | Command: /radmon/physics/Save
|
|---|
| 727 | Parameters: <file name> [string]
|
|---|
| 728 | Description: Stores the physics in <file name> file
|
|---|
| 729 | Note: This command is not implemented. It is provided for further
|
|---|
| 730 | developments
|
|---|
| 731 |
|
|---|
| 732 | 7.3 PHYSICS MODELS
|
|---|
| 733 |
|
|---|
| 734 | Available physics models are the following:
|
|---|
| 735 |
|
|---|
| 736 | Module: ElectronEEDL
|
|---|
| 737 | Description: MultipleScattering, eIonisation, eBremsstrahlung and
|
|---|
| 738 | StepLimiter. All applied to electrons only
|
|---|
| 739 | Attributes: [none]
|
|---|
| 740 |
|
|---|
| 741 | Module: ElectronStandard
|
|---|
| 742 | Description: MultipleScattering, LowEnergyIonisation,
|
|---|
| 743 | LowEnergyBremsstrahlung and StepLimiter. All applied to
|
|---|
| 744 | electrons only.
|
|---|
| 745 | Attributes: [none]
|
|---|
| 746 |
|
|---|
| 747 | Module: PhotonStandard
|
|---|
| 748 | Description: PhotoElectricEffect, ComptonScattering, GammaConversion and
|
|---|
| 749 | StepLimiter. All applied to photons only.
|
|---|
| 750 | Attributes: [none]
|
|---|
| 751 |
|
|---|
| 752 | Module: PhotonEPDL
|
|---|
| 753 | Description: LowEnergyPhotoElectric, LowEnergyCompton,
|
|---|
| 754 | LowEnergyGammaConversion and StepLimiter. All applied to
|
|---|
| 755 | photons only.
|
|---|
| 756 | Attributes: [none]
|
|---|
| 757 |
|
|---|
| 758 | Module: PositronStandard
|
|---|
| 759 | Description: MultipleScattering, eIonisation, eBremsstrahlung,
|
|---|
| 760 | eplusAnnihilation and StepLimiter. All applied to positrons
|
|---|
| 761 | only
|
|---|
| 762 | Attributes: [none]
|
|---|
| 763 |
|
|---|
| 764 | Module: MuonStandard
|
|---|
| 765 | Description: MultipleScattering, MuIonisation, MuBremsstrahlung,
|
|---|
| 766 | MuPairProduction and StepLimiter applied both to mu+ and mu-.
|
|---|
| 767 | MuonMinusCaptureAtRest aplied to mu-.
|
|---|
| 768 | Attributes: [none]
|
|---|
| 769 |
|
|---|
| 770 | Module: TauStandard
|
|---|
| 771 | Description: MultipleScattering, hIonisation and StepLimiter applied both to
|
|---|
| 772 | tau+ and tau-.
|
|---|
| 773 | Attributes: [none]
|
|---|
| 774 |
|
|---|
| 775 | Module: Nuclear
|
|---|
| 776 | Description: ElectroNuclearReaction for electrons and positrons
|
|---|
| 777 | GammaNuclearReaction up to 3.5 GeV, it's not an aTheoFSGenerator between 3
|
|---|
| 778 | GeV and 100 TeV for photons
|
|---|
| 779 | Attributes: [none]
|
|---|
| 780 |
|
|---|
| 781 | Module: Decay
|
|---|
| 782 | Description: Unstable particles decay. G4Decay applied to all particles for
|
|---|
| 783 | which it is pertinent
|
|---|
| 784 | Attributes: [none]
|
|---|
| 785 |
|
|---|
| 786 | Module: NeutronBinary
|
|---|
| 787 | Description: Neutron processes. HadronElasticProcess, LCapture, LFission and
|
|---|
| 788 | NeutronInelasticProcess based on BinaryCascade up to 10 GeV,
|
|---|
| 789 | LENeutronInelastic between 8 and 25 GeV and QGSModel between 20
|
|---|
| 790 | GeV and 100 TeV
|
|---|
| 791 | Attributes: [none]
|
|---|
| 792 |
|
|---|
| 793 | Module: NeutronBertini
|
|---|
| 794 | Description: Neutron processes. HadronElasticProcess, LCapture, LFission and
|
|---|
| 795 | NeutronInelasticProcess based on CascadeInterface up to 3.2 GeV,
|
|---|
| 796 | LENeutronInelastic between 2.8 and 25 GeV and QGSModel between 20
|
|---|
| 797 | GeV and 100 TeV
|
|---|
| 798 | Attributes: [none]
|
|---|
| 799 |
|
|---|
| 800 | Module: HadronsBinary
|
|---|
| 801 | Description: Protons: HadronElasticProcess and ProtonInelasticProcess based
|
|---|
| 802 | on BinaryCascade up to 10 GeV, LEProtonInelastic between 8 and
|
|---|
| 803 | 25 GeV and QGSModel between 20 GeV and 100 TeV.
|
|---|
| 804 | Pi+: HadronElasticProcess, PionPlusInelasticProcess based on
|
|---|
| 805 | PiNuclearCrossSection, LEPionPlusInelastic up to 25 GeV
|
|---|
| 806 | and QGSModel between 20 GeV and 100 TeV.
|
|---|
| 807 | Pi-: HadronElasticProcess, PionMinusInelasticProcess based on
|
|---|
| 808 | PiNuclearCrossSection, LEPionMinusInelastic up to 25 GeV
|
|---|
| 809 | and QGSModel between 20 GeV and 100 TeV.
|
|---|
| 810 | Alpha: HadronElasticProcess, AlphaInelasticProcess based on
|
|---|
| 811 | Tripathi, IonShen cross-sections, LEAlphaInelastic model up to
|
|---|
| 812 | 25 GeV and BinaryLightIonReaction between 80 MeV and 110 GeV
|
|---|
| 813 | Attributes: [none]
|
|---|
| 814 |
|
|---|
| 815 | Module: HadronsBertini
|
|---|
| 816 | Description: Protons: HadronElasticProcess and ProtonInelasticProcess based
|
|---|
| 817 | on CascadeInterface up to 3.2 GeV, LEProtonInelastic between 2.8
|
|---|
| 818 | and 25 GeV and QGSModel between 20 GeV and 100 TeV.
|
|---|
| 819 | Pi+: HadronElasticProcess, PionPlusInelasticProcess based on
|
|---|
| 820 | PiNuclearCrossSection, CascadeInterface up to 3.2 GeV,
|
|---|
| 821 | LEPionPlusInelastic between 2.8 GeV and 25 GeV and QGSModel
|
|---|
| 822 | between 20 GeV and 100 TeV.
|
|---|
| 823 | Pi-: HadronElasticProcess, PionMinusInelasticProcess based on
|
|---|
| 824 | PiNuclearCrossSection, CascadeInterface up to 3.2 GeV,
|
|---|
| 825 | LEPionMinusInelastic between 2.8 GeV and 25 GeV and QGSModel
|
|---|
| 826 | between 20 GeV and 100 TeV.
|
|---|
| 827 | Alpha: HadronElasticProcess, AlphaInelasticProcess based on
|
|---|
| 828 | Tripathi, IonShen cross-sections, LEAlphaInelastic model up to
|
|---|
| 829 | 25 GeV and BinaryLightIonReaction between 80 MeV and 110 GeV
|
|---|
| 830 | Attributes: [none]
|
|---|
| 831 |
|
|---|
| 832 | Module: ICRUIonization
|
|---|
| 833 | Description: Applied to all charged long-lived non-leptons particles.
|
|---|
| 834 | MultipleScattering, hIonisation and StepLimiter
|
|---|
| 835 | Attributes: [none]
|
|---|
| 836 |
|
|---|
| 837 | Module: ProductionCuts
|
|---|
| 838 | Description: Sets productions cuts for electrons, positrons and photons.
|
|---|
| 839 | This module is enabled only if Cut attribute is defined.
|
|---|
| 840 | Attributes: Cuts cut value a string space separated containing a real
|
|---|
| 841 | number and a unit of length
|
|---|
| 842 |
|
|---|
| 843 |
|
|---|
| 844 |
|
|---|
| 845 | 8. GENERATORS
|
|---|
| 846 |
|
|---|
| 847 | The primary generation is managed through the concepts od "source" and
|
|---|
| 848 | "algorithm". With these two concepts it is possible to describe almost any kind of
|
|---|
| 849 | radiation environment.
|
|---|
| 850 |
|
|---|
| 851 | 8.1 SOURCES
|
|---|
| 852 |
|
|---|
| 853 | Each source is a copletely different particle generator. (with different
|
|---|
| 854 | geometry, energy distribution, particle type etc). Usually in simple
|
|---|
| 855 | radiation environment no more than a source will be needed.
|
|---|
| 856 |
|
|---|
| 857 | Each source is labelled and has a real value that describes the relative
|
|---|
| 858 | intensity. For each event the primary generator choose the source to use to
|
|---|
| 859 | generate primaries based on the relative intensities. On each event only one
|
|---|
| 860 | source fires primaries.
|
|---|
| 861 |
|
|---|
| 862 | Sources are defined by the following commands:
|
|---|
| 863 |
|
|---|
| 864 | Command: /radmon/generator/InsertSource
|
|---|
| 865 | Parameters: <label> [string]
|
|---|
| 866 | Description: Inserts a new source labelled <label>
|
|---|
| 867 |
|
|---|
| 868 | Command: /radmon/generator/SetRelativeSourceIntensity
|
|---|
| 869 | Parameters: <label> [string], <intensity> [real]
|
|---|
| 870 | Description: Defines the source relative intensity. Meaningful only when
|
|---|
| 871 | more than one source is defined
|
|---|
| 872 |
|
|---|
| 873 | Command: /radmon/generator/RemoveSource
|
|---|
| 874 | Parameters: <label> [string]
|
|---|
| 875 | Description: Removes the source named <label>
|
|---|
| 876 |
|
|---|
| 877 | 8.2 SOURCE ALGORITHMS
|
|---|
| 878 |
|
|---|
| 879 | Source algorithms are filters applied in sequence to the primaries in order
|
|---|
| 880 | to define the particle type, the geometry of the source the direction of the
|
|---|
| 881 | source and the energy of the primary particle.
|
|---|
| 882 |
|
|---|
| 883 | As the algorithm are applyed in sequence you can obtain convolution-like
|
|---|
| 884 | results. For example you can apply an algorithm that defines a particular
|
|---|
| 885 | energy distribution and then a second one that applies a gaussian
|
|---|
| 886 | distribution. You will obtain particles emitted by a distribution that is
|
|---|
| 887 | the convolution of the two.
|
|---|
| 888 |
|
|---|
| 889 | Algorithms non necessarely operate on one parameter (position of the
|
|---|
| 890 | vertex, particle type, energy, direction). For example a algorithm that
|
|---|
| 891 | generates primaries according a distribution funzion of energy and particle
|
|---|
| 892 | type based on tables will be provided (currently not implemented).
|
|---|
| 893 |
|
|---|
| 894 | Algorithms are class modules and can be easily extended by the developer
|
|---|
| 895 | accordin to the requirements.
|
|---|
| 896 | ____________________________________________________________________________
|
|---|
| 897 | | ____________________ ____________________ ____________________ |
|
|---|
| 898 | Initial | | Ex: Gauss. Energy | | Ex: Fix. direction | | Ex: Particle is e+ | | Final
|
|---|
| 899 | primary ==> | Source Algorithm 1 | => | Source Algorithm 2 | => | Source Algorithm 3 | ==> primary
|
|---|
| 900 | | |____________________| |____________________| |____________________| |
|
|---|
| 901 | |____________________________________________________________________________|
|
|---|
| 902 |
|
|---|
| 903 | The initial primary is alwaya one geantino with 0 energy directed in the z
|
|---|
| 904 | direction and with vertex in the origin. Applying algorithms you can change
|
|---|
| 905 | the kind of source. For example in the figure above you will obtain a
|
|---|
| 906 | positron with a specified fixed direction, with a energy that is distributed
|
|---|
| 907 | according to a gaussian with specified mean and rms and still emitted from
|
|---|
| 908 | the origin.
|
|---|
| 909 |
|
|---|
| 910 | Command: /radmon/generator/AppendSourceAlgorithm
|
|---|
| 911 | Parameters: <label> [string], <name> [string]
|
|---|
| 912 | Description: Adds an algorithm to the source <label>. The algorithm will be
|
|---|
| 913 | referenced in future commands using the name <name>
|
|---|
| 914 |
|
|---|
| 915 | Command: /radmon/generator/SetSourceAlgorithmType
|
|---|
| 916 | Parameters: <label> [string], <name> [string], <type> [string]
|
|---|
| 917 | Description: The algorithm named <name> of source <label> is set to type
|
|---|
| 918 | <type>. Type is the name of one of the available algorithms.
|
|---|
| 919 | The list of available algorithms is given by
|
|---|
| 920 | /radmon/generatorsFactory/Dump command. Chapter 8.4 provides
|
|---|
| 921 | details of the currently implemented algoritms.
|
|---|
| 922 | See also: /radmon/generatorsFactory/Dump (Chapter 8.3)
|
|---|
| 923 |
|
|---|
| 924 | Command: /radmon/generator/RemoveSourceAlgorithm
|
|---|
| 925 | Parameters: <label> [string], <name> [string]
|
|---|
| 926 | Description: Removes the algorithm named <name> from source <label>
|
|---|
| 927 |
|
|---|
| 928 | Commnad: /radmon/generator/SetSourceAlgorithmAttribute
|
|---|
| 929 | Parameters: <label> [string], <name> [string], <attribute> [string],
|
|---|
| 930 | <value> [string]
|
|---|
| 931 | Description: Sets to <value> the attribute <attribute> of algorithm <name>
|
|---|
| 932 | in source <label>. Required/optional attributes of each
|
|---|
| 933 | algorithm type are listed in Chapter 8.4
|
|---|
| 934 |
|
|---|
| 935 | Command: /radmon/generator/ClearSourceAlgorithmAttribute
|
|---|
| 936 | Parameters: <label> [string], <name> [string], <attribute> [string]
|
|---|
| 937 | Description: Removes attribute <attribute> from algorithm <name> in source
|
|---|
| 938 | <label>
|
|---|
| 939 |
|
|---|
| 940 | 8.3 OTHER GENERATOR COMMANDS
|
|---|
| 941 |
|
|---|
| 942 | Command: /radmon/generatorsFactory/Dump
|
|---|
| 943 | Parameters: [none]
|
|---|
| 944 | Description: Dumps all the available source algorithms
|
|---|
| 945 |
|
|---|
| 946 | Command: /radmon/generator/DumpLayout
|
|---|
| 947 | Parameters: [none]
|
|---|
| 948 | Description: Dumps all the details of the sources and of their algorithms
|
|---|
| 949 |
|
|---|
| 950 | Command: /radmon/generator/Load
|
|---|
| 951 | Parameters: <file name> [string]
|
|---|
| 952 | Description: Loads the generator data from <file name> file
|
|---|
| 953 | Note: This command is not implemented. It is provided for further
|
|---|
| 954 | developments
|
|---|
| 955 |
|
|---|
| 956 | Command: /radmon/generator/Save
|
|---|
| 957 | Parameters: <file name> [string]
|
|---|
| 958 | Description: Stores the generator data in <file name> file
|
|---|
| 959 | Note: This command is not implemented. It is provided for further
|
|---|
| 960 | developments
|
|---|
| 961 |
|
|---|
| 962 | 8.4 SOURCE ALGORITMS IMPLEMENTED
|
|---|
| 963 |
|
|---|
| 964 | Module: FixedPosition
|
|---|
| 965 | Description: Shifts the position of the primary vertex of the value
|
|---|
| 966 | specified
|
|---|
| 967 | Attributes: Position The shift defined by a string with three real number
|
|---|
| 968 | separated by spaces and followed by a unit of length
|
|---|
| 969 |
|
|---|
| 970 | Module: FixedDirection
|
|---|
| 971 | Description: Rotates the beam direction of a value specified
|
|---|
| 972 | Attributes: Direction The rotation matrix is defined by an axis of
|
|---|
| 973 | rotation and the angle of rotation. The Direction
|
|---|
| 974 | attribute must be a string containig three real
|
|---|
| 975 | numbers space separated and followed by a unit of
|
|---|
| 976 | angle. The first two angles are theta and phi and
|
|---|
| 977 | defines the axis, the third one is delta and defines
|
|---|
| 978 | the rotation amount.
|
|---|
| 979 | Example: Suppose this filter has in input a particle rirected
|
|---|
| 980 | along z and has "Direction"="90. 0. 90. deg". This
|
|---|
| 981 | means a rotation counter-clock wise of 90 degrees
|
|---|
| 982 | along the x axis. This means a final direction of -y
|
|---|
| 983 |
|
|---|
| 984 | Module: FixedEnergy
|
|---|
| 985 | Description: Shifts the energy of the primary particle by a specified value
|
|---|
| 986 | Attributes: Energy The energy shift is space separated string made up
|
|---|
| 987 | of a real number and a unit of energy
|
|---|
| 988 |
|
|---|
| 989 | Module: FixedParticle
|
|---|
| 990 | Description: Sets the particle type to the specified particle
|
|---|
| 991 | Attributes: Particle A string containing the name of a instantiated
|
|---|
| 992 | particle.
|
|---|
| 993 |
|
|---|
| 994 | Module: UniformSphere
|
|---|
| 995 | Description: Shifts the position of the primaries on a sphere of specified
|
|---|
| 996 | radius and rotates the direction of the primary so that a
|
|---|
| 997 | primary with direction z is roteted on the radial direction of the sphere,
|
|---|
| 998 | outward. A primary with initial direction -z, is rotated on the
|
|---|
| 999 | radial direction of the sphere, inward. The distribution of the
|
|---|
| 1000 | position of the primaries on the sphere is uniform
|
|---|
| 1001 | Attributes: Radius A string containig the length of the radius
|
|---|
| 1002 |
|
|---|
| 1003 | ^
|
|---|
| 1004 | ^ z r | 7
|
|---|
| 1005 | | \ ___ /
|
|---|
| 1006 | | / \
|
|---|
| 1007 | . ==> <-- | | -->
|
|---|
| 1008 | \___/
|
|---|
| 1009 | / \
|
|---|
| 1010 | L | J
|
|---|
| 1011 | v
|
|---|
| 1012 | _______
|
|---|
| 1013 | / \
|
|---|
| 1014 | / | \
|
|---|
| 1015 | / \ v / \
|
|---|
| 1016 | | J L |
|
|---|
| 1017 | . ==> | --> <-- |
|
|---|
| 1018 | | | 7 r |
|
|---|
| 1019 | | \ / ^ \ /
|
|---|
| 1020 | v -z \ | /
|
|---|
| 1021 | \_______/
|
|---|
| 1022 |
|
|---|
| 1023 | Module: UniformPlane
|
|---|
| 1024 | Description: Shifts the position of the primaries on a plane of specified
|
|---|
| 1025 | width, height and direction. The distribution of the position
|
|---|
| 1026 | of the primaries on the plane is uniform.
|
|---|
| 1027 | Attributes: Width width of the plane (x direction)
|
|---|
| 1028 | Height height of the plane (y direction)
|
|---|
| 1029 | Direction as in FixedDirection algorith. Defines a rotation
|
|---|
| 1030 | matrix. It will be applied to the the initial
|
|---|
| 1031 | particle direction, to the width direction and to
|
|---|
| 1032 | the height direction.
|
|---|
| 1033 |
|
|---|
| 1034 |
|
|---|
| 1035 |
|
|---|
| 1036 | 9. ANALYSIS
|
|---|
| 1037 |
|
|---|
| 1038 | This section is enabled only if G4ANALYSIS_USE is on. In order to store
|
|---|
| 1039 | data, you have to define which part of the geometry is made of sensible
|
|---|
| 1040 | volumes.
|
|---|
| 1041 |
|
|---|
| 1042 | This is done setting the attribute "SensitiveDetector" to the volumes you
|
|---|
| 1043 | are interested in (Chapter 5.4) the value of the attribute
|
|---|
| 1044 | "SensitiveDetector" must match one of the sensitive detectors defined with
|
|---|
| 1045 | the following commands. You can set more than a volume to the same sensitive
|
|---|
| 1046 | detector. Data stored for that volumes will be acculuated togheter
|
|---|
| 1047 |
|
|---|
| 1048 | As the other parts of the application, analysis is modularised too. You
|
|---|
| 1049 | can define which data you want to store. The list of the data you want to
|
|---|
| 1050 | store is collected in a entity called SensitiveDetectorType. A concrete
|
|---|
| 1051 | instance of this entity is called SensitiveDetector. As said before volumes
|
|---|
| 1052 | linked to the same SensitiveDetector accumulate data togheter. If you want
|
|---|
| 1053 | to collect the same kind of data but separately for let say two geometry
|
|---|
| 1054 | elements you'll have to define two Sensitive Detectors set them to the same
|
|---|
| 1055 | Sensitive detector type.
|
|---|
| 1056 |
|
|---|
| 1057 | 9.1 SENSITIVE DETECTOR TYPE
|
|---|
| 1058 |
|
|---|
| 1059 | Command: /radmon/analysis/CreateSensitiveDetectorType
|
|---|
| 1060 | Parameters: <type> [string]
|
|---|
| 1061 | Description: Defines a new sensitive detector type, named <type>
|
|---|
| 1062 |
|
|---|
| 1063 | Command: /radmon/analysis/RemoveSensitiveDetectorType
|
|---|
| 1064 | Parameters: <type> [string]
|
|---|
| 1065 | Description: Removes the sensitive detector type <type>
|
|---|
| 1066 |
|
|---|
| 1067 | Command: /radmon/analysis/AppendDataAnalysisToSensitiveDetectorType
|
|---|
| 1068 | Parameters: <type> [string], <label> [string]
|
|---|
| 1069 | Description: Appends to the sensitive detector type <type>, an data
|
|---|
| 1070 | type that will be labelled <label>.
|
|---|
| 1071 |
|
|---|
| 1072 | Command: /radmon/analysis/SetDataAnalysisType
|
|---|
| 1073 | Parameters: <type> [string], <label> [string], <module> [string]
|
|---|
| 1074 | Description: Sets the data labelled <label> of the sensitive detector type
|
|---|
| 1075 | <type> to the module <module>. This module will process Hits
|
|---|
| 1076 | and store data of interest for him. Modules will be detailed in
|
|---|
| 1077 | Chapter 9.4. A list of available modules can be obtained with
|
|---|
| 1078 | the command /radmon/dataAnalysisFactory/Dump
|
|---|
| 1079 | See also: /radmon/dataAnalysisFactory/Dump (Chapter 9.3)
|
|---|
| 1080 |
|
|---|
| 1081 | Command: /radmon/analysis/RemoveDataAnalysis
|
|---|
| 1082 | Parameters: <type> [string], <label> [string]
|
|---|
| 1083 | Description: Removes the data type labelled <label>, present in sensitive
|
|---|
| 1084 | detector type <type>
|
|---|
| 1085 |
|
|---|
| 1086 | Command: /radmon/analysis/SetDataAnalysisAttribute
|
|---|
| 1087 | Parameters: <type> [string], <label> [string], <attribute> [string],
|
|---|
| 1088 | <value> [string]
|
|---|
| 1089 | Description: Sets the attribute <attribute> to value <value> in the analysis
|
|---|
| 1090 | module labelled <label> of sensitive detector type <type>
|
|---|
| 1091 |
|
|---|
| 1092 | Command: /radmon/analysis/ClearDataAnalysisAttribute
|
|---|
| 1093 | Parameters: <type> [string], <label> [string], <attribute> [string]
|
|---|
| 1094 | Description: Removes attribute <attribute> from module labelled <label> of
|
|---|
| 1095 | sensitive detector type <type>
|
|---|
| 1096 |
|
|---|
| 1097 | 9.2 SENSITIVE DETECTOR
|
|---|
| 1098 |
|
|---|
| 1099 | As said in chapter 9.1 a concrete instance of a sensitive detector type is
|
|---|
| 1100 | called sensitive detector. These instances are the ones to be referenced
|
|---|
| 1101 | in the attribute "SensitiveDetector" of the geometry modules
|
|---|
| 1102 |
|
|---|
| 1103 | Command: /radmon/analysis/CreateSensitiveDetector
|
|---|
| 1104 | Parameters: <name> [string]
|
|---|
| 1105 | Description: Creates a sensitive detector with name <name>
|
|---|
| 1106 |
|
|---|
| 1107 | Command: /radmon/analysis/SetSensitiveDetectorType
|
|---|
| 1108 | Parameters: <name> [string], <type> [string]
|
|---|
| 1109 | Description: Sets the sensitive detector with name <name> to the sensitive
|
|---|
| 1110 | detector type <type>
|
|---|
| 1111 |
|
|---|
| 1112 | Command: /radmon/analysis/RemoveSensitiveDetector
|
|---|
| 1113 | Parameters: <name> [string]
|
|---|
| 1114 | Description: Removes the sensitive detector named <name>
|
|---|
| 1115 |
|
|---|
| 1116 |
|
|---|
| 1117 | 9.3 OTHER GENRATOR COMMANDS
|
|---|
| 1118 |
|
|---|
| 1119 | Command: /radmon/analysis/SetOutputFileName
|
|---|
| 1120 | Parameters: <file name> [string]
|
|---|
| 1121 | Description: Set the output file name. If this command is called after some
|
|---|
| 1122 | events, the previous file is closed and a new one will be open
|
|---|
| 1123 | when the next event is run. When analysis command are run and
|
|---|
| 1124 | the analysis setup is modified. Always the old file is closed
|
|---|
| 1125 | and a new one is open when the next event happens. If
|
|---|
| 1126 | <file name> just exists on the system <file name>_n will be
|
|---|
| 1127 | used where n is the first number > 0 for which the file does
|
|---|
| 1128 | not exists on the system
|
|---|
| 1129 |
|
|---|
| 1130 | Command: /radmon/analysis/SetOutputFileFormat
|
|---|
| 1131 | Parameters: <format> [string]
|
|---|
| 1132 | Description: This variable depends on the AIDA implementation. Possible
|
|---|
| 1133 | values for PI 1.3.5 are XML, ROOT, HBOOK
|
|---|
| 1134 |
|
|---|
| 1135 | Command: /radmon/dataAnalysisFactory/Dump
|
|---|
| 1136 | Parameters: [none]
|
|---|
| 1137 | Description: Dumps all the available physics modules
|
|---|
| 1138 |
|
|---|
| 1139 | Command: /radmon/analysis/DumpLayout
|
|---|
| 1140 | Parameters: [none]
|
|---|
| 1141 | Description: Dumps the list of selected physics modules
|
|---|
| 1142 |
|
|---|
| 1143 | Command: /radmon/analysis/Load
|
|---|
| 1144 | Parameters: <file name> [string]
|
|---|
| 1145 | Description: Loads the physics from <file name> file.
|
|---|
| 1146 | Note: This command is not implemented. It is provided for further
|
|---|
| 1147 | developments
|
|---|
| 1148 |
|
|---|
| 1149 | Command: /radmon/analysis/Save
|
|---|
| 1150 | Parameters: <file name> [string]
|
|---|
| 1151 | Description: Stores the physics in <file name> file
|
|---|
| 1152 | Note: This command is not implemented. It is provided for further
|
|---|
| 1153 | developments
|
|---|
| 1154 |
|
|---|
| 1155 | 9.4 ANALYSIS MODULES
|
|---|
| 1156 |
|
|---|
| 1157 | Module: DepositedEnergy
|
|---|
| 1158 | Description Stores the total energy deposited in the volumes on a Tuple
|
|---|
| 1159 | column called EnergyDeposit. The energy is store in MeV.
|
|---|
| 1160 | One entry per event is stored.
|
|---|
| 1161 | Attributes: [none]
|
|---|
| 1162 |
|
|---|
| 1163 |
|
|---|
| 1164 |
|
|---|
| 1165 | 10. PROVIDED MACROS
|
|---|
| 1166 |
|
|---|
| 1167 | Code comes with a large set of basic macros in order to configure basic
|
|---|
| 1168 | funcionalities:
|
|---|
| 1169 |
|
|---|
| 1170 | $G4INSTALL/examples/advanced/radiation_monitor/macros/ApplyRelativePositioning.mac
|
|---|
| 1171 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultAnalysis.mac
|
|---|
| 1172 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultBeam.mac
|
|---|
| 1173 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultGeometry.mac
|
|---|
| 1174 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultMaterials.mac
|
|---|
| 1175 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultOptions.mac
|
|---|
| 1176 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultPhysics.mac
|
|---|
| 1177 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultView.mac
|
|---|
| 1178 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DetectorsDummyGeometry.mac
|
|---|
| 1179 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DetectorsGeometry.mac
|
|---|
| 1180 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DetectorsParameters.mac
|
|---|
| 1181 | $G4INSTALL/examples/advanced/radiation_monitor/macros/DirectionalBeam.mac
|
|---|
| 1182 | $G4INSTALL/examples/advanced/radiation_monitor/macros/EnvironmentGeometry.mac
|
|---|
| 1183 | $G4INSTALL/examples/advanced/radiation_monitor/macros/PackagingDummyGeometry.mac
|
|---|
| 1184 | $G4INSTALL/examples/advanced/radiation_monitor/macros/PackagingGeometry.mac
|
|---|
| 1185 | $G4INSTALL/examples/advanced/radiation_monitor/macros/PackagingParameters.mac
|
|---|
| 1186 | $G4INSTALL/examples/advanced/radiation_monitor/macros/RadiationEnvironmentBeam.mac
|
|---|
| 1187 | $G4INSTALL/examples/advanced/radiation_monitor/macros/RelativePositioningPackaging.mac
|
|---|
| 1188 | $G4INSTALL/examples/advanced/radiation_monitor/.startup.mac
|
|---|
| 1189 |
|
|---|
| 1190 | 10.1 MACROS CALL PATH
|
|---|
| 1191 |
|
|---|
| 1192 | If
|
|---|
| 1193 |
|
|---|
| 1194 | $G4WORKDIR/bin/Radmon
|
|---|
| 1195 |
|
|---|
| 1196 | is run from
|
|---|
| 1197 |
|
|---|
| 1198 | $G4INSTALL/examples/advanced/radiation_monitor
|
|---|
| 1199 |
|
|---|
| 1200 | the following macros are run in the following order. The three structure
|
|---|
| 1201 | helps undestanding which macro runs the other "sub"-macros.
|
|---|
| 1202 |
|
|---|
| 1203 | .startup.mac
|
|---|
| 1204 | |- macros/DefaultOptions.mac
|
|---|
| 1205 | |
|
|---|
| 1206 | |- macros/DefaultPhysics.mac
|
|---|
| 1207 |
|
|---|
| 1208 | -- Run Manager Initialization --
|
|---|
| 1209 |
|
|---|
| 1210 | |- macros/DefaultBeam.mac
|
|---|
| 1211 | | \- macros/RadiationEnvironmentBeam.mac -or- macros/DirectionalBeam.mac
|
|---|
| 1212 | |
|
|---|
| 1213 | |- macros/DefaultMaterials.mac
|
|---|
| 1214 | |
|
|---|
| 1215 | |- [DISABLED] macros/DefaultView.mac
|
|---|
| 1216 | |
|
|---|
| 1217 | |- macros/DefaultGeometry.mac
|
|---|
| 1218 | | |- macros/EnvironmentGeometry.mac
|
|---|
| 1219 | | |- macros/DetectorsGeometry.mac -or- macros/DetectorsDummyGeometry.mac
|
|---|
| 1220 | | | \- macros/DetectorsParameters.mac \- macros/DetectorsParameters.mac
|
|---|
| 1221 | | |- macros/PackagingGeometry.mac -or- macros/PackagingDummyGeometry.mac
|
|---|
| 1222 | | | \- macros/PackagingParameters.mac \- macros/PackagingParameters.mac
|
|---|
| 1223 | | |- macros/RelativePositioningPackaging.mac
|
|---|
| 1224 | | \- macros/ApplyRelativePositioning.mac
|
|---|
| 1225 | |
|
|---|
| 1226 | \- macros/DefaultAnalysis.mac
|
|---|
| 1227 |
|
|---|
| 1228 | 10.2 MACROS DETAILS
|
|---|
| 1229 |
|
|---|
| 1230 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/.startup.mac
|
|---|
| 1231 | Description: Calls the macros collecting commands for each particular
|
|---|
| 1232 | section of the application. Calls /run/initialize after Physics
|
|---|
| 1233 | setup
|
|---|
| 1234 |
|
|---|
| 1235 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultOptions.mac
|
|---|
| 1236 | Description: Sets messaging options using Geant4 built-in commands and
|
|---|
| 1237 | Radmon commands
|
|---|
| 1238 |
|
|---|
| 1239 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultPhysics.mac
|
|---|
| 1240 | Description: Defines the physics list Low Energy modules for electrons and
|
|---|
| 1241 | photons, Standard modules for Positrons and Muons, Binary
|
|---|
| 1242 | models for hadrons, ICRU models for ions.
|
|---|
| 1243 |
|
|---|
| 1244 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultBeam.mac
|
|---|
| 1245 | Description: Calls one between RadiationEnvironmentBeam and DirectionalBeam
|
|---|
| 1246 |
|
|---|
| 1247 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/RadiationEnvironmentBeam.mac
|
|---|
| 1248 | Description: 250 MeV protons emitted from a sphere centered in the origin,
|
|---|
| 1249 | with radius 2 cm and with protons directed radially inward.
|
|---|
| 1250 | _______
|
|---|
| 1251 | / \
|
|---|
| 1252 | / | \
|
|---|
| 1253 | / \ v / \
|
|---|
| 1254 | | J L |
|
|---|
| 1255 | | --> <-- |....
|
|---|
| 1256 | | 7 r | ^
|
|---|
| 1257 | \ / ^ \ / | 2 cm
|
|---|
| 1258 | \ | / |
|
|---|
| 1259 | \_______/.......v
|
|---|
| 1260 |
|
|---|
| 1261 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DirectionalBeam.mac
|
|---|
| 1262 | Description: 250 MeV protons emitted from a plane of size 1.2x1.2 cm^2,
|
|---|
| 1263 | placed at -2 cm on the z direction, orthogonal to the z
|
|---|
| 1264 | direction, with particles emitted parallel to the z direction
|
|---|
| 1265 | itself
|
|---|
| 1266 |
|
|---|
| 1267 | ^ y Beam direction
|
|---|
| 1268 | | /| -->
|
|---|
| 1269 | / | ^ y 7 x
|
|---|
| 1270 | ... / | 7 x | /
|
|---|
| 1271 | ^ | . | / . --> z
|
|---|
| 1272 | | | | Origin
|
|---|
| 1273 | 1.2 cm | | :/ :
|
|---|
| 1274 | | | : :
|
|---|
| 1275 | v...|/: :
|
|---|
| 1276 | <-------------------->
|
|---|
| 1277 | 2 cm
|
|---|
| 1278 |
|
|---|
| 1279 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultMaterials.mac
|
|---|
| 1280 | Description: Defines materials needed by the geometry
|
|---|
| 1281 | Elements: H, C, N, O, Na, Al, Si, Ar, Ca, Fe, Cu, W, Au, Pb
|
|---|
| 1282 | Materials: Aluminum, Tungsten, Copper, Gold, Water, EpoxyGlass,
|
|---|
| 1283 | Air, Alumina
|
|---|
| 1284 |
|
|---|
| 1285 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultView.mac
|
|---|
| 1286 | Description: Opens a OPENGL Viewer. Commented parts opens a Raytracing
|
|---|
| 1287 | viewer.
|
|---|
| 1288 |
|
|---|
| 1289 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultGeometry.mac
|
|---|
| 1290 | Description: Calls EnvironmentGeometry, Detectors[Dummy]Geometry,
|
|---|
| 1291 | Packaging[Dummy]Geometry, defines and then places the
|
|---|
| 1292 | multilayers using RelativePositioningPackaging and
|
|---|
| 1293 | ApplyRelativePositioning
|
|---|
| 1294 |
|
|---|
| 1295 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/EnvironmentGeometry.mac
|
|---|
| 1296 | Description: A box of air of 5x5x5 cm3
|
|---|
| 1297 |
|
|---|
| 1298 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DetectorsGeometry.mac
|
|---|
| 1299 | Description: The detailed geometry of REM-TOT-500 and LAAS chips. See
|
|---|
| 1300 | http://www.ge.infn.it/~geant4/hep/radmon/ for a picture of the
|
|---|
| 1301 | chips. Chips dimensions are set using aliases. Aliases
|
|---|
| 1302 | definition is in DetectorsParameters
|
|---|
| 1303 |
|
|---|
| 1304 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DetectorsDummyGeometry.mac
|
|---|
| 1305 | Description: An alternative geometry for the detectors. This geometry is
|
|---|
| 1306 | simpler (less detailed) and fills the same volume (width,
|
|---|
| 1307 | height and thickness) the non-dummy geometry is usefull to
|
|---|
| 1308 | place relatively volumes using OGLSX viewer. This viewer does
|
|---|
| 1309 | not fully support booleans operations heavily used in
|
|---|
| 1310 | geometries defined in non-dummy macros
|
|---|
| 1311 |
|
|---|
| 1312 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DetectorsParameters.mac
|
|---|
| 1313 | Description: Aliases needed in the chip geometry definition
|
|---|
| 1314 |
|
|---|
| 1315 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/PackagingGeometry.mac
|
|---|
| 1316 | Description: The detailed geometry of MIL-STD-105D packaging. See
|
|---|
| 1317 | http://www.ge.infn.it/~geant4/hep/radmon/ for a picture of the
|
|---|
| 1318 | packaging. Packaging dimensions are set using aliases. Aliases
|
|---|
| 1319 | definition is in PackagingParameters
|
|---|
| 1320 |
|
|---|
| 1321 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/PackagingDummyGeometry.mac
|
|---|
| 1322 | Description: An alternative geometry for the packaging. This geometry is
|
|---|
| 1323 | simpler (less detailed) and fills the same volume (width,
|
|---|
| 1324 | height and thickness) of the non-dummy geometry is usefull to
|
|---|
| 1325 | place relatively volumes using OGLSX viewer. This viewer does
|
|---|
| 1326 | not fully support booleans operations heavily used in
|
|---|
| 1327 | geometries defined in non-dummy macros
|
|---|
| 1328 |
|
|---|
| 1329 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/PackagingParameters.mac
|
|---|
| 1330 | Description: Aliases needed in the packagin geometry definition
|
|---|
| 1331 |
|
|---|
| 1332 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/RelativePositioningPackaging.mac
|
|---|
| 1333 | Description: Relative positioning aliases. Needed in the relative
|
|---|
| 1334 | positioning of chips respect to the packaging. These aliases
|
|---|
| 1335 | are used by ApplyRelativePositioning macro
|
|---|
| 1336 |
|
|---|
| 1337 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/ApplyRelativePositioning.mac
|
|---|
| 1338 | Description: Sets the position of four chips (2 LAAS and 2 REM-TOT-500)
|
|---|
| 1339 | relative to the packaging position
|
|---|
| 1340 |
|
|---|
| 1341 | Macro: $G4INSTALL/examples/advanced/radiation_monitor/macros/DefaultAnalysis.mac
|
|---|
| 1342 | Description: Sets REM-TOT-500 and LAAS volumes sensitive. Energy deposited
|
|---|
| 1343 | by particles transversing these volumes will be accumulated and
|
|---|
| 1344 | stored for each event in analysis.hbook file. An ntuple will be
|
|---|
| 1345 | created.
|
|---|
| 1346 |
|
|---|
| 1347 |
|
|---|
| 1348 |
|
|---|
| 1349 | 11. TO DO
|
|---|
| 1350 | - High precision neutron physics module
|
|---|
| 1351 | - Alternative analysis modules
|
|---|
| 1352 | - Improve analysis capabilities
|
|---|
| 1353 | - Alternative beam generation algorithms
|
|---|
| 1354 | _____________________________________________________________________________
|
|---|
| 1355 |
|
|---|
| 1356 | Author: Riccardo Capra <capra@riccardo-capra.it>
|
|---|
| 1357 | Date: 06 December 2005
|
|---|
| 1358 |
|
|---|
| 1359 | This file in HTML format and further details ared available at
|
|---|
| 1360 | http://www.ge.infn.it/~geant4/hep/radmon/
|
|---|
