/run/

Run control commands.

Sub-directories :

/run/particle/

Commands for G4VUserPhysicsList.

Commands :

initialize

Initialize G4 kernel.

Available Geant4 state(s) : PreInit Idle

beamOn [numberOfEvent] [macroFile] [nSelect]

Start a Run.
If G4 kernel is not initialized, it will be initialized.
Default number of events to be processed is 1.
The second and third arguments can be used for
executing a macro file at the end of each event.
If the second argument, i.e. name of the macro
file, is given but the third argument is not,
the macro file will be executed for all of the
event.
If the third argument (nSelect) is given, the
macro file will be executed only for the first
nSelect events.

Available Geant4 state(s) : PreInit Idle

Parameters

numberOfEvent	type i	Omittable : default value = 1	Parameter range : numberOfEvent >= 0
macroFile	type s	Omittable : default value = ***NULL***
nSelect	type i	Omittable : default value = -1	Parameter range : nSelect>=-1

verbose [level]

Set the Verbose level of G4RunManager.
0 : Silent (default)
1 : Display main topics
2 : Display main topics and run summary

Range : level >=0 && level <=2

Available at all Geant4 states.

Parameters

level

type i

Omittable : default value = 0

dumpRegion [regionName]

Dump region information.
In case name of a region is not given, all regions will be displayed.

Available Geant4 state(s) : Idle

Parameters

regionName

type s

Omittable : default value = **ALL**

dumpCouples

Dump material-cuts-couple information.
Note that material-cuts-couple information is updated
after BeamOn has started.

Available Geant4 state(s) : Idle

optimizeGeometry [optimizeFlag]

Set the optimization flag for geometry.
If it is set to TRUE, G4GeometryManager will optimize
the geometry definitions.
GEANT4 is initialized with this flag as TRUE.

Available Geant4 state(s) : PreInit Idle

Parameters

optimizeFlag

type b

Omittable : default value = 1

breakAtBeginOfEvent [flag]

Set a break point at the begining of every event.

Available at all Geant4 states.

Parameters

flag

type b

Omittable : default value = 1

breakAtEndOfEvent [flag]

Set a break point at the end of every event.

Available at all Geant4 states.

Parameters

flag

type b

Omittable : default value = 1

abort [softAbort]

Abort current run processing.
If softAbort is false (default), currently processing event will be immediately aborted,
while softAbort is true, abortion occurs after processing the current event.

Available Geant4 state(s) : GeomClosed EventProc

Parameters

softAbort

type b

Omittable : default value = 0

abortCurrentEvent

Abort currently processing event.

Available Geant4 state(s) : EventProc

geometryModified

Force geometry to be closed again.
This command must be applied
if geometry has been modified after the
first initialization (or BeamOn).

Available Geant4 state(s) : PreInit Idle

physicsModified

Force all physics tables recalculated again.
This command must be applied
if physics process has been modified after the
first initialization (or BeamOn).

Available Geant4 state(s) : PreInit Idle

cutoffModified

/run/cutoffModified becomes obsolete.
It is safe to remove invoking this command.

Available at all Geant4 states.

constructScoringWorlds

Constrct scoring parallel world(s) if defined.
This command is not mandatory, but automatically called when a run starts.
But the user may use this to visualize the scoring world(s) before a run to start.

Available Geant4 state(s) : Idle

storeRndmStatToEvent [flag]

Flag to store rndm status to G4Event object.
flag = 0 : not store (default)
flag = 1 : status before primary particle generation is stored
flag = 2 : status before event processing (after primary particle generation) is stored
flag = 3 : both are stored
Note: Some performance overhead may be seen by storing rndm status, in particular
for the case of simplest geometry and small number of tracks per event.

Range : flag>=0 && flag<3

Available Geant4 state(s) : PreInit Idle

Parameters

flag

type i

Omittable : default value = 0

randomNumberStatusDirectory [fileName]

Define the directory name of the rndm status files.
Directory must be creates before storing the files.
OBSOLETE --- Please use commands in /random/ directory

Available Geant4 state(s) : PreInit Idle GeomClosed

Parameters

fileName

type s

Omittable : default value = ./

storeRandomNumberStatus [flag]

The randomNumberStatus will be saved at :
begining of run (currentRun.rndm) and begining of event (currentEvent.rndm)
OBSOLETE --- Please use commands in /random/ directory

Available at all Geant4 states.

Parameters

flag

type i

Omittable : default value = 1

restoreRandomNumberStatus [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.
OBSOLETE --- Please use commands in /random/ directory

Available Geant4 state(s) : PreInit Idle GeomClosed

Parameters

fileName

type s

Omittable : default value = currentRun.rndm

setCut [cut] [Unit]

Set default cut value

Range : cut >0.0

Available Geant4 state(s) : PreInit Idle

Parameters

cut	type d
Unit	type s	Omittable : default value = mm	Parameter candidates : pc km m cm mm um nm Ang fm parsec kilometer meter centimeter millimeter micrometer nanometer angstrom fermi

setCutForRegion [Region] [cut] [Unit]

Set cut value for a region

Available Geant4 state(s) : Idle

Parameters

Region	type s
cut	type d		Parameter range : cut >0.0
Unit	type s	Omittable : default value = mm	Parameter candidates : pc km m cm mm um nm Ang fm parsec kilometer meter centimeter millimeter micrometer nanometer angstrom fermi