Particles
Visualize and animate the particles moving through your structure.
The Particles tab controls the visibility of the particles. Some additional options and many the options from the View Controls can also be found in the Visualization Settings dialog. Expand the Visualization Settings dialog either by clicking the gear wheel icon in the bottom right of the Particles tab or by opening the Visualization tab in the sidebar and unfolding the Data View → Particles section.
Load Particles
Click the Particle Visualization tab. Buttons in three panels give access to the visualization of particle trajectories, the visualization of the particle positions with time, the visualization of the deposited dust with time and the visualization of the fluid flow field.
In the Particles panel, move the slider to select the Batches of particles to be visualized. For example, keep the choice to visualize all batches that ran in this filtration simulation, which is batches 1 to 12 in the example.
Trajectories should be checked to observe the movement of the particles.
Then, click Load Particles.
The structure model appears in the Visualization area in 3D Rendering with the stationary particles of Batch 1 above the structure (at the inlet domain).
|
Animation Controls
In the View Controls , the sliders for Time and Speed Ratio control the visualization of particle movement.
You can also generate videos using the Create Video dialog (File - Save Video as). Select the Follow Particle preset or the Particle Animation preset and click Generate Video. How to create videos in GeoDict is explained in detail in the Create Videos handbook.

Time
Moving the slider or directly entering a Time allows displaying the particles at a particular point in time.
|
Speed Ratio
The Speed Ratio controls the visualization speed by entering values directly or by moving the slider. Low values of Speed Ratio result in the particle movement process being shown in slow motion, whereas high values lead to faster motion.
|
Batch
The animation of the particles, in which the particles move through the filter structure, starts by clicking Play. The Batch number changes from 1 to the last batch, as the batches of particles appear in the inflow region above the filter media model and pass through it. The bigger particles are caught and held by the filter material whereas the smaller ones pass through to reach the outflow region.
Below, two images of batches 6 and 12 are shown. The color of the particles hovering over the structure has been changed from the default green to red. The deposited particles are shown in dark gray.
|
Loop
The Time slider does not return to zero when the animation has finished and must be set to the initial value to restart the animation. However, checking Loop makes the animation play endlessly.
|
Short Time
Checking Short Time adapts the visualization Time to the period when most of particles move. This option cuts off the final part of a simulation where only a few particles move at very low velocities and virtually no changes are visible to the observer.
|
Periodicity
Checking Periodicity activates periodic boundary conditions for the visualization of the simulation results. This is only recommended if the simulation was also done with periodic boundary conditions. In the Visualization Settings dialog, select where to apply periodicity from the pull-down menu for Periodicity. If for example, XY (Z Open) is selected, the periodicity is only applied in X- and Y- direction, while the Z-direction is open for particle movement.
|
Particles Shown
Material IDs
If the particles move through different materials, choose the Material IDs where the particles should be visible.
|
Particles and Trajectories
The Particles and Trajectories pull-down menus can be set to:
- None to show no particles (or no trajectories),
- Filtered to show only the filtered particles (or their corresponding trajectories),
- Not Filtered to only show the particles that are not filtered (or their corresponding trajectories),
- Time Out to display only particles (or their corresponding trajectories) whose movement could not be simulated completely within the time defined for each batch. For example, in some cases, a few particles can have very small velocities in the inflow region compared to most of particles and therefore their behavior cannot be simulated completely within the defined batch time,
- All to show the particles (or their corresponding trajectories) caught in the structure and those that went through it, or
- Custom. This option is only available in the Particles pull-down menu, but also applies for trajectories. If selected, click Edit Custom to define the particle visualization as described here.
|
Clipping
Clip the particle visualization area by enabling a clip direction, and moving the corresponding sliders or entering clipping values, working the same way as for the Structure.
|
Additional Parameters in Visualization Settings
Color Scheme
In the Visualization Settings dialog (Data View u Particles), control the Color Scheme by selecting between the following options from the pull-down menu:
- Moving State: If selected the default green color of the non-filtered particles can be changed with the parameter Moving Color. The color of the filtered particles can also be changed from the default dark gray with Deposited Color.
- Material: The colors are selected automatically depending on the material.
- Size: The colors are selected automatically depending on the particle size.
- Batch ID: The colors are selected automatically depending on the batch ID.
- Residence Time: The colors are selected according to the time spent in the chosen Materials.
- Bounces: The colors are selected depending on the number of bounces from the selected Materials.
- Entries: The colors are selected depending on how often the particles enter the chosen Materials.
- Trapped: The colors are selected depending on the material they are trapped in.
Sometimes it is useful to switch off the visualization of the structure by deselecting Data View u Structure.
|
Show Overlay
At the bottom-right of the visualization area, observe the Batch number and the point in Time of the filtration process. Determine if they should be shown or not by enabling / disabling the checkbox Show Overlay in the Particles section of the Visualization Settings dialog. The font size and color can be changed as described in the Legends / Overlays section.
|
Custom Visualization of Particles
The display of the particles moving through the filter media model and their trajectories can be customized.
When choosing Custom for the visualization of Particles, the Edit Custom… button overlays and replaces the standard Trajectories pull-down menu described above. Now, the visualization of trajectories is controlled through the Visualization - Trajectories option of the Custom Particle Selection dialog.
Settings for a user-defined, customized visualization can be defined by clicking the Edit Custom… button. The Custom Particle Selection dialog opens.
The Custom Particle Selection dialog may remain open to observe the changes that the selections have on the visualization of particles moving through the structure. The custom particle options can be changed while the particle animation is playing, so that the effect of the selection can be observed immediately.
Add Selection
Clicking Add Selection adds the current batch of particles to the visualization and generates Selection 1.
The selection can be disabled by unchecking the corresponding checkbox or deleted by clicking Remove.
Clicking at the left of Selection 1 opens the options: Previous Batches, Diameter Selection, ID Selection, Type ID Selection, Final State, Deposition Zone, Multiplicity, and Visualization.
Parameters for all these options are accessed by clicking on their symbol.
Clicking Add Selection again makes a new selection appear (e.g., Selection 2), to combine different visualization selection models and is useful to observe, for example, particles with two different diameter ranges (through Diameter Selection).
As an example, here, we show the settings to visualize particles with a diameter from 3 µm to 5 µm in Dark red, and particles with a diameter of 5 µm to 10 µm in Dark cyan.
Particles with a diameter larger than 10 µm and smaller than 3 µm are not shown at all.
Here, only particles with a Deposition Zone between 0 µm and 300 µm will be visualized.
The particles are scaled with Diameter Factor 3 to see the particles better.
|
Previous Batches
To see all previous batches, check Previous Batches. When left unchecked, only the particles of the current batch can be seen.
|
Diameter Selection
Checking Diameter Selection limits the visualized particles to those with a particle diameter in the range specified by min and max. This option only has an effect if the particles exhibit a particle size distribution.
|
ID Selection and Type ID Selection
Every particle has a specific ID and a specific Type ID. Every particle is counted and has its own specific ID. Furthermore, every diameter has its Type ID, which means that if you have 30 different diameters, there are 30 different Type IDs.
This option limits the visualized particles to those with a particle ID / Type ID in the range specified by min and max.
|
Final State
Final State enables the visualization of particles that obtained a particular state at the end of the simulation.
In the Not Filtered panel, particles that did not get attached to the filter/porous medium are selected as follows:
- Out-Flow denotes particles that left the computational domain via the fluid outflow region.
- In-Flow designates particles that left the computational domain via the fluid inflow region.
- Time-Out identifies all particles that do not stick to the porous medium and did not leave the computational domain via the inflow or outflow, i.e. slow particles.
- Hit End Material only shows particles which hit the end material. This only applies if the Particle End Position in the simulation is set to material ID and not to the outflow plane.
- The Max. Displacement reached state can only be achieved in AddiDict.
The Filtered panel contains the options for particles that became attached to the filter/porous medium:
- Adhesion selects all particles that are attached to the porous media because of adhesive forces.
- UDF selects all particles that are filtered by a model from a user defined function (UDF). This is only available for FilterDict results.
- First Touch selects particles that stick to the porous media on the first time they touch it.
- Sieving selects particles that simply lie on the porous media but do not stick to it, like happens in the other two options.
- Pass Through selects particles that are filtered by the pass-through model.
- Adsorbed selects particles that were adsorbed in a porous medium. The adsorption model is only available in AddiDict.
|
Deposition Zone
The Deposition Zone defines a location in the computational domain where the particles must be situated at the end of the simulation to be eligible for visualization. This zone is delimited by the min / max coordinates of the Cartesian direction in which fluid flow occurs, i.e., Z-axis.
|
Multiplicity
Particles can be selected depending on their multiplicity. Particle Multiplicity is a simulation option for unresolved particles which helps reducing simulation time for very small particles. For detailed information see the FilterDict handbook.
|
Visualization
Checking Visualization allows more adjustments for the visualization of simulation results.

- Checking Particles displays all particles that conform to the options previously set in the dialog.
- Checking Trajectories displays the trajectories which correspond to the selected particles. With this option, it is (for example) possible to show only the trajectories which correspond to a certain particle type.
- Checking Periodic enables periodic boundaries for the particle movements display. Particles which leave the domain at one side re-enter at the opposite side.
- The default color green for the particles can be changed to another color through the button (for example,
Dark cyan).
- The Diameter Factor scales the particles sizes relative to their original size for visualization purposes and enables the display of particles that are nominally below the visibility of the visualization settings. The diameter of all particles moving in the simulation artificially grows by this factor when visualizing them.
|