SMS:PTM Graphical Interface: Difference between revisions
(30 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{TOCright}} | |||
The SMS interface to [[SMS:PTM|PTM]] includes tools for creating input files as well as post-processing capabilities. The PTM interface includes the following components: | The SMS interface to [[SMS:PTM|PTM]] includes tools for creating input files as well as post-processing capabilities. The PTM interface includes the following components: | ||
== PTM Menu == | |||
The following menu commands are available in the [[SMS:PTM|''PTM'']] Menu: | |||
; '''New Simulation''' : Creates a new PTM simulation and adds it to the [[SMS:Project Explorer|Project Explorer]]. | |||
; [[SMS:Model Checker|'''Model Check''']] : Checks the active PTM simulation for common input errors. | |||
; [[SMS:PTM Model Control|'''Model Control''']] : Opens the ''Model Control'' dialog (used to organize input files, specify model parameters, choose output options, etc.). | |||
; '''Run Model''' : Launches the PTM model using the active PTM simulation input files. | |||
== Model Control == | == Model Control == | ||
The [[SMS:PTM Model Control|PTM Model Control | The [[SMS:PTM Model Control|''PTM Model Control'' dialog]] is used to setup the options that apply to the simulation as a whole. These options include time controls, computation parameters, output options, and other global settings. | ||
== Running the Model == | |||
The [[SMS:PTM Files|PTM files]] are written automatically with the SMS project file or can be saved separately using the ''File'' | '''Save PTM''' or ''File'' | '''Save As''' menu commands. See [[SMS:PTM Files|PTM Files]] for more information on the files used for the [[SMS:PTM|PTM]] run. | |||
[[SMS:PTM|PTM]] can be launched from SMS using the ''PTM'' | '''Run Model''' menu command. A check of some of the common problems called the ''Model Checker'' is done each time the model is launched, or by selecting the ''PTM'' | '''Model Check''' menu command. | |||
==PTM Model Check== | |||
The [[SMS:Model Checker|model check]] will give a warning if it suspects a potential error has been made in creating the input files for PTM and suggest how to resolve the issue. The issues shown in the model checker may or may not cause problems, it is left to the modeler to decide if an issue will affect the results of their simulation. | |||
== Map Module == | == Map Module == | ||
PTM sources and traps are created in the [[SMS:Map_Module|Map | PTM sources and traps are created in the [[SMS:Map_Module|Map module]] as [[SMS:Feature Objects Types|feature objects]] in a PTM type [[SMS:Coverages|coverage]]. | ||
=== Feature Points === | === Feature Points === | ||
* Instant Mass Source | * Instant Mass Source – Release at a single point in time (Ex. accidental vessel spill) | ||
* Point Mass Rate Source | * Point Mass Rate Source – Release over a period of time (Ex. leaking pipeline) | ||
* Vertical Line Source | * Vertical Line Source – Release with a uniform distribution along the line and a two-dimensional Gaussian distribution in the plane perpendicular to the line (Ex. bucket dredge) | ||
=== Feature Arcs === | === Feature Arcs === | ||
* Horizontal Line Source | * Horizontal Line Source – Release with a uniform distribution along the line and a two-dimensional Gaussian distribution in the plane perpendicular to the line | ||
* Horizontal Line Trap | * Horizontal Line Trap – Count particles crossing a line | ||
* Vertical Area Source | * Vertical Area Source – Under development | ||
=== Feature Polygons === | === Feature Polygons === | ||
* Horizontal Area Source | * Horizontal Area Source – Release with a uniform distribution over the area and a Gaussian distribution perpendicular to the source | ||
* Horizontal Area Trap | * Horizontal Area Trap – Count particles entering an area | ||
For more information on sources, see [[SMS:PTM Sources|PTM Sources]]. | For more information on sources, see [[SMS:PTM Sources|PTM Sources]]. | ||
For more information on traps, see [[SMS:PTM Traps|PTM Traps]]. | For more information on traps, see [[SMS:PTM Traps|PTM Traps]]. | ||
== | ====Polygon Attributes Dialog==== | ||
Feature polygons created in a PTM type coverage can be used to create either [[SMS:PTM_Sources|sources]] or [[SMS:PTM Traps|traps]]. | |||
==Related Topics== | |||
* [[SMS:PTM|PTM]] | |||
== | |||
{{Template: | {{Template:Navbox SMS}} | ||
[[Category:SMS Particle|G]] | [[Category:SMS Particle|G]] | ||
[[Category:PTM|G]] | [[Category:PTM|G]] | ||
[[Category:SMS Menus|PTM]] |
Latest revision as of 15:48, 13 September 2017
The SMS interface to PTM includes tools for creating input files as well as post-processing capabilities. The PTM interface includes the following components:
PTM Menu
The following menu commands are available in the PTM Menu:
- New Simulation
- Creates a new PTM simulation and adds it to the Project Explorer.
- Model Check
- Checks the active PTM simulation for common input errors.
- Model Control
- Opens the Model Control dialog (used to organize input files, specify model parameters, choose output options, etc.).
- Run Model
- Launches the PTM model using the active PTM simulation input files.
Model Control
The PTM Model Control dialog is used to setup the options that apply to the simulation as a whole. These options include time controls, computation parameters, output options, and other global settings.
Running the Model
The PTM files are written automatically with the SMS project file or can be saved separately using the File | Save PTM or File | Save As menu commands. See PTM Files for more information on the files used for the PTM run.
PTM can be launched from SMS using the PTM | Run Model menu command. A check of some of the common problems called the Model Checker is done each time the model is launched, or by selecting the PTM | Model Check menu command.
PTM Model Check
The model check will give a warning if it suspects a potential error has been made in creating the input files for PTM and suggest how to resolve the issue. The issues shown in the model checker may or may not cause problems, it is left to the modeler to decide if an issue will affect the results of their simulation.
Map Module
PTM sources and traps are created in the Map module as feature objects in a PTM type coverage.
Feature Points
- Instant Mass Source – Release at a single point in time (Ex. accidental vessel spill)
- Point Mass Rate Source – Release over a period of time (Ex. leaking pipeline)
- Vertical Line Source – Release with a uniform distribution along the line and a two-dimensional Gaussian distribution in the plane perpendicular to the line (Ex. bucket dredge)
Feature Arcs
- Horizontal Line Source – Release with a uniform distribution along the line and a two-dimensional Gaussian distribution in the plane perpendicular to the line
- Horizontal Line Trap – Count particles crossing a line
- Vertical Area Source – Under development
Feature Polygons
- Horizontal Area Source – Release with a uniform distribution over the area and a Gaussian distribution perpendicular to the source
- Horizontal Area Trap – Count particles entering an area
For more information on sources, see PTM Sources. For more information on traps, see PTM Traps.
Polygon Attributes Dialog
Feature polygons created in a PTM type coverage can be used to create either sources or traps.
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 |