SMS:Particle Module: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{SMS_at_a_glance_particle_module|Heading===At a glance==}}
{{SMS_at_a_glance_particle_module|Heading===At a glance==}}


The particle module contains tools used to work with particle data. Particles can have time varying location and scalar data.  The particle module currently includes interfaces for:
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:
 
*[[SMS:PTM|PTM]] – Lagrangian particle tracker designed to allow the user to simulate particle transport processes.


*[[SMS:PTM|PTM]] – Lagrangian particle tracker designed to allow simulating particle transport processes.


The Particle module can be added to a [http://www.aquaveo.com/software/sms-pricing paid edition] of SMS.
[[Category:Link to Store]]


== Particle Module Tools ==
== Particle Module Tools ==
The Particle Module tools are contained in the [[SMS:Dynamic_Tools|Dynamic Tools]] portion of the tool palette when the Particle Module is active.  
The Particle module tools are contained in the [[SMS:Dynamic_Tools|Dynamic Tools]] portion of the tool palette when the Particle module is active.  


*[[File:Tool SelectVertices.GIF]] '''Select Particles'''
;'''Select Particles''' [[File:Select Point Tool.svg|16 px]] : 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.
<blockquote>
The '''Select Particles''' tool 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.
</blockquote>


== Particle Module Menus ==
== Particle Module Menus ==
Line 19: Line 17:


== Particle Module Display Options ==
== Particle Module Display Options ==
* [[SMS:Particle Module Display Options|Display Options]]
See the article [[SMS:Particle Module Display Options|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 [[SMS:PTM Graphical Interface|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.
 
==Particle Module Create Datasets==
The Particle module ''Create Datasets'' dialog is accessed through the [[SMS:Particle Module Menus|Particle module ''Data'' menu]].  Currently the following particle datasets can be created:
* ''Distance traveled''
::For each time step, computes the total distance each particle has traveled since the particle was born.
* ''Average velocity (since last time step)''
::For each time step, computes the average velocity of the particle since the previous time step.
* ''Number of particles within vicinity''
**''Vicinity radius''
* ''Dataset name''
::A name for that particle dataset can be entered in in each field under this option.
 
[[Image:SMS-Particle_Module_Create_Data_Sets.png|thumb|none|left|350 px|Example of the ''Create Dataset'' dialog.]]


== Related Topics ==
== Related Topics ==
Line 27: Line 50:




{{Template:Navbox SMS}}
{{Navbox SMS Tools}}
{{Navbox SMS}}


[[Category:SMS Particle|Particle Module]]
[[Category:SMS Particle|Particle Module]]
[[Category:SMS Tools]]

Latest revision as of 23:12, 4 August 2020

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.

Particle Module Create Datasets

The Particle module Create Datasets dialog is accessed through the Particle module Data menu. Currently the following particle datasets can be created:

  • Distance traveled
For each time step, computes the total distance each particle has traveled since the particle was born.
  • Average velocity (since last time step)
For each time step, computes the average velocity of the particle since the previous time step.
  • Number of particles within vicinity
    • Vicinity radius
  • Dataset name
A name for that particle dataset can be entered in in each field under this option.
Example of the Create Dataset dialog.

Related Topics