SMS:PTM: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
Line 49: Line 49:
# Use the [[SMS:PTM Graphical Interface#PTM Menu|''PTM'' Menu]] to run PTM
# Use the [[SMS:PTM Graphical Interface#PTM Menu|''PTM'' Menu]] to run PTM


== 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 [[Data Calculator|''Data Calculator'']] or [[SMS: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


==External Links==
==External Links==

Revision as of 18:07, 9 July 2013

PTM
Model Info
Model type Lagrangian particle tracker designed to allow the user to simulate 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
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.

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.

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 PTM Graphical Interface for more information.

The 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 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.

Theoretical Basis / Mathematical Details

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 your model if you read 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
  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]
  • Sep 2006 ERDC/CHL TR-06-20 PTM: Particle Tracking Model Report 1: Model Theory, Implementation, and Example Applications [2]
  • Jul 2005 ERDC TN-DOER-D4 Particle Tracking Model (PTM) in the SMS: I. Graphical Interface [3]
  • Jul 2005 ERDC TN-DOER-D5 Particle Tracking Model (PTM): II. Overview of Features and Capabilities [4]
  • Jul 2005 ERDC TN-DOER-D6 Particle Tracking Model (PTM) in the SMS: III. Tutorial with Examples [5]
  • Jul 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]
  • Application of the Particle Tracking Model to Predict the Farfield Fate of:
    • 2007 Sediment Suspended by Nearshore Dredging and Placement, Brunswick, GA [8]
    • 2008 Dredged Suspended Sediment at the Willamette River [9]
  • 2009 Assessment of Dredging-Induced Sedimentation on Winter Flounder Spawning habitat [10]

Related Topics