Calculate the Custom Residence Time Property

For particles that meet the following criteria, the Custom Residence Time property associated with these three plug-ins adds the value of the current Time Step (in seconds) to the property.

  1. The particle is of a type (e.g. ‘New Particle 1’) listed in the Particles section of the model’s dialog box.
  2. The particle is within the bounds of the geometry described by the appropriate parameters for the given Geometry (center, radius, rotation, and so on.)
Particles that do not meet both these criteria will not have any value added to the Custom Residence Time property. For example, if two particle types are defined in a simulation and only the particles of type New Particle 1 spent in a specific region are to be measured, you can define the parameters as follows:


In this example, you are defining a sphere to track the Custom Residence Time. Although the simulation includes an additional  particle type (New Particle 2), because it is not displayed in the Particles list in the dialog box, particles of this type will not have a value added to their Custom Residence Time attribute, unlike the particles of type New Particle 1.


In this example, the particle of type New Particle 1 inside the described sphere is the only particle to meet both criteria. As a result, it is the only particle whose Custom Residence Time value will be increased.

The results are as follows: