The Tallies element contains all tallies to be recorded in the simulation. Sometimes a tally may also be referred to as a scorer.
Volume and Mesh Tallies are available in RSim. Any Geometry that has been assigned a material is available to a volume tally.
The parameters that are applied to all volume tallies are:
- histogram file name:
- This name will prefix the histogram, with one file created for each tally. The full histogram name will be histogram file name*_h1_*tallyVolume*_*tallyName.csv
The sum of particles’ energy deposits at each step in the volume.
units The energy deposit can be recorded in units of MeV, keV, eV, J, GeV, TeV, PeV.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The sum of energy deposits at each step in a cell divided by the mass of the volume.
units The only units for this tally is Grays (Gy).
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The total charge of particles which have stopped or have been created in the volume, for example the tracks that enter count as +1 and the tracks that exit count as -1.
units This tally can be recored in Couloumbs or positrons (e+).
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The sum of step lengths of the particles inside the volume.
units The track lengths can be recorded in nm, um, mm, cm or m.
weighted results Selection of weighting the results or not.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The number of tracks that pass through, (and only pass) completely through the volume.
weighted results Selection of weighting the results or not.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The sum of step lengths of particles that pass (and only pass) all the way through the volume.
units The track lengths can be recorded in nm, um, mm, cm or m.
weighted results Selection of weighting the results or not.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
Number of particles in the volume.
weighted results Selection of weighting the results or not.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
Total number of tracks in the volume.
track direction Can select to record either the tracks entering the volume, exiting the volume or both.
weighted results Selection of weighting the results or not.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
Number of tracks in the volume that get cut from the simulation.
weighted results Selection of weighting the results or not.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The minimum kinetic energy of secondary particles at their production point in the volume in an event. Does not integrate the quantity, but records the minimum quantity.
units The kinetic energy can be recoreded in MeV, eV, keV, GeV, TeV, PeV, J.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The number of steps in the volume.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The number of secondary particles generated in the volume.
tally volume The name of the geometry to record the tally in.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
A mesh tally will create a grid, recording the specified tally in each cell of the grid. This grid will be displayed in the Setup 3D View Window. Some tallies will record in the mesh, while others are applied to the surface of the grid cell.
A maximum of 15 mesh tallies are allowed in a single simulation.
Note that the simulation will run significanly slower if the mesh tally is in the same space as a physical volume.
The grid is specified by selecting the
- xMin Minimum coordinate in the x direction.
- xMax Maximum coordinate in the x direction.
- yMin Minimum coordinate in the y direction.
- yMax Maximum coordinate in the y direction.
- zMin Minimum coordinate in the z direction.
- zMax Maximum coordinate in the z direction.
- xCells Number of cells in the grid along the x axis.
- yCells Number of cells in the grid along the y axis.
- zCells Number of cells in the grid along the z axis.
All volume tallies are available as mesh tallies as well, and can have a grid specified for the mesh.
The following tallies are only available as mesh tallies.
Number of collisions in the cell.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The passage cell flux is defined by a track length (L) of the particle inside a volume divided by the volume (V) of this cell. The track length is calculated by a sum of the step lengths in the volume. The expression for cell flux is given by the sum of (W*L)/V, where W is a particle weight, and is multiplied by the track length at each step. Note that a passage cell flux is only applied to tracks that pass all the way through the cell.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The cell flux is defined by a track length (L) of the particle inside a volume divided by the volume (V) of this cell. The track length is calculated by a sum of the step lengths in the volume. The expression for cell flux is given by the sum of (W*L)/V, where W is a particle weight, and is multiplied by the track length at each step.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The surface flux is the number of particle tracks that reach the surface of the grid cell, with the incident angle considered according to 1/cos(angle) and normalized to the surface area of the grid cell.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.
The surface current is the number of particles that reach the surface of the grid cell, multiplied by the particle weight and normalized to the cell area.
histogram The user can specify the format of the binned histogram.
- number of bins Number of bins in the histogram.
- minimum bin edge value Minimum bin.
- minimum bin edge value Minimum bin.
- scale Linear scaling of the bins.