SMS:PTM Model Control: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The [[SMS:PTM|PTM]] model control is used to create the [[SMS:PTM_Program Control File|program control file]], which contains general simulation options. Refer to the PTM manual[SMS:PTM#External Links] for a more detailed description of how these parameters affect the model results.
The [[SMS:PTM|PTM]] model control is used to create the [[SMS:PTM Control File|program control file]], which contains general simulation options. Refer to the [[SMS:PTM#External Links|PTM manual]] for a more detailed description of how these parameters affect the model results.


== Time ==
== Time ==
The ''Time'' tab is used to specify time information to be written to the [[SMS:PTM Program Control File|program control file]].  If a control on the dialog is not enabled, the corresponding keyword will not be written to the [[SMS:PTM Program Control File|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.
[[Image:PTM MC Time.png|thumb|450 px|''PTM Model Control'' dialog showing the ''Time'' tab]]
The ''Time'' tab is used to specify time information to be written to the [[SMS:PTM Control File|program control file]].  If a control on the dialog is not enabled, the corresponding keyword will not be written to the [[SMS:PTM Control File|program control file]].  Controls on the dialog are disabled based on the options 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 ==
== Files ==
The ''Files'' tab is used to specify [[SMS:PTM Files#Input Files|input]] and [[SMS:PTM Files#Output Files|output]] file information to be written to the [[SMS:PTM Program Control File|program control file]].
[[Image:PTM MC Files.png|thumb|450 px|''PTM Model Control'' dialog showing the ''Files'' tab]]
The ''Files'' tab is used to specify [[SMS:PTM Files#Input Files|input]] and [[SMS:PTM Files#Output Files|output]] file information to be written to the [[SMS:PTM Control File|program control file]] (*.pcf).


Pressing the '''Create input file(s) from data...''' button on the ''Files'' tab will open the ''Create PTM External Input Files'' dialog.
Pressing the '''Create input file(s) from data...''' button on the ''Files'' tab will open the ''Create PTM External Input Files'' dialog. This dialog can import results from ADCIRC, ADH, SRH-2D, CMS-FLOW or other models to create a mesh (fort.14) file, grain size native sediment (*.sediment) file, and/or a XMDF hydrodynamic input flow file (*.h5) to import into a PTM model. This option is not necessary for basic ADCIRC and CMS-FLOW models since their files will import into PTM if specified in the input files section.
*'''''Note:''''' SMS is not capable of importing RMA2 and FESWMS files into PTM at this time.


===Native Sediment Grain Size===
===Native Sediment Grain Size===
# 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.
# If "Uniform bed" is selected from the "Options" column an '''Options''' button is displayed under "Filename".  Pressing this button allows creating uniform grain sizes for D35, D50 and D90 (where D35 means 35% of the grains are smaller than diameter D).  If the project is saved, the :SEDIMENT_FORMAT card is created, with the keyword UNIFORM and the 3 grain sizes being written out.
# If Sediment file is selected, the user can manually select the filename by pressing the button under "Filename".   
# If Sediment file is selected, manually select the file name by pressing the button under "Filename".   
# 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".
# 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". The user can enter in the D values with the constant mobile bed type or a Nikuradse‘s equivalent sand roughness Ks (surface roughness height which equals D90) for the constant fixed bed type or use a dataset for spatially varied grain sizes.
 
[[Image:PTM Create External Input.png|thumb|none|left|500 px|''Create PTM External Input Files'' dialog]]


== Computations ==
== Computations ==
The ''Computations'' tab is used to specify model computation options to be written to the [[SMS:PTM Program Control File|program control file]].
[[Image:PTM MC Computations.png|thumb|450 px|''PTM Model Control'' dialog showing the ''Computations'' tab]]
The ''Computations'' tab is used to specify model computation options to be written to the [[SMS:PTM Control File|program control file]]. This tab has the following input fields:
*Computation Methods
*Computation Methods
**Advection
**Advection
Line 22: Line 45:
**Eulenian
**Eulenian
**Velocity
**Velocity
**Numirical scheme
**Numerical scheme
*Computational Parameters
*Computational Parameters
**Bed porosity
**Bed porosity
Line 46: Line 69:


== Output ==
== Output ==
The ''Output'' tab is used to specify model output options to be written to the [[SMS:PTM Program Control File|program control file]].
[[Image:PTM MC Output.png|thumb|450 px|''PTM Model Control'' dialog showing the ''Output'' tab]]
The ''Output'' tab is used to specify model output options to be written to the [[SMS:PTM Control File|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==
* [[SMS:PTM|PTM]]




Line 53: Line 106:


[[Category:PTM|M]]
[[Category:PTM|M]]
[[Category:PTM Dialogs|M]]
[[Category:SMS Model Control|P]]

Latest revision as of 17:33, 10 January 2020

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

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

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 (*.pcf).

Pressing the Create input file(s) from data... button on the Files tab will open the Create PTM External Input Files dialog. This dialog can import results from ADCIRC, ADH, SRH-2D, CMS-FLOW or other models to create a mesh (fort.14) file, grain size native sediment (*.sediment) file, and/or a XMDF hydrodynamic input flow file (*.h5) to import into a PTM model. This option is not necessary for basic ADCIRC and CMS-FLOW models since their files will import into PTM if specified in the input files section.

  • Note: SMS is not capable of importing RMA2 and FESWMS files into PTM at this time.

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 creating uniform grain sizes for D35, D50 and D90 (where D35 means 35% of the grains are smaller than diameter D). 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, manually select the file name 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". The user can enter in the D values with the constant mobile bed type or a Nikuradse‘s equivalent sand roughness Ks (surface roughness height which equals D90) for the constant fixed bed type or use a dataset for spatially varied grain sizes.
Create PTM External Input Files dialog

Computations

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
    • Numerical 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

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