field/field06/README.md

0001 \page Examplefield06 Example field06
0002
0003   This example exercises the capability of tracking massive
0004   particles in a gravity field.
0005
0006   Credit goes to Erik Miller (Univ. of Northern British Columbia) and
0007   Garry Yan (Univ. of Toronto)
0008
0009 ## main()
0010
0011  See main() in field06.cc.
0012
0013 ## GEOMETRY DEFINITION
0014
0015  As simple world G4Box with a G4UniformGravityField propagating momentum
0016  (G4EqGravityField) with G4ClassicalRK4(fEquation,8). The example uses the
0017  default gravity field on the earth's surface:
0018  ```
0019  gy = -9.81*m/s/s/c_light.
0020  ```
0021
0022 ## AN EVENT: THE PRIMARY GENERATOR
0023
0024  Uses an Ultra Cold Neutron (UCN) and G4ParticleGun with:
0025  ```
0026  particleEnergy = G4UniformRand()*1e-7*eV
0027  ```
0028
0029  UCN are launched from (0,0,0) uniform into 4pi
0030
0031 ## PHYSICS
0032
0033  The simulation knows of only six particles: G4Neutron, G4Proton,
0034  G4Electron, G4AntiNeutrinoE, G4MuonPlus and G4MuonMinus
0035 ```cpp
0036  RegisterPhysics(new G4StepLimiterPhysics());
0037 ```
0038  G4StepLimiterPhysics defines G4StepLimiter and G4UserSpecialCuts
0039
0040 ## HOW TO START ?
0041
0042    This example handles the program arguments in a new way.
0043    It can be run with the following optional arguments:
0044 ```
0045 % ./field06 [-m macro ] [-u UIsession] [-t nThreads] [-r randomSeed]
0046 ```
0047
0048    The -t option is available only in multi-threading mode
0049    and it allows the user to override the Geant4 default number of
0050    threads. The number of threads can be also set via G4FORCENUMBEROFTHREADS
0051    environment variable which has the top priority.
0052
0053   - Execute field06 in 'batch' mode from macro files e.g.
0054 ```
0055 % ./field06 -m field06.in > field06.out &
0056 ```
0057
0058   - Execute field06 in 'interactive' mode with visualization e.g.
0059 ```
0060 % ./field06
0061 ....
0062 Idle> type your commands, for example:
0063 Idle> run/beamOn 1
0064 ....
0065 ```