Tallies (Scorers)

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.

Volume Tallies

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

Fluence

The fluence of particles, either going into or out of a selected geometry in MeV.

particle direction Either into shape or out of shape, the fluence will be tracked accordingly.

tally volume The name of the geometry the fluence is either being tracked into or out of.

normalize to cosine of incident angle If yes, the contribution of each particle will be divided by cos(incident angle)

histogram bin units The fluence bins will be seperated by energy of the particle, in units of MeV.

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, MeV particle energy.
  • maximum bin edge value Maximim bin, MeV particle energy.
  • scale Linear scaling of the bins.

Energy Deposit

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Dose Deposit

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Cell Charge

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Track Lengths

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Passage Cell Current

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Passage Track Lengths

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Population

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Number of Tracks

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Number of Terminated Tracks

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Minimum Kinetic Energy at Generation

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Number of Steps

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Number of Secondaries

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Mesh Tallies

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

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Passage Cell Flux

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Cell Flux

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Flat Surface Flux

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.

Flat Surface Current

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 value in units specified by tally.
  • maximum bin edge value Maximum bin value in units specified by tally.
  • scale Linear scaling of the bins.