SMS:Particle Module

From XMS Wiki
Jump to navigationJump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
PTM particle trace

At a glance

  • Visualize particle/path data
  • Supports PTM model which computes particle positions through time based upon hydrodynamics and wave effects


The Particle module contains tools used to work with particle data. Particles can have time varying location and scalar data. The module currently includes interfaces for:

  • PTM – Lagrangian particle tracker designed to allow simulating particle transport processes.

The Particle module can be added to a paid edition of SMS.

Particle Module Tools

The Particle module tools are contained in the Dynamic Tools portion of the tool palette when the Particle module is active.

Select Particles Select Point Tool.svg
Selects a single particle with a left mouse click. A group of particles can be selected by dragging a box around them. Particles may be added to the selection by holding the SHIFT key and selecting additional particles. The main use of selecting particles in the particle module is to query the particle properties. When a single particle is selected, the Info Window will show the ID and the edit window will show the location and value of the active particle dataset. If exactly two particles are selected, the Info Window will also show the exact distance between the two selected particles. If more than one particle is selected, the minimum, maximum, and average value of the active particle dataset will be shown.

Particle Module Menus

See Particle Module Menus for more information.

Particle Module Display Options

See the article Particle Module Display Options.

Extract Particle Subset

This command writes a portion of a particle set to a new a particle file. This portion may be a subset of the time steps for the particle solution, a subset of the particles, or both. To get to this command, right-click on a particle set and choose Extract subset (times/particles).

The required information for this command includes:

  • The file name to write the particle subset to.
  • The first and last time steps that define the range of time the user wants export.
  • Whether to write every time step, every other time step, every third time step, etc.

It is possible to define a subset of the particles to export by setting up filters (see PTM Particle Filters). For example, deciding to only write particles with a specific range of grain size, or particles from a specific source.

The extracted particle set will have the same datasets that exist in the original particle set.

Related Topics