SMS:ADH Model Control Model Parameters: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
No edit summary
 
(53 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[SMS:ADH Model Control | Go to ADH Model Control page]]
__NOINDEX__
{{SMS Deprecated Feature}}
[[Image:ADH Model Control Parameters.png|thumb|500 px|The ''Model Parameters'' tab of the ''ADH Model Control'' dialog]]
General model parameters are set is the [[SMS:ADH Model Control|''ADH Model Control'']] dialog (''ADH'' | '''Model Control...''' command). It is accessed in the ''ADH Model Control'' dialog by clicking on the ''Model Parameters'' tab.


{{SMS_Dev}}
The model parameters window is divided into three sections:
* Wind Stations
* Density effects
* Bendway correction


This page window is accessed from the Model Control window by clicking on the ''Model Parameters'' tab.
Each of these sections are described below.


== Dialog Description ==
==Density Effects==
The ADH model includes the ability to simulate the effects of salinity and temperature on flow.  This section includes two check boxes to activate these options.


The following controls specify how the ADH model will solve (operate and iterate through) the simulation.  
''Salinity (CN SAL Card)''
:The ''Include salinity'' check box with the associated reference concentration allows turning on the simulation of salinity and define a positive non-zero real number for the background or reference concentration . The concentration is specified in parts per thousand.


=== Non-Linear Iterations ===
''Temperature (CN TMP Card)''
:The ''Include temperature'' check box with the associated ''Reference temperature'' allows turning on the inclusion of temperature effects in the simulation of specify a positive non-zero real number which correlates to the CN TMP card reference temperature. The temperature is measured in degrees.


''Maximum number of iterations per time step'' positive integer edit field provides the value for the <font color="green">IP NIT</font> or <font color="green">IP FNI</font> card.
==Bendway Correction (CN VOR Card)==
The SW2 option in ADH simulates two-dimensional flow.  However, some three dimensional effects can be approximated.  This includes a method for correcting  for the  effects of vorticity around bends. Selecting the ''Include vorticity'' check box will cause SMS to add this card and activate this feature.  It also adds the <font color="green">OP TRN</font> card since vorticity is simulated in ADH as a transport constituent.


''Iteration tolerance'' positive real number edit field provides the value for the <font color="green">IP NTL</font> card.
When the feature is active, it's necessary to specify three coefficients.  These include the As and Ds empirical coefficients determined by integrating against measured values (defaults of 5.0 and 0.5) and a normalization factor.


''Reduce timestep / Accept solution'' radio group specifies with the inclusion of the <font color="green">IP NIT</font> or <font color="green">IP FNI</font> card respectively.
The ''Override empirical coefficients'' toggle activates the edit fields for the other coefficients. If the option is unchecked, the coefficients will be reset to the default values. Zero values for both coefficients will assume the default values. '''''Currently it is not recommended  to override the empirical coefficients.'''''


''Increment tolerance'' check box and the associated ''Residual tolerance'' positive real number edit field correlates with the <font color="green">IP ITL</font> card. The card is included in the simulation if this option is checked.
==Wind Stations (XYC Cards)==
Wind can be included in a number of ways in an ADH simulation.  These include on a material by material basis described in a different section.  The ''Include wind stations (defined on spatial data coverage)'' check box specifies that wind shear stress should be included in the simulation, computed from a set of spatially defined wind stations. This check box is only available if at least one spatial data coverage exits. In the spatial data coverage define a set of wind gages (defined as feature points) with time series of wind data associated.  


=== Linear Iterations By Solver ===
If more than one spatial data coverage is defined, the associated '''Select...''' button undims and a single set of wind data can be selected for the current simulation.  Clicking on the '''Select...''' button opens the ''Select Coverage'' window which lists all available spatial data coverages.


''Maximum number of iterations'' positive integer edit field  provides the value for the <font color="green">IP MIT</font> or <font color="green">IP FLI</font> card.
SMS will write an <font color="green">XYC</font> card for each wind station.  This card defines the curve containing the wind data and the location of the station.


