SMS:PTM: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(44 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{SMS Infobox Model |
{{SMS Infobox Model |
|name=          PTM
|name=          PTM
|model_type=    Lagrangian particle tracker designed to allow the user to simulate particle transport processes.
|screenshot = File:PTM example.png
|model_type=    Lagrangian particle tracker designed to allow simulating particle transport processes.
|developer=     
|developer=     
Neil J. MacDonald, Ph.D. <br />  
Neil J. MacDonald, Ph.D. <br />  
Michael H. Davies, M.Sc., Ph.D., P.Eng. <br />  
Michael H. Davies, M.Sc., Ph.D., P.Eng. <br />  
[http://www.coldwater-consulting.com Coldwater Consulting Ltd]
[http://www.coldwater-consulting.com Coldwater Consulting Ltd]
|web_site=      [http://el.erdc.usace.army.mil/dots/doer/ptm.html PTM web site]
|web_site=      [https://doer.el.erdc.dren.mil/ptm.html PTM web site]
|tutorials=     
|tutorials=     
Models Section
* PTM (Pending)
}}
}}


The Particle Tracking Model (PTM) is a Lagrangian particle tracker designed to allow the user to simulate particle transport processes. PTM is funded through two US Army Corps of Engineers Engineering Research and Development Center (ERDC) research programs, the Coastal Inlets Research Program (CIRP) and the Dredging Operations and Environmental Research (DOER) Program.
The Particle Tracking Model (PTM) is a Lagrangian particle tracker designed to allow simulating particle transport processes. PTM is funded through two US Army Corps of Engineers Engineering Research and Development Center (ERDC) research programs, the Coastal Inlets Research Program (CIRP) and the Dredging Operations and Environmental Research (DOER) Program.
 
The PTM model can be added to a [http://www.aquaveo.com/software/sms-pricing paid edition] of SMS.
[[Category:Link to Store]]


==Functionality==
==Functionality==
PTM has been developed for application to dredging and coastal projects including dredged material dispersion and fate, sediment pathway and fate, and constituent transport. The model contains algorithms that appropriately represent transport, settling, deposition, mixing, and resuspension processes in nearshore wave/current conditions. It uses waves and currents developed through other models and input directly to PTM as forcing functions.
PTM has been developed for application to dredging and coastal projects including dredged material dispersion and fate, sediment pathway and fate, and constituent transport. The model contains algorithms that appropriately represent transport, settling, deposition, mixing, and resuspension processes in nearshore wave/current conditions. It uses waves and currents developed through other models and input directly to PTM as forcing functions.


==Using the Model / Practical Notes==
===Using the Model / Practical Notes===
* The horizontal and vertical coordinates used for all PTM input files must be in meters. [[Geographic_Coordinate_System|Geographic Coordinates]] cannot be used since it is a latitude/longitude system defined in decimal degrees.
* The horizontal and vertical coordinates used for all PTM input files must be in meters. [[Geographic_Coordinate_System|Geographic coordinates]] cannot be used since it is a latitude/longitude system defined in decimal degrees.
* If last step trap is checked, the traps will not become active until the last time step.
* If last step trap is checked, the traps will not become active until the last time step.
* The Q3D advection option has been deprecated starting with SMS 11.1. The 2D advection option should be used instead.
==How do I use PTM?==
The SMS [[SMS:Tutorials|tutorials]] are a good place to start learning to use SMS and associated models. A tutorial is available for PTM.


== Graphical Interface ==  
== Graphical Interface ==  
SMS provides a graphical interface that is designed to allow users to visualize the projects they are creating, easily modify project parameters, and view the solutions produced by the PTM model. See [[SMS:PTM Graphical Interface|PTM Graphical Interface]] for more information.
SMS provides a graphical interface that is designed to visualize the projects being created, easily modify project parameters, and view the solutions produced by the PTM model. See [[SMS:PTM Graphical Interface|PTM Graphical Interface]] for more information.
 
The [[SMS:PTM Graphical Interface|PTM graphical interface]] contains tools to create and edit a PTM simulation. The simulation consists of a geometric definition of the sources, traps, and a set of numerical parameters. The parameters define the hydrodynamic input and options pertinent to the model.
 
The interface is accessed by selecting the [[SMS:Particle Module|Particle module]] and setting the current model to PTM. If a simulation has already been created or an existing simulation read, the particle object will exist in the [[SMS:Project Explorer|Project Explorer]] and selecting that object will make the Particle module active and set the model to PTM. See the [[SMS:Particle Module|Particle module]] documentation for guidance on visualizing results.


The [[SMS:PTM Graphical Interface|PTM Graphical Interface]] contains tools to create and edit an PTM simulation. The simulation consists of a geometric definition of the sources, traps, and a set of numerical parameters. The parameters define the hydrodynamic input and options pertinent to the model.
The interface consists of the [[SMS:Particle Module Menus|Particle module menus]] and [[SMS:Particle Module#Particle Module Tools|tools]] augmented by the [[SMS:PTM Graphical Interface#PTM Menu|''PTM'' menu]]. See [[SMS:PTM Graphical Interface|PTM Graphical Interface]] for more information.


The interface is accessed by selecting the [[SMS:Particle Module|Particle Module]] and setting the current model to PTM. If a simulation has already been created or an existing simulation read, the particle object will exist in the [[SMS:Project Explorer|Project Explorer]] and selecting that object will make the Particle module active and set the model to PTM. See the [[SMS:Particle Module|Particle Module]] documentation for guidance on visualizing results.
===PTM Menu===
The ''PTM'' menu becomes active when a PTM model coverage has been created. For more information see [[SMS:PTM Graphical Interface|PTM Graphical Interface]].


The interface consists of the [[SMS:Particle Module Menus|Particle Module Menus]] and [[SMS:Particle Module Tools|tools]] augmented by the [[SMS:PTM Graphical Interface#PTM Menu|PTM Menu]]. See [[SMS:PTM Graphical Interface|PTM Graphical Interface]] for more information.
===Tools===
PTM sources and traps are created in the [[SMS:Map Module|Map module]] as [[SMS:Feature Objects Types|feature objects]] using the [[SMS:Map Module Tools|Map module tools]].
 
[[Category:SMS Tools|PTM]]
 
===PTM Coverages===
In the SMS interface, two types of [[SMS:Coverages|coverages]] can be applied to a PTM simulation.  These include:
* [[SMS:PTM Sources|PTM Source/Trap Coverage]] &ndash; Used to define input for a PTM simulation.
* [[SMS:PTM Gage Coverage|PTM Gage Coverage]] &ndash; Used to view time series of output data computed by the PTM engine.
[[Category:SMS Coverages|P]]
 
==PTM Files==
See the [[SMS:PTM Files|PTM Files]] page for a list of input and output files with a brief description.


==Theoretical Basis / Mathematical Details==
==Theoretical Basis / Mathematical Details==
Please refer to the model developer provided documentation listed in the [[SMS:PTM#External_Links|external links]] section.
Please refer to the model developer provided documentation listed in the [[SMS:PTM#External Links|external links]] section.


==Numeric Engine Background==
==Numeric Engine Background==
Line 38: Line 61:
== General Steps to Build a PTM Model ==
== General Steps to Build a PTM Model ==
# Open SMS
# Open SMS
# Although not required, it is generally easier to visualize your model if you read in the hydrodynamic solution
# Although not required, it is generally easier to visualize the model if reading in the hydrodynamic solution
# Convert the horizontal and vertical coordinates to meters. PTM cannot be run in [[Geographic Coordinate System|Geographic Coordinates]] since it is a latitude/longitude system defined in decimal degrees.
# Convert the horizontal and vertical coordinates to meters. PTM cannot be run in [[Geographic Coordinate System|Geographic Coordinates]] since it is a latitude/longitude system defined in decimal degrees.
# Switch to the [[SMS:Map Module|Map Module]]
# Switch to the [[SMS:Map Module|Map module]]
# Create a PTM type [[SMS:Coverages|coverage]]
# Create a PTM type [[SMS:Coverages|coverage]]
# Create [[SMS:PTM_Sources|sources]] and [[SMS:PTM Traps|traps]] using feature [[SMS:Feature Objects Types#Points|points]], [[SMS:Feature Objects Types#Arcs|arcs]], and [[SMS:Feature Objects Types#Polygons|polygons]]
# Create [[SMS:PTM_Sources|sources]] and [[SMS:PTM Traps|traps]] using feature [[SMS:Feature Objects Types#Points|points]], [[SMS:Feature Objects Types#Arcs|arcs]], and [[SMS:Feature Objects Types#Polygons|polygons]]
# [[SMS:Particle Module|Switch to the Particle Module]]
# Switch to the [[SMS:Particle Module|Particle module]]
# Use the [[SMS:PTM Graphical Interface#PTM Menu|''PTM'' menu]] to create a new PTM simulation
# Use the [[SMS:PTM Graphical Interface#PTM Menu|''PTM'' menu]] to create a new PTM simulation
# Use the [[SMS:PTM Graphical Interface#PTM Menu|''PTM'' menu]] to open the [[SMS:PTM_Model_Control|''PTM Model Control'' dialog]]
# Use the [[SMS:PTM Graphical Interface#PTM Menu|''PTM'' menu]] to open the [[SMS:PTM_Model_Control|''PTM Model Control'' dialog]]
## Specify input and output parameters in the model control
## Specify input and output parameters in the model control
## Click on the '''Create input file(s) from data''' button to create a [[SMS:PTM Sediment File|native sediment file]], and hydrodynamic input files if needed
## Click on the '''Create input file(s) from data''' button to create a [[SMS:PTM Sediment File|native sediment file]], and hydrodynamic input files if needed. You may use mesh, water surface elevation, and velocity data from another model (ADCIRC, ADH, RMA2) to create the necessary fort.15 and/or *.h5 file.
# Save the simulation
# Save the simulation
# Use the [[SMS:PTM Graphical Interface#PTM Menu|''PTM'' menu]] to perform a [[SMS:PTM Graphical Interface#PTM Model Check|model check]]
# Use the [[SMS:PTM Graphical Interface#PTM Menu|''PTM'' menu]] to perform a [[SMS:PTM Graphical Interface#PTM Model Check|model check]]
Line 54: Line 77:
== General Post-Processing Steps ==
== General Post-Processing Steps ==
# Use the [[SMS:Particle Module Display Options|''display options'']] to visualize the results
# Use the [[SMS:Particle Module Display Options|''display options'']] to visualize the results
# Use the [[Data Calculator|''Data Calculator'']] or [[SMS:Particle Module Create Datasets|''Create Datasets'']] dialog to create particle datasets
# Use the [[SMS:Data Calculator|''Data Calculator'']] or [[SMS:Particle_Module#Particle_Module_Create_Datasets|''Create Datasets'']] dialog to create particle datasets
# Create a [[SMS:Cartesian_Grid_Module|Cartesian Grid]] and use the [[SMS:Particle Module Compute Grid Datasets|''Create Grid Datasets'']] dialog to create Cartesian grid datasets
# Create a [[SMS:Cartesian_Grid_Module|Cartesian Grid]] and use the [[SMS:Particle Module Compute Grid Datasets|''Create Grid Datasets'']] dialog to create Cartesian grid datasets
# Review the [[SMS:PTM Files#Output Files|Trap Output files]] in an ASCII file viewer
# Review the [[SMS:PTM Files#Output Files|Trap Output files]] in an ASCII file viewer
==Numeric Engine Background==
Please refer to the model developer provided documentation listed in the [[SMS:PTM#External Links|external links]] section.


==External Links==
==External Links==
* U.S. Army Corps of Engineers DOER PTM website [http://el.erdc.usace.army.mil/dots/doer/ptm.html]
* U.S. Army Corps of Engineers DOER PTM website [https://doer.el.erdc.dren.mil/ptm.html]
* Sep 2006  ERDC/CHL TR-06-20    PTM: Particle Tracking Model Report 1: Model Theory, Implementation, and Example Applications [http://el.erdc.usace.army.mil/dots/doer/pdf/TR-06-20.pdf]
* 2005  ERDC TN-DOER-D4      Particle Tracking Model (PTM) in the SMS: I. Graphical Interface                [http://smsdocs.aquaveo.com/PTM_DOERD4.PDF]
* Jul 2005  ERDC TN-DOER-D4      Particle Tracking Model (PTM) in the SMS: I. Graphical Interface                [http://el.erdc.usace.army.mil/elpubs/pdf/doerd4.pdf]
* 2005  ERDC TN-DOER-D5      Particle Tracking Model (PTM): II. Overview of Features and Capabilities        [https://doer.el.erdc.dren.mil/pdf/doerd5.pdf]
* Jul 2005  ERDC TN-DOER-D5      Particle Tracking Model (PTM): II. Overview of Features and Capabilities        [http://el.erdc.usace.army.mil/elpubs/pdf/doerd5.pdf]
* 2005  ERDC TN-DOER-D6      Particle Tracking Model (PTM) in the SMS: III. Tutorial with Examples            [http://smsdocs.aquaveo.com/PTM_DOERD6.PDF]
* Jul 2005  ERDC TN-DOER-D6      Particle Tracking Model (PTM) in the SMS: III. Tutorial with Examples            [http://el.erdc.usace.army.mil/elpubs/pdf/doerd6.pdf]
* 2006  ERDC/CHL TR-06-20    PTM: Particle Tracking Model Report 1: Model Theory, Implementation, and Example Applications [https://apps.dtic.mil/sti/pdfs/ADA455437.pdf]
* Jul 2008  ERDC/CHL CHETN-IV-71 Particle Tracking Model (PTM) in the SMS 10: IV. Link to Coastal Modeling System [http://chl.erdc.usace.army.mil/library/publications/chetn/pdf/chetn-iv-71.pdf]
* 2008  ERDC/CHL CHETN-IV-71 Particle Tracking Model (PTM) in the SMS 10: IV. Link to Coastal Modeling System [https://apps.dtic.mil/sti/pdfs/ADA485347.pdf]
* 2007 The Particle Tracking Model: Description and Processes [http://el.erdc.usace.army.mil/dots/doer/pdf/LackeyandMcDonald_2007.pdf]
* 2007 The Particle Tracking Model: Description and Processes [https://doer.el.erdc.dren.mil/pdf/LackeyandMcDonald_2007.pdf]
* Application of the Particle Tracking Model to Predict the Farfield Fate of:
<!-- links broken * Application of the Particle Tracking Model to Predict the Farfield Fate of:
** 2007 Sediment Suspended by Nearshore Dredging and Placement, Brunswick, GA [http://el.erdc.usace.army.mil/dots/doer/pdf/GAILANIetal_2008.pdf]
** 2007 Sediment Suspended by Nearshore Dredging and Placement, Brunswick, GA [https://web-beta.archive.org/web/20090821060140/http://el.erdc.usace.army.mil/dots/doer/pdf/GAILANIetal_2008.pdf]
** 2008 Dredged Suspended Sediment at the Willamette River [http://el.erdc.usace.army.mil/dots/doer/pdf/LackeyandSmith_2008.pdf]
** 2008 Dredged Suspended Sediment at the Willamette River [https://web-beta.archive.org/web/20090821060112/http://el.erdc.usace.army.mil/dots/doer/pdf/LackeyandSmith_2008.pdf]-->
* 2009 Assessment of Dredging-Induced Sedimentation on Winter Flounder Spawning habitat [http://el.erdc.usace.army.mil/dots/doer/pdf/LackeyKimClarke_WEDA.pdf]
* 2009 Assessment of Dredging-Induced Sedimentation on Winter Flounder Spawning habitat [https://doer.el.erdc.dren.mil/pdf/LackeyKimClarke_WEDA.pdf]
<!-- broken * Humboldt Bay PTM with CMS-Flow Quadtree Grid [http://cirp.usace.army.mil/techtransfer/workshops/nap12/Presentation/PTM_022112.pdf] -->
* 2012 Use of the PTM with CMS Quadtree Grids[https://apps.dtic.mil/sti/pdfs/ADA576409.pdf]
[[Category:Needs Update]] <!--Links don't work-->


==Related Topics==
==Related Topics==
Line 83: Line 106:
[[Category:SMS Particle|P]]
[[Category:SMS Particle|P]]
[[Category:PTM|P]]
[[Category:PTM|P]]
[[Category:External Links]]

Latest revision as of 21:21, 27 April 2023

PTM
PTM
PTM Screenshot
Model Info
Model type Lagrangian particle tracker designed to allow simulating particle transport processes.
Developer

Neil J. MacDonald, Ph.D.
Michael H. Davies, M.Sc., Ph.D., P.Eng.

Coldwater Consulting Ltd
Web site PTM web site

The Particle Tracking Model (PTM) is a Lagrangian particle tracker designed to allow simulating particle transport processes. PTM is funded through two US Army Corps of Engineers Engineering Research and Development Center (ERDC) research programs, the Coastal Inlets Research Program (CIRP) and the Dredging Operations and Environmental Research (DOER) Program.

The PTM model can be added to a paid edition of SMS.

Functionality

PTM has been developed for application to dredging and coastal projects including dredged material dispersion and fate, sediment pathway and fate, and constituent transport. The model contains algorithms that appropriately represent transport, settling, deposition, mixing, and resuspension processes in nearshore wave/current conditions. It uses waves and currents developed through other models and input directly to PTM as forcing functions.

Using the Model / Practical Notes

  • The horizontal and vertical coordinates used for all PTM input files must be in meters. Geographic coordinates cannot be used since it is a latitude/longitude system defined in decimal degrees.
  • If last step trap is checked, the traps will not become active until the last time step.
  • The Q3D advection option has been deprecated starting with SMS 11.1. The 2D advection option should be used instead.

How do I use PTM?

The SMS tutorials are a good place to start learning to use SMS and associated models. A tutorial is available for PTM.

Graphical Interface

SMS provides a graphical interface that is designed to visualize the projects being created, easily modify project parameters, and view the solutions produced by the PTM model. See PTM Graphical Interface for more information.

The PTM graphical interface contains tools to create and edit a PTM simulation. The simulation consists of a geometric definition of the sources, traps, and a set of numerical parameters. The parameters define the hydrodynamic input and options pertinent to the model.

The interface is accessed by selecting the Particle module and setting the current model to PTM. If a simulation has already been created or an existing simulation read, the particle object will exist in the Project Explorer and selecting that object will make the Particle module active and set the model to PTM. See the Particle module documentation for guidance on visualizing results.

The interface consists of the Particle module menus and tools augmented by the PTM menu. See PTM Graphical Interface for more information.

PTM Menu

The PTM menu becomes active when a PTM model coverage has been created. For more information see PTM Graphical Interface.

Tools

PTM sources and traps are created in the Map module as feature objects using the Map module tools.

PTM Coverages

In the SMS interface, two types of coverages can be applied to a PTM simulation. These include:

PTM Files

See the PTM Files page for a list of input and output files with a brief description.

Theoretical Basis / Mathematical Details

Please refer to the model developer provided documentation listed in the external links section.

Numeric Engine Background

Please refer to the model developer provided documentation listed in the external links section.

General Steps to Build a PTM Model

  1. Open SMS
  2. Although not required, it is generally easier to visualize the model if reading in the hydrodynamic solution
  3. Convert the horizontal and vertical coordinates to meters. PTM cannot be run in Geographic Coordinates since it is a latitude/longitude system defined in decimal degrees.
  4. Switch to the Map module
  5. Create a PTM type coverage
  6. Create sources and traps using feature points, arcs, and polygons
  7. Switch to the Particle module
  8. Use the PTM menu to create a new PTM simulation
  9. Use the PTM menu to open the PTM Model Control dialog
    1. Specify input and output parameters in the model control
    2. Click on the Create input file(s) from data button to create a native sediment file, and hydrodynamic input files if needed. You may use mesh, water surface elevation, and velocity data from another model (ADCIRC, ADH, RMA2) to create the necessary fort.15 and/or *.h5 file.
  10. Save the simulation
  11. Use the PTM menu to perform a model check
  12. Use the PTM menu to run PTM

General Post-Processing Steps

  1. Use the display options to visualize the results
  2. Use the Data Calculator or Create Datasets dialog to create particle datasets
  3. Create a Cartesian Grid and use the Create Grid Datasets dialog to create Cartesian grid datasets
  4. Review the Trap Output files in an ASCII file viewer

External Links

  • U.S. Army Corps of Engineers DOER PTM website [1]
  • 2005 ERDC TN-DOER-D4 Particle Tracking Model (PTM) in the SMS: I. Graphical Interface [2]
  • 2005 ERDC TN-DOER-D5 Particle Tracking Model (PTM): II. Overview of Features and Capabilities [3]
  • 2005 ERDC TN-DOER-D6 Particle Tracking Model (PTM) in the SMS: III. Tutorial with Examples [4]
  • 2006 ERDC/CHL TR-06-20 PTM: Particle Tracking Model Report 1: Model Theory, Implementation, and Example Applications [5]
  • 2008 ERDC/CHL CHETN-IV-71 Particle Tracking Model (PTM) in the SMS 10: IV. Link to Coastal Modeling System [6]
  • 2007 The Particle Tracking Model: Description and Processes [7]
  • 2009 Assessment of Dredging-Induced Sedimentation on Winter Flounder Spawning habitat [8]
  • 2012 Use of the PTM with CMS Quadtree Grids[9]

Related Topics