SMS:ADH Model Control Model Parameters: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(40 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Image:ADH Model Control Parameters.jpg|thumb|400 px|''Model Parameters'' tab of the ''ADH Model Control'' dialog]]
__NOINDEX__
This window is part of the ''ADH model control'' dialog (''ADH''|'''Model Control...''' command). It is accessed from the ''Model Control'' window by clicking on the ''Model Parameters'' tab.  
{{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.  


==Model Parameters==
The model parameters window is divided into three sections:
The model parameters window is divided into four sections including:
* Operation
* Wind Stations
* Wind Stations
* Density effects
* Density effects
Line 11: Line 11:
Each of these sections are described below.
Each of these sections are described below.


===Operation===
==Density Effects==
The operation section contains controls to specify general operation parameters for ADH. SMS automatically writes the OP SW2 card to all ADH boundary condition files because SMS interfaces with the 2D shallow water problems simulated by ADHThe other operational parameters specified in this section include:
The ADH model includes the ability to simulate the effects of salinity and temperature on flowThis section includes two check boxes to activate these options.


====Memory allocation block size (OP INC card)====
''Salinity (CN SAL Card)''
The ''Incremental memory allocation'' block size edit field allows the user to specify a positive integer defining the size of the incremental memory allocations. The default value is 40 units and no explanation has been provided for when or what to change this to. We recommend most users leave the default value.
: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.


====Iterative solver pre-conditioner (OP PRE and BLK cards)====
''Temperature (CN TMP Card)''
The ''Iterative solver pre-conditioner'' parameters apply to parallel processing applications. If you are running ADH in single processor mode, this card has no impact.
: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.


If you are running ADH in parallel mode, the edit field defines how many blocks per processor are to be used in the preconditioning which subdivides the problem for each processor. No guidance has been provided by the AdH development team about when to use different pre-conditioning schemesWe recommend the defaults of "One-level Additive Schwarz" and "1 block per processor".
==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 featureIt also adds the <font color="green">OP TRN</font> card since vorticity is simulated in ADH as a transport constituent.


====Vessel stress effects (OP BT 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.
This toggle instructs SMS to write the OP BTS card which includes vessel stress effects check in the simulation when checked. This calculates and outputs bed shear stresses due to vessels in dyn/cms. This currently requires use of metric units. If you enable this option, make sure you have vessel coverages in your simulation and that each boat has propellers defined.


===Wind Stations (XYC cards)===
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 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 lets the user specify that wind shear stress should be included in the simulation, computed from a set of spatially defined wind stations. The Include check box is only available if at least one spatial data coverage exits. In the spatial data coverage the user should 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 the user can select a single set of wind data for the current simulation. Clicking on the '''Select...''' button opens the ''Select Coverage'' window which lists all available spatial data coverages.  
==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.  


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


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).
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).
Line 36: Line 38:
For more information see [[SMS:ADH Wind Stations|Wind Stations]].
For more information see [[SMS:ADH Wind Stations|Wind Stations]].


===Density effects===
==Related Topics==
The ADH model includes the ability to simulate the effects of salinity and temperature on flow.  This section includes two toggles for the user to activate these options.
* [[SMS:ADH Model Control | ADH Model Control]]
====Salinity (CN SAL card)====
The ''Include salinity'' check box with the associated Reference concentration allow the user to turn 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'' allow the user to turn 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, The user must also 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. <u>Currently we do not recommended  overriding the empirical coefficients.</u>


==Related Topics==
{{Template:Navbox SMS}}
* [[SMS:ADH Model Control | ADH Model Control]]


[[Category:SMS_Dev]]
[[Category:SMS_Dev]]
 
[[Category:ADH Dialogs|mod]]
 
[[Category:ADH|M]]
{{Template:Navbox SMS}}
[[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