/random/

Random number status control commands.

Commands

setSeeds
setDirectoryName
setSavingFlag
saveThisRun
saveThisEvent
resetEngineFrom
resetEngineFromEachEvent
saveEachEventFlag

setSeeds [IntArray]

Initialize the random number generator with integer seed stream.
Number of integers should be more than 1.
Actual number of integers to be used depends on the individual random number engine.
This command sets the seeds for the master thread.

Available Geant4 state(s) : PreInit Idle GeomClosed

Parameters
IntArray type s

setDirectoryName [fileName]

Define the directory name of the rndm status files.
Directory will be created if it does not exist.

Available Geant4 state(s) : PreInit Idle GeomClosed

Parameters
fileName type s Omittable : default value = ./

setSavingFlag [flag]

The randomNumberStatus will be saved at :
beginning of run (currentRun.rndm) and beginning of event (currentEvent.rndm)

Available at all Geant4 states.

Parameters
flag type b Omittable : default value = 1

saveThisRun

copy currentRun.rndm to runXXX.rndm

Available Geant4 state(s) : Idle GeomClosed EventProc

saveThisEvent

copy currentEvent.rndm to runXXXevtYYY.rndm

Available Geant4 state(s) : EventProc

resetEngineFrom [fileName]

Reset the status of the rndm engine from a file.
See CLHEP manual for detail.
The engine status must be stored beforehand.
Directory of the status file should be set by /random/setDirectoryName.

Available Geant4 state(s) : PreInit Idle GeomClosed

Parameters
fileName type s Omittable : default value = currentRun.rndm

resetEngineFromEachEvent []

Reset the status of the rndm engine from a file at each event.
Note that the file must follow the following naming convention:
run{#1}evt{#2}.rndm ; where #1 is the run number and #2 is the event number.
For example to re-seed the first event of the first run the file should be called run0evt0.rndm.
If for a specific run/event the file is not found, the standard re-seeding strategy is used.
This command has meaning only in MT mode for strong reproducibility studies.
Directory of the status file should be set by /random/setDirectoryName.

Available Geant4 state(s) : PreInit Idle GeomClosed

Parameters
type b

saveEachEventFlag [flag]

Save random number status at beginning of each event.
File name contains run and event numbers: runXXXevtYYY.rndm

Available at all Geant4 states.

Parameters
flag type b Omittable : default value = 1