SMS:ADH Model Control Model Parameters

File:ADH Model Control Parameters.jpg

Model Parameters tab of the ADH Model Control dialog

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.

Model Parameters

The model parameters window is divided into four sections including:

• Operation
• Wind Stations
• Density effects
• Bendway correction

Each of these sections are described below.

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)

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.

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

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.

Density effects

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.

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. Currently we do not recommended overriding the empirical coefficients.

Related Topics

• ADH Model Control