| 1 | /control/manual /run
|
|---|
| 2 | Command directory path : /run/
|
|---|
| 3 |
|
|---|
| 4 |
|
|---|
| 5 | Guidance :
|
|---|
| 6 | Run control commands.
|
|---|
| 7 |
|
|---|
| 8 | Sub-directories :
|
|---|
| 9 | /run/particle/ Commands for G4VUserPhysicsList.
|
|---|
| 10 | Commands :
|
|---|
| 11 | initialize * Initialize G4 kernel.
|
|---|
| 12 | beamOn * Start a Run.
|
|---|
| 13 | verbose * Set the Verbose level of G4RunManager.
|
|---|
| 14 | dumpRegion * Dump region information.
|
|---|
| 15 | dumpCouples * Dump material-cuts-couple information.
|
|---|
| 16 | optimizeGeometry * Set the optimization flag for geometry.
|
|---|
| 17 | breakAtBeginOfEvent * Set a break point at the begining of every event.
|
|---|
| 18 | breakAtEndOfEvent * Set a break point at the end of every event.
|
|---|
| 19 | abort * Abort current run processing.
|
|---|
| 20 | abortCurrentEvent * Abort currently processing event.
|
|---|
| 21 | geometryModified * Force geometry to be closed again.
|
|---|
| 22 | cutoffModified * Force closssection tables to be calculated again.
|
|---|
| 23 | randomNumberStatusDirectory * Define the directory name of the rndm status files.
|
|---|
| 24 | storeRandomNumberStatus * The randomNumberStatus will be saved at :
|
|---|
| 25 | restoreRandomNumberStatus * Reset the status of the rndm engine from a file.
|
|---|
| 26 | setCut * Set default cut value
|
|---|
| 27 | setCutForRegion * Set cut value for a region
|
|---|
| 28 |
|
|---|
| 29 |
|
|---|
| 30 | Command /run/initialize
|
|---|
| 31 | Guidance :
|
|---|
| 32 | Initialize G4 kernel.
|
|---|
| 33 |
|
|---|
| 34 |
|
|---|
| 35 |
|
|---|
| 36 | Command /run/beamOn
|
|---|
| 37 | Guidance :
|
|---|
| 38 | Start a Run.
|
|---|
| 39 | If G4 kernel is not initialized, it will be initialized.
|
|---|
| 40 | Default number of events to be processed is 1.
|
|---|
| 41 | The second and third arguments can be used for
|
|---|
| 42 | executing a macro file at the end of each event.
|
|---|
| 43 | If the second argument, i.e. name of the macro
|
|---|
| 44 | file, is given but the third argument is not,
|
|---|
| 45 | the macro file will be executed for all of the
|
|---|
| 46 | event.
|
|---|
| 47 | If the third argument (nSelect) is given, the
|
|---|
| 48 | macro file will be executed only for the first
|
|---|
| 49 | nSelect events.
|
|---|
| 50 |
|
|---|
| 51 | Parameter : numberOfEvent
|
|---|
| 52 | Parameter type : i
|
|---|
| 53 | Omittable : True
|
|---|
| 54 | Default value : 1
|
|---|
| 55 | Parameter range : numberOfEvent >= 0
|
|---|
| 56 |
|
|---|
| 57 | Parameter : macroFile
|
|---|
| 58 | Parameter type : s
|
|---|
| 59 | Omittable : True
|
|---|
| 60 | Default value : ***NULL***
|
|---|
| 61 |
|
|---|
| 62 | Parameter : nSelect
|
|---|
| 63 | Parameter type : i
|
|---|
| 64 | Omittable : True
|
|---|
| 65 | Default value : -1
|
|---|
| 66 | Parameter range : nSelect>=-1
|
|---|
| 67 |
|
|---|
| 68 |
|
|---|
| 69 |
|
|---|
| 70 | Command /run/verbose
|
|---|
| 71 | Guidance :
|
|---|
| 72 | Set the Verbose level of G4RunManager.
|
|---|
| 73 | 0 : Silent (default)
|
|---|
| 74 | 1 : Display main topics
|
|---|
| 75 | 2 : Display main topics and run summary
|
|---|
| 76 | Range of parameters : level >=0 && level <=2
|
|---|
| 77 |
|
|---|
| 78 | Parameter : level
|
|---|
| 79 | Parameter type : i
|
|---|
| 80 | Omittable : True
|
|---|
| 81 | Default value : 0
|
|---|
| 82 |
|
|---|
| 83 |
|
|---|
| 84 |
|
|---|
| 85 | Command /run/dumpRegion
|
|---|
| 86 | Guidance :
|
|---|
| 87 | Dump region information.
|
|---|
| 88 | In case name of a region is not given, all regions will be displayed.
|
|---|
| 89 |
|
|---|
| 90 | Parameter : regionName
|
|---|
| 91 | Parameter type : s
|
|---|
| 92 | Omittable : True
|
|---|
| 93 | Default value : **ALL**
|
|---|
| 94 |
|
|---|
| 95 |
|
|---|
| 96 |
|
|---|
| 97 | Command /run/dumpCouples
|
|---|
| 98 | Guidance :
|
|---|
| 99 | Dump material-cuts-couple information.
|
|---|
| 100 | Note that material-cuts-couple information is updated
|
|---|
| 101 | after BeamOn has started.
|
|---|
| 102 |
|
|---|
| 103 |
|
|---|
| 104 |
|
|---|
| 105 | Command /run/optimizeGeometry
|
|---|
| 106 | Guidance :
|
|---|
| 107 | Set the optimization flag for geometry.
|
|---|
| 108 | If it is set to TRUE, G4GeometryManager will optimize
|
|---|
| 109 | the geometry definitions.
|
|---|
| 110 | GEANT4 is initialized with this flag as TRUE.
|
|---|
| 111 |
|
|---|
| 112 | Parameter : optimizeFlag
|
|---|
| 113 | Parameter type : b
|
|---|
| 114 | Omittable : True
|
|---|
| 115 | Default value : 1
|
|---|
| 116 |
|
|---|
| 117 |
|
|---|
| 118 |
|
|---|
| 119 | Command /run/breakAtBeginOfEvent
|
|---|
| 120 | Guidance :
|
|---|
| 121 | Set a break point at the begining of every event.
|
|---|
| 122 |
|
|---|
| 123 | Parameter : flag
|
|---|
| 124 | Parameter type : b
|
|---|
| 125 | Omittable : True
|
|---|
| 126 | Default value : 1
|
|---|
| 127 |
|
|---|
| 128 |
|
|---|
| 129 |
|
|---|
| 130 | Command /run/breakAtEndOfEvent
|
|---|
| 131 | Guidance :
|
|---|
| 132 | Set a break point at the end of every event.
|
|---|
| 133 |
|
|---|
| 134 | Parameter : flag
|
|---|
| 135 | Parameter type : b
|
|---|
| 136 | Omittable : True
|
|---|
| 137 | Default value : 1
|
|---|
| 138 |
|
|---|
| 139 |
|
|---|
| 140 |
|
|---|
| 141 | Command /run/abort
|
|---|
| 142 | Guidance :
|
|---|
| 143 | Abort current run processing.
|
|---|
| 144 | If softAbort is false (default), currently processing event will be immediately aborted,
|
|---|
| 145 | while softAbort is true, abortion occurs after processing the current event.
|
|---|
| 146 |
|
|---|
| 147 | Parameter : softAbort
|
|---|
| 148 | Parameter type : b
|
|---|
| 149 | Omittable : True
|
|---|
| 150 | Default value : 0
|
|---|
| 151 |
|
|---|
| 152 |
|
|---|
| 153 |
|
|---|
| 154 | Command /run/abortCurrentEvent
|
|---|
| 155 | Guidance :
|
|---|
| 156 | Abort currently processing event.
|
|---|
| 157 |
|
|---|
| 158 |
|
|---|
| 159 |
|
|---|
| 160 | Command /run/geometryModified
|
|---|
| 161 | Guidance :
|
|---|
| 162 | Force geometry to be closed again.
|
|---|
| 163 | This command must be applied
|
|---|
| 164 | if geometry has been modified after the
|
|---|
| 165 | first initialization (or BeamOn).
|
|---|
| 166 |
|
|---|
| 167 |
|
|---|
| 168 |
|
|---|
| 169 | Command /run/cutoffModified
|
|---|
| 170 | Guidance :
|
|---|
| 171 | Force closssection tables to be calculated again.
|
|---|
| 172 | This command must be applied
|
|---|
| 173 | if cutoff value(s) have been modified after the
|
|---|
| 174 | first initialization (or BeamOn).
|
|---|
| 175 |
|
|---|
| 176 |
|
|---|
| 177 |
|
|---|
| 178 | Command /run/randomNumberStatusDirectory
|
|---|
| 179 | Guidance :
|
|---|
| 180 | Define the directory name of the rndm status files.
|
|---|
| 181 | Directory must be creates before storing the files.
|
|---|
| 182 |
|
|---|
| 183 | Parameter : fileName
|
|---|
| 184 | Parameter type : s
|
|---|
| 185 | Omittable : True
|
|---|
| 186 | Default value : ./
|
|---|
| 187 |
|
|---|
| 188 |
|
|---|
| 189 |
|
|---|
| 190 | Command /run/storeRandomNumberStatus
|
|---|
| 191 | Guidance :
|
|---|
| 192 | The randomNumberStatus will be saved at :
|
|---|
| 193 | begining of run (currentRun.rndm) and begining of event (currentEvent.rndm)
|
|---|
| 194 |
|
|---|
| 195 | Parameter : flag
|
|---|
| 196 | Parameter type : i
|
|---|
| 197 | Omittable : True
|
|---|
| 198 | Default value : 1
|
|---|
| 199 |
|
|---|
| 200 |
|
|---|
| 201 |
|
|---|
| 202 | Command /run/restoreRandomNumberStatus
|
|---|
| 203 | Guidance :
|
|---|
| 204 | Reset the status of the rndm engine from a file.
|
|---|
| 205 | See CLHEP manual for detail.
|
|---|
| 206 | The engine status must be stored beforehand.
|
|---|
| 207 | Directory of the status file should be set by /random/setDirectoryName.
|
|---|
| 208 |
|
|---|
| 209 | Parameter : fileName
|
|---|
| 210 | Parameter type : s
|
|---|
| 211 | Omittable : True
|
|---|
| 212 | Default value : currentRun.rndm
|
|---|
| 213 |
|
|---|
| 214 |
|
|---|
| 215 |
|
|---|
| 216 | Command /run/setCut
|
|---|
| 217 | Guidance :
|
|---|
| 218 | Set default cut value
|
|---|
| 219 | Range of parameters : cut >0.0
|
|---|
| 220 |
|
|---|
| 221 | Parameter : cut
|
|---|
| 222 | Parameter type : d
|
|---|
| 223 | Omittable : False
|
|---|
| 224 | Default value : 1
|
|---|
| 225 |
|
|---|
| 226 | Parameter : Unit
|
|---|
| 227 | Parameter type : s
|
|---|
| 228 | Omittable : True
|
|---|
| 229 | Default value : mm
|
|---|
| 230 | Candidates : pc km m cm mm mum nm Ang fm parsec kilometer meter centimeter millimeter micrometer nanometer angstrom fermi
|
|---|
| 231 |
|
|---|
| 232 |
|
|---|
| 233 |
|
|---|
| 234 | Command /run/setCutForRegion
|
|---|
| 235 | Guidance :
|
|---|
| 236 | Set cut value for a region
|
|---|
| 237 |
|
|---|
| 238 | Parameter : Region
|
|---|
| 239 | Parameter type : s
|
|---|
| 240 | Omittable : False
|
|---|
| 241 |
|
|---|
| 242 | Parameter : cut
|
|---|
| 243 | Parameter type : d
|
|---|
| 244 | Omittable : False
|
|---|
| 245 | Parameter range : cut >0.0
|
|---|
| 246 |
|
|---|
| 247 | Parameter : Unit
|
|---|
| 248 | Parameter type : s
|
|---|
| 249 | Omittable : True
|
|---|
| 250 | Default value : mm
|
|---|
| 251 | Candidates : pc km m cm mm mum nm Ang fm parsec kilometer meter centimeter millimeter micrometer nanometer angstrom fermi
|
|---|
| 252 |
|
|---|
| 253 | Command directory path : /run/particle/
|
|---|
| 254 |
|
|---|
| 255 |
|
|---|
| 256 | Guidance :
|
|---|
| 257 | Commands for G4VUserPhysicsList.
|
|---|
| 258 |
|
|---|
| 259 | Sub-directories :
|
|---|
| 260 | Commands :
|
|---|
| 261 | verbose * Set the Verbose level of G4VUserPhysicsList.
|
|---|
| 262 | setCut * Set default cut value
|
|---|
| 263 | dumpList * Dump List of particles in G4VUserPhysicsList.
|
|---|
| 264 | addProcManager * add process manager to specified particle type
|
|---|
| 265 | buildPhysicsTable * build physics table of specified particle type
|
|---|
| 266 | storePhysicsTable * Store Physics Table
|
|---|
| 267 | retrievePhysicsTable * Retrieve Physics Table
|
|---|
| 268 | setStoredInAscii * Switch on/off ascii mode in store/retreive Physics Table
|
|---|
| 269 | applyCuts * Set applyCuts flag for a particle.
|
|---|
| 270 | dumpCutValues * Dump a list of production threshold values in range and energy
|
|---|
| 271 |
|
|---|
| 272 |
|
|---|
| 273 | Command /run/particle/verbose
|
|---|
| 274 | Guidance :
|
|---|
| 275 | Set the Verbose level of G4VUserPhysicsList.
|
|---|
| 276 | 0 : Silent (default)
|
|---|
| 277 | 1 : Display warning messages
|
|---|
| 278 | 2 : Display more
|
|---|
| 279 | Range of parameters : level >=0 && level <=3
|
|---|
| 280 |
|
|---|
| 281 | Parameter : level
|
|---|
| 282 | Parameter type : i
|
|---|
| 283 | Omittable : True
|
|---|
| 284 | Default value : 0
|
|---|
| 285 |
|
|---|
| 286 |
|
|---|
| 287 |
|
|---|
| 288 | Command /run/particle/setCut
|
|---|
| 289 | Guidance :
|
|---|
| 290 | Set default cut value
|
|---|
| 291 | This command is equivallent to /run/setCut command.
|
|---|
| 292 | This command is kept for backward compatibility.
|
|---|
| 293 | Range of parameters : cut >0.0
|
|---|
| 294 |
|
|---|
| 295 | Parameter : cut
|
|---|
| 296 | Parameter type : d
|
|---|
| 297 | Omittable : False
|
|---|
| 298 | Default value : 1
|
|---|
| 299 |
|
|---|
| 300 | Parameter : Unit
|
|---|
| 301 | Parameter type : s
|
|---|
| 302 | Omittable : True
|
|---|
| 303 | Default value : mm
|
|---|
| 304 | Candidates : pc km m cm mm mum nm Ang fm parsec kilometer meter centimeter millimeter micrometer nanometer angstrom fermi
|
|---|
| 305 |
|
|---|
| 306 |
|
|---|
| 307 |
|
|---|
| 308 | Command /run/particle/dumpList
|
|---|
| 309 | Guidance :
|
|---|
| 310 | Dump List of particles in G4VUserPhysicsList.
|
|---|
| 311 |
|
|---|
| 312 |
|
|---|
| 313 |
|
|---|
| 314 | Command /run/particle/addProcManager
|
|---|
| 315 | Guidance :
|
|---|
| 316 | add process manager to specified particle type
|
|---|
| 317 |
|
|---|
| 318 | Parameter : particleType
|
|---|
| 319 | Parameter type : s
|
|---|
| 320 | Omittable : True
|
|---|
| 321 |
|
|---|
| 322 |
|
|---|
| 323 |
|
|---|
| 324 | Command /run/particle/buildPhysicsTable
|
|---|
| 325 | Guidance :
|
|---|
| 326 | build physics table of specified particle type
|
|---|
| 327 |
|
|---|
| 328 | Parameter : particleType
|
|---|
| 329 | Parameter type : s
|
|---|
| 330 | Omittable : True
|
|---|
| 331 |
|
|---|
| 332 |
|
|---|
| 333 |
|
|---|
| 334 | Command /run/particle/storePhysicsTable
|
|---|
| 335 | Guidance :
|
|---|
| 336 | Store Physics Table
|
|---|
| 337 | Enter directory name
|
|---|
| 338 |
|
|---|
| 339 | Parameter : dirName
|
|---|
| 340 | Parameter type : s
|
|---|
| 341 | Omittable : True
|
|---|
| 342 |
|
|---|
| 343 |
|
|---|
| 344 |
|
|---|
| 345 | Command /run/particle/retrievePhysicsTable
|
|---|
| 346 | Guidance :
|
|---|
| 347 | Retrieve Physics Table
|
|---|
| 348 | Enter directory name or OFF to switch off
|
|---|
| 349 |
|
|---|
| 350 | Parameter : dirName
|
|---|
| 351 | Parameter type : s
|
|---|
| 352 | Omittable : True
|
|---|
| 353 |
|
|---|
| 354 |
|
|---|
| 355 |
|
|---|
| 356 | Command /run/particle/setStoredInAscii
|
|---|
| 357 | Guidance :
|
|---|
| 358 | Switch on/off ascii mode in store/retreive Physics Table
|
|---|
| 359 | Enter 0(binary) or 1(ascii)
|
|---|
| 360 | Range of parameters : ascii ==0 || ascii ==1
|
|---|
| 361 |
|
|---|
| 362 | Parameter : ascii
|
|---|
| 363 | Parameter type : i
|
|---|
| 364 | Omittable : True
|
|---|
| 365 | Default value : 0
|
|---|
| 366 |
|
|---|
| 367 |
|
|---|
| 368 |
|
|---|
| 369 | Command /run/particle/applyCuts
|
|---|
| 370 | Guidance :
|
|---|
| 371 | Set applyCuts flag for a particle.
|
|---|
| 372 | Some EM processes which do not have infrared divergence
|
|---|
| 373 | may generate gamma, e- and/or e+ with kinetic energies
|
|---|
| 374 | below the production threshold. By setting this flag,
|
|---|
| 375 | such secondaries below threshold are eliminated and
|
|---|
| 376 | kinetic energies of such secondaries are accumulated
|
|---|
| 377 | to the energy deposition of their mother.
|
|---|
| 378 | Note that 'applyCuts' makes sense only for gamma,
|
|---|
| 379 | e- and e+. If this command is issued for other particle,
|
|---|
| 380 | a warning message is displayed and the command is
|
|---|
| 381 | ignored.
|
|---|
| 382 | If particle name is 'all', this command affects on
|
|---|
| 383 | gamma, e- and e+.
|
|---|
| 384 |
|
|---|
| 385 | Parameter : Flag
|
|---|
| 386 | Parameter type : s
|
|---|
| 387 | Omittable : True
|
|---|
| 388 | Default value : true
|
|---|
| 389 |
|
|---|
| 390 | Parameter : Particle
|
|---|
| 391 | Parameter type : s
|
|---|
| 392 | Omittable : True
|
|---|
| 393 | Default value : all
|
|---|
| 394 |
|
|---|
| 395 |
|
|---|
| 396 |
|
|---|
| 397 | Command /run/particle/dumpCutValues
|
|---|
| 398 | Guidance :
|
|---|
| 399 | Dump a list of production threshold values in range and energy
|
|---|
| 400 | for all registered material-cuts-couples.
|
|---|
| 401 | Dumping a list takes place when you issue 'beamOn' and
|
|---|
| 402 | actual conversion tables from range to energy are available.
|
|---|
| 403 | If you want a list 'immediately', use '/run/dumpRegion' for threshold
|
|---|
| 404 | list given in gange only. Also, '/run/dumpCouples' gives you the
|
|---|
| 405 | current list if you have already issued 'run/beamOn' at least once.
|
|---|
| 406 |
|
|---|
| 407 | Parameter : particle
|
|---|
| 408 | Parameter type : s
|
|---|
| 409 | Omittable : True
|
|---|
| 410 | Default value : all
|
|---|
| 411 |
|
|---|
