SMS:PTM Model Control

From XMS Wiki
Revision as of 15:55, 18 December 2013 by Jcreer (talk | contribs) (→‎Time)
Jump to navigationJump to search

The PTM model control is used to create the program control file, which contains general simulation options. Refer to the PTM manual for a more detailed description of how these parameters affect the model results.

Time

File:PTM MC Time.jpg
PTM Model Control dialog showing the Time tab

The Time tab is used to specify time information to be written to the program control file. If a control on the dialog is not enabled, the corresponding keyword will not be written to the program control file. Controls on the dialog are disabled based on the options you have chosen on the other model control tabs. For example, if no trap file is specified on the Files tab, the time controls related to traps will not be available. There is a plot on the dialog of the specified times. This tab has the following inpute fields:

  • Simulation
  • Start
  • Stop
  • Duration
  • Time Step
  • Particle Output
  • Shear, Bedforms, and Mobility Updates
  • Mapping Output
  • Flow and Elevation Update
  • Waves
  • Start
  • Time Step
  • Hydrodynamics
  • Traps
  • Start
  • Stop
  • Last time step trap

Files

File:PTM MC Files.jpg
PTM Model Control dialog showing the Files tab

The Files tab is used to specify input and output file information to be written to the program control file.

Pressing the Create input file(s) from data... button on the Files tab will open the Create PTM External Input Files dialog.

Native Sediment Grain Size

  1. If "Uniform bed" is selected from the "Options" column an Options button is displayed under "Filename". Pressing this button allows the user to create uniform grain sizes for D35, D50 and D90. If the project is saved, the :SEDIMENT_FORMAT card is created, with the keyword UNIFORM and the 3 grain sizes being written out.
  2. If Sediment file is selected, the user can manually select the filename by pressing the button under "Filename".
  3. Pressing the Create input file(s) from data and selecting to create a Native sediment grain size file will automatically toggle the native sediments grain size to "sediments file" and place the new file under the "Filename".
File:PTM Create External Input.jpg
Create PTM External Input Files dialog

Computations

File:PTM MC Computations.jpg
PTM Model Control dialog showing the Computations tab

The Computations tab is used to specify model computation options to be written to the program control file. This tab has the following input fields:

  • Computation Methods
    • Advection
    • Centroid
    • Distribution
    • Eulenian
    • Velocity
    • Numirical scheme
  • Computational Parameters
    • Bed porosity
    • Temperature
    • Bed density
    • Salinity
    • Minimum depth
  • Diffusion Parameters
    • Min. diffusion coefficient
    • Turbulent diffusion scalar
    • Wave diffusion scalar
  • Model Calculation Options
    • Currents
    • Morphology
    • Neutrally buoyant particles
    • Bedforms
    • Hiding and exposure
    • Particle-bed interaction
    • Turbulent shear
    • Source and trap Z-value relative to datum
    • Residency (polygon trap required)
    • Wave mass transport

Output

File:PTM MC Output.jpg
PTM Model Control dialog showing the Output tab

The Output tab is used to specify model output options to be written to the program control file. This tab has the following input fields:

  • File Output
    • Print default keywords
    • Compress XMDF files
    • Tecplot map data
    • Tecplot particle data
    • Tecplot particle path data
    • tecplot population history
  • Mapping Output (on Hydrodynamic Grid)
    • Bed evolution
    • Bed level change
    • Flow conditions
    • Mobility of native sediments
    • Native sediment bedforms
    • Potential sediment transport rate
    • Shear stress
    • Wave parameters
  • Particle Output
    • Critical shear
    • Density
    • Fall velocity
    • Grain size
    • Height above the bed
    • Mass
    • Mobility
    • Source
    • State
    • Velocity components

Related Topics