SMS:ADH Model Control Model Parameters: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(30 intermediate revisions by the same user not shown)
Line 1: Line 1:
[[Image:ADH Model Control Parameters.jpg|thumb|500 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.


===Wind Stations (XYC cards)===
==Density Effects==
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.  
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.


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


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


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


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


===Density effects===
The ''Override empirical coefficients'' toggle activates the edit fields for the other coefficientsIf 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.'''''
The ADH model includes the ability to simulate the effects of salinity and temperature on flowThis section includes two toggles for the user to activate these options.
====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)===
==Wind Stations (XYC Cards)==
The SW2 option in ADH simulates two-dimensional flowHowever, some three dimensional effects can be approximatedThis 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.
Wind can be included in a number of ways in an ADH simulationThese include on a material by material basis described in a different sectionThe ''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.  


When the feature is active, The user must also specify three coefficientsThese include the As and Ds empirical coefficients determined by integrating against measured values (defaults of 5.0 and 0.5) and a normalization factor.
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 simulationClicking on the '''Select...''' button opens the ''Select Coverage'' window which lists all available spatial data coverages.  


The ''Override empirical coefficients'' toggle activates the edit fields for the other coefficientsIf 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>
SMS will write an <font color="green">XYC</font> card for each wind stationThis card defines the curve containing the wind data and the location of the station.


==Obsolete==
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).
The Operations section has been moved to the ''Solver'' tab in the ''ADH Model Control'' dialog.
===Operation===
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 ADH. The other operational parameters specified in this section include:


====Memory allocation block size (OP INC card)====
For more information see [[SMS:ADH Wind Stations|Wind Stations]].
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.
 
====Iterative solver pre-conditioner (OP PRE and BLK cards)====
The ''Iterative solver pre-conditioner'' parameters apply to parallel processing applications. If running ADH in single processor mode, this card has no impact.
 
If 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 schemes.  We recommend the defaults of "One-level Additive Schwarz" and "1 block per processor".
 
====Vessel stress effects (OP BT card)====
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 enabling this option, make sure there are vessel coverages in the simulation and that each boat has propellers defined.


==Related Topics==
==Related Topics==
Line 61: Line 47:


[[Category:SMS_Dev]]
[[Category:SMS_Dev]]
[[Category:SMS Dialogs|A]]
[[Category:ADH Dialogs|mod]]
[[Category:ADH|M]]
[[Category:ADH|M]]
[[Category:SMS Model Control|A]]
[[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