SMS:PTM: Difference between revisions
Line 31: | Line 31: | ||
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 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 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. | 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. | ||
===PTM Menu=== | ===PTM Menu=== |
Revision as of 17:40, 1 December 2014
PTM | |
---|---|
Model Info | |
Model type | Lagrangian particle tracker designed to allow the user to simulate particle transport processes. |
Developer |
Neil J. MacDonald, Ph.D. |
Web site | PTM web site |
Tutorials |
Models Section
|
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.
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 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.
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.
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
- Open SMS
- 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 Coordinates since it is a latitude/longitude system defined in decimal degrees.
- Switch to the Map Module
- Create a PTM type coverage
- Create sources and traps using feature points, arcs, and polygons
- Switch to the Particle Module
- Use the PTM menu to create a new PTM simulation
- Use the PTM menu to open the PTM Model Control dialog
- Specify input and output parameters in the model control
- Click on the Create input file(s) from data button to create a native sediment file, and hydrodynamic input files if needed
- Save the simulation
- Use the PTM menu to perform a model check
- Use the PTM menu to run PTM
General Post-Processing Steps
- Use the display options to visualize the results
- Use the Data Calculator or Create Datasets dialog to create particle datasets
- Create a Cartesian Grid and use the Create Grid Datasets dialog to create Cartesian grid datasets
- 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:
- 2009 Assessment of Dredging-Induced Sedimentation on Winter Flounder Spawning habitat [10]
Related Topics
SMS – Surface-water Modeling System | ||
---|---|---|
Modules: | 1D Grid • Cartesian Grid • Curvilinear Grid • GIS • Map • Mesh • Particle • Quadtree • Raster • Scatter • UGrid | |
General Models: | 3D Structure • FVCOM • Generic • PTM | |
Coastal Models: | ADCIRC • BOUSS-2D • CGWAVE • CMS-Flow • CMS-Wave • GenCade • STWAVE • WAM | |
Riverine/Estuarine Models: | AdH • HEC-RAS • HYDRO AS-2D • RMA2 • RMA4 • SRH-2D • TUFLOW • TUFLOW FV | |
Aquaveo • SMS Tutorials • SMS Workflows |