''Stop the solution / Proceed to the next non-linear iteration'' radio group specifies with the inclusion of the <font color="green">IP MIT</font> or <font color="green">IP FLI</font> card respectively.
Specify curve fit tolerance check box and the associated positive integer edit field specify whether a tolerance for all wind time series is included and its value. These controls are enabled only if a coverage is selected (the tolerance check box must also checked to enable the edit field).


=== Operation ===
For more information see [[SMS:ADH Wind Stations|Wind Stations]].


''Incremental memory allocation block size'' check box with positive integer edit field correlates with the <font color="green">OP INC</font> card.
==Related Topics==
* [[SMS:ADH Model Control | ADH Model Control]]


''Iterative solver pre-conditioner'' check box and the associated pre-conditioner combo-box and ''Block specification'' check box with positive integer edit field control group is tied to the <font color="green">OP PRE</font> and <font color="green">OP BLK</font> cards.


''Include vessel movement library'' check box includes the <font color="green">OP BT</font> card in the simulation when checked.




[[SMS:ADH Model Control | Go to ADH Model Control page]]
{{Template:Navbox SMS}}


[[Category:SMS_Dev]]
[[Category:SMS_Dev]]
[[Category:ADH Dialogs|mod]]
[[Category:ADH|M]]
[[Category:SMS Model Control|A]]
[[Category:Parameters|ADH]]

Latest revision as of 20:18, 11 September 2023

The Model Parameters tab of the ADH Model Control dialog

General model parameters are set is the ADH Model Control dialog (ADH | Model Control... command). It is accessed in the ADH Model Control dialog by clicking on the Model Parameters tab.

The model parameters window is divided into three sections:

  • Wind Stations
  • Density effects
  • Bendway correction

Each of these sections are described below.

Density Effects

The ADH model includes the ability to simulate the effects of salinity and temperature on flow. This section includes two check boxes to activate these options.

Salinity (CN SAL Card)

The Include salinity check box with the associated reference concentration allows turning on the simulation of salinity and define a positive non-zero real number for the background or reference concentration . The concentration is specified in parts per thousand.

Temperature (CN TMP Card)

The Include temperature check box with the associated Reference temperature allows turning on the inclusion of temperature effects in the simulation of specify a positive non-zero real number which correlates to the CN TMP card reference temperature. The temperature is measured in degrees.

Bendway Correction (CN VOR Card)

The SW2 option in ADH simulates two-dimensional flow. However, some three dimensional effects can be approximated. This includes a method for correcting for the effects of vorticity around bends. Selecting the Include vorticity check box will cause SMS to add this card and activate this feature. It also adds the OP TRN card since vorticity is simulated in ADH as a transport constituent.

When the feature is active, it's necessary to specify three coefficients. These include the As and Ds empirical coefficients determined by integrating against measured values (defaults of 5.0 and 0.5) and a normalization factor.

The Override empirical coefficients toggle activates the edit fields for the other coefficients. If the option is unchecked, the coefficients will be reset to the default values. Zero values for both coefficients will assume the default values. Currently it is not recommended to override the empirical coefficients.

Wind Stations (XYC Cards)

Wind can be included in a number of ways in an ADH simulation. These include on a material by material basis described in a different section. The Include wind stations (defined on spatial data coverage) check box specifies that wind shear stress should be included in the simulation, computed from a set of spatially defined wind stations. This check box is only available if at least one spatial data coverage exits. In the spatial data coverage define a set of wind gages (defined as feature points) with time series of wind data associated.

If more than one spatial data coverage is defined, the associated Select... button undims and a single set of wind data can be selected for the current simulation. Clicking on the Select... button opens the Select Coverage window which lists all available spatial data coverages.

SMS will write an XYC card for each wind station. This card defines the curve containing the wind data and the location of the station.

Specify curve fit tolerance check box and the associated positive integer edit field specify whether a tolerance for all wind time series is included and its value. These controls are enabled only if a coverage is selected (the tolerance check box must also checked to enable the edit field).

For more information see Wind Stations.

Related Topics