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, Mesh and Source Tallies are available in RSim. Any Geometry that has been assigned a material is available to a volume tally, a volume may also be specified in the tally as a Probe.

Probes

A probe is available for any volume tally, but may only be accessed if no histogram is the selected histogram option. Probes are meant to be small features used for diagnostic capabilites.

probe material If left Not Changed, will be whatever material was present in the space of the probe, or assigned to any available material. Note that changing the material will change the simulation itself, so probes should be small and used sparingly if using a different material.

x center X Coordinate of the center of the probe.

y center Y Coordinate of the center of the probe.

z center Z Coordinate of the center of the probe.

probe length Length of the probe in all three directions.

Volume Tallies

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, or probe 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, or to not record a 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.
  • x-axis scale Apply linear or logarithmic scaling of the bins.
  • y-axis scale Apply linear or logarithmic scaling of the histogram values.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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.

tally volume The name of the geometry to record the tally in, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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, or probe location and size.

histogram The user can specify the format of the binned histogram, or to not record a histogram. Histograms cannot be used with probe tally volumes.

  • number of bins Number of bins in the histogram.
  • minimum bin edge value Minimum bin value in units of MeV.
  • maximum bin edge value Maximum bin value in units of MeV.
  • x-axis scale Apply linear or logarithmic scaling of the bins.
  • y-axis scale Apply linear or logarithmic scaling of the histogram values.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

Number of Steps

The number of steps in the volume.

tally volume The name of the geometry to record the tally in, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

Number of Secondaries

The number of secondary particles generated in the volume.

tally volume The name of the geometry to record the tally in, or probe location and size.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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.

Note

The histogram results for mesh tallies will be summed over all mesh cells. This will lead to significantly higher values in the histogram results based on the total number of cells

The following tallies are only available as mesh tallies.

Number of Collisions

Number of collisions in the cell.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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 of MeV.
  • maximum bin edge value Maximum bin value in units of MeV.
  • x-axis scale Apply linear or logarithmic scaling of the bins.
  • y-axis scale Apply linear or logarithmic scaling of the histogram values.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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 of MeV.
  • maximum bin edge value Maximum bin value in units of MeV.
  • x-axis scale Apply linear or logarithmic scaling of the bins.
  • y-axis scale Apply linear or logarithmic scaling of the histogram values.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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 of MeV.
  • maximum bin edge value Maximum bin value in units of MeV.
  • x-axis scale Apply linear or logarithmic scaling of the bins.
  • y-axis scale Apply linear or logarithmic scaling of the histogram values.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

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 of MeV.
  • maximum bin edge value Maximum bin value in units of MeV.
  • x-axis scale Apply linear or logarithmic scaling of the bins.
  • y-axis scale Apply linear or logarithmic scaling of the histogram values.

tallied particles By default all, can tally particles of any of the specified types

  • charged particles All charged particles will be tallied.
  • neutral particles All neutral particles will be tallied.
  • energy band Particles will only be tallied in the specified energy band.
    • energy low Low end of the energy band.
    • energy high High end of the energy band.
    • energy unit Units to specify the energy band in.
  • single particle type A single particle type of either electrons, protons, neutrons, positrons, ions, alpha, geantino or gamma.
  • single particle type with energy band A combination of the single particle type within a specified energy band.

Source Tallies

Source tallies can be used as a diagnostic to track the energies of your particle source for accuracy. They track all primary particles of the simulation. Currently there is only one source tally available.

Source Energy Spectrum

weighted results If the results of the tally should contain the particle weighting.

units Units of the energy to give out, candidates are MeV, keV, eV, TeV, GeV, PeV, or J.

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.
  • x-axis scale Apply linear or logarithmic scaling of the bins.
  • y-axis scale Apply linear or logarithmic scaling of the histogram values.