@@ -42,48 +42,53 @@ From the stored hits of the sensitive volumes, BoGEMMS-HPC collects and saves th
The user can select at runtime which parameters, or columns, are written to the output:
- writing the event ID of the simulation: `IOXYZ.EVT_ID = true`
- writing the track ID of the particle: `IOXYZ.TRK_ID = true`
- writing the track ID of the particle that generated the tracked particle: `IOXYZ.PARENT_TRK_ID = true`
- volume ID of the sensitive volume where the interaction occurred: `IOXYZ.VOLUME_ID = true`
- name of the sensitive volume where the interaction occurred: `IOXYZ.VOLUME_NAME = true`
- mother volume ID of the sensitive volume where the interaction occurred:`IOXYZ.MOTHER_ID = true`
- total deposited energy in the sensitive volume: `IOXYZ.E_DEP = true`
- x position of particle entrance/generation in the sensitive volume: `IOXYZ.X_ENT = true`
- y position of particle entrance/generation in the sensitive volume: `IOXYZ.Y_ENT = true`
- z position of particle entrance/generation in the sensitive volume: `IOXYZ.Z_ENT = true`
- x position of particle exit/stopped in the sensitive volume: `IOXYZ.X_EXIT = true`
- y position of particle exit/stopped in the sensitive volume: `IOXYZ.Y_EXIT = true`
- z position of particle exit/stopped in the sensitive volume: `IOXYZ.Z_EXIT = true`
- particle energy when entering or being generated in the volume: `IOXYZ.E_KIN_ENT = true`
- particle energy when exiting or being stopped in the volume: `IOXYZ.E_KIN_EXIT = true`
- direction cosine z of the particle when entering or being generated in the volume: `IOXYZ.MDX_ENT = true`
- direction cosine z of the particle when entering or being generated in the volume: `IOXYZ.MDY_ENT = true`
- direction cosine z of the particle when entering or being generated in the volume: `IOXYZ.MDZ_ENT = true`
- direction cosine z of the particle when entering or being generated in the volume: `IOXYZ.MDX_EXIT = true`
- direction cosine z of the particle when entering or being generated in the volume: `IOXYZ.MDY_EXIT = true`
- direction cosine z of the particle when entering or being generated in the volume: `IOXYZ.MDZ_EXIT = true`
`IOXYZ.GTIME_ENT = true`
`IOXYZ.GTIME_EXIT = true`
`IOXYZ.PARTICLE_ID = true`
`IOXYZ.PARTICLE_NAME = false`
`IOXYZ.PROCESS_ID = true`
`IOXYZ.PROCESS_NAME = false`
#volume selection
IOXYZ.volumeselection.number = 1
IOXYZ.volumeselection.0.start = 0
IOXYZ.volumeselection.0.end = 10000000
#number of rows for each file
IOXYZ.NRows = 5000000
#write only volume with energy deposit (this do not exclude the world)
IOXYZ.writeonlyifenergydeposit = 0
#exclude the world
#NB: the world contains the initial energy and momentum
IOXYZ.removeWorldEvent = 0
- writing the event ID of the simulation: `IOXYZ.EVT_ID = true/false`
- writing the track ID of the particle: `IOXYZ.TRK_ID = true/false`
- writing the track ID of the particle that generated the tracked particle: `IOXYZ.PARENT_TRK_ID = true/false`
- volume ID of the sensitive volume where the interaction occurred: `IOXYZ.VOLUME_ID = true/false`
- name of the sensitive volume where the interaction occurred: `IOXYZ.VOLUME_NAME = true/false`
- mother volume ID of the sensitive volume where the interaction occurred:`IOXYZ.MOTHER_ID = true/false`
- total deposited energy in the sensitive volume: `IOXYZ.E_DEP = true/false`
- x position of particle entrance/generation in the sensitive volume: `IOXYZ.X_ENT = true/false`
- y position of particle entrance/generation in the sensitive volume: `IOXYZ.Y_ENT = true/false`
- z position of particle entrance/generation in the sensitive volume: `IOXYZ.Z_ENT = true/false`
- x position of particle exit/stopped in the sensitive volume: `IOXYZ.X_EXIT = true/false`
- y position of particle exit/stopped in the sensitive volume: `IOXYZ.Y_EXIT = true/false`
- z position of particle exit/stopped in the sensitive volume: `IOXYZ.Z_EXIT = true/false`
- particle energy when entering or being generated in the volume: `IOXYZ.E_KIN_ENT = true/false`
- particle energy when exiting or being stopped in the volume: `IOXYZ.E_KIN_EXIT = true/false`
- direction cosine x of the particle when entering or being generated in the volume: `IOXYZ.MDX_ENT = true/false`
- direction cosine y of the particle when entering or being generated in the volume: `IOXYZ.MDY_ENT = true/false`
- direction cosine z of the particle when entering or being generated in the volume: `IOXYZ.MDZ_ENT = true/false`
- direction cosine x of the particle when exiting or being stopped in the volume: `IOXYZ.MDX_EXIT = true/false`
- direction cosine y of the particle when exiting or being stopped in the volume: `IOXYZ.MDY_EXIT = true/false`
- direction cosine z of the particle when exiting or being stopped in the volume: `IOXYZ.MDZ_EXIT = true/false`
- global time when entering or being generated in the volume: `IOXYZ.GTIME_ENT = true/false`
- global time when exiting or being stopped in the volume: `IOXYZ.GTIME_EXIT = true/false`
- partile ID (Geant4 ID): `IOXYZ.PARTICLE_ID = true/false`
- particle name (Geant4 naming): `IOXYZ.PARTICLE_NAME = true/false`
- ID of the process that created the particle (BoGEMMS-HPC internal coding): `IOXYZ.PROCESS_ID = true/false`
- name of the process that created the particle (Geant4 naming): `IOXYZ.PROCESS_NAME = true/false`
The user can select, on the basis of the volume IDs, which volumes to write to the output:
- number of selections: `IOXYZ.volumeselection.number = 1`
- starting ID for the selection: `IOXYZ.volumeselection.0.start = 0`
- ending ID for the selection: `IOXYZ.volumeselection.0.end = 10000000`
Number of rows written to each file (above this number, the file is closed and a new file is generated):
- number of rows: `IOXYZ.NRows = 5000000`
It is possible to write only sensitive volumes that register an energy deposit > 0 (this does not apply to the world volume):
- write only volumes with energy deposits: `IOXYZ.writeonlyifenergydeposit = 0`
#### Volume ID configuration
The XYZ data model writes both the currect volume ID and its mother. The user can select one of the following configurations to also get the volume ID from previous layers (e.g. the grandmother). The following configurations are currently active in BoGEMMS-HPC:
-`GEOM.VOLID.TYPE = 0`: the IDs are the baseline IDs provided by Geant4
-`GEOM.VOLID.TYPE = 1`: the mother and grandmother IDs are summed, used in case of replicas
-`GEOM.VOLID.TYPE = 2`: the current volume ID is the mother ID and the mother ID is the grandmother ID
-`GEOM.VOLID.TYPE = 3`: the current volume ID is the mother ID is the grandmother + grandgrandgrandmother ID (use case: XMM/MOS)
-`GEOM.VOLID.TYPE = 4`: the mother ID is the mother + grandmother + grandgrandmother + grandgrandgrandmother ID (use case: XMM/PN)
### Activating simulation from particle list
@@ -94,7 +99,6 @@ The primary particles in Geant4 can be randomly generated from a distribution de
-`EVENT.PRIMARY.LIST.FILENAME` = path to the file
## Physics
The `PHYS.VERSION` flag sets the name of the physics class to use in the application:
