User:Jcreer/SMS:AdH Interface

From XMS Wiki
Jump to navigationJump to search

AdH Coverages

The AdH interface includes a few map coverages. These map coverages are used to provide input for the AdH simulation. AdH use the following model specific coverages:

  • Boundary Conditions
  • Materials
  • Sediment Materials

AdH Boundary Conditions

ADH boundary conditions consist of two specification types (Dirichlet and Natural) and three condition types (flow, pressure, and transport). Dirichlet data is applied on the domain to individual nodes or to groups of nodes (defined with nodestrings). Natural data (flux) is applied through edges of the domain defined by nodestrings and includes a friction specification. A node or nodestring can be assigned only one condition option from each of the three condition types (two flow conditions cannot be assigned to a single node).

The boundary conditions coverage for AdH allows assigning boundary condition attributes for both arcs and points.

Arc Attributes

Example of the AdH Arc Attributes dialog

The Arc Attributes dialog is reached by right-clicking on an arc in the AdH boundary conditions and selecting the Assign Arc Attributes command. In the dialog, the Arc type option have several boundary condition attributes for the selected arc. The following Arc type options are as follows:

  • "Off" – No attributes will be assigned to the arc.
  • "Natural outflow (OB OF)" – allows flow out without any modification to flow properties. Can be specified on boundaries where the exact flow conditions are unknown.
  • "Discharge (NB DIS)" – Applies subcritical inflow as a natural total discharge boundary condition.
    • Discharge – Clicking Edit opens the XY Series Editor dialog where discharge values can be entered.
  • "Flow (NB OVL)" – Applies inflow as a natural unit discharge boundary condition.
    • Flow per unit area – Clicking Edit opens the XY Series Editor dialog where discharge values can be entered.
  • "Water surface elevation (NB OTW)" – Links a particular time series of water surface elevation to the boundary condition.
    • Elevation – Clicking Edit opens the XY Series Editor dialog where water surface elevation values can be entered.
  • "Spillway (NB SPL)" – Specifies spillway flow.
    •  % flow out – Clicking Edit opens the XY Series Editor dialog where weir coefficient values can be entered.
  • "Tidal boundary (NB TID)" – Indicates tidal constituents will be applied to the boundary.
  • "Stage discharge boundary (NB SDR)" – Specifies a stage-discharge boundary.
    • Coefficient – Specified constants for coefficients A–E.
  • "Velocity and depth (DB OVH)" – Dirichlet boundary condition for supercritical flow.
    • Snapping type – Defines how the boundary conditions are applied to mesh.
      • "Point snap" – Applies the attributes to the mesh nodes or points upon export.
      • "Edgestring snap" – Applies the attributes to the mesh element edge upon export.
      • "Midstring snap" – Applies the attributes to the center of the mesh elements upon export.
    • X velocity – Clicking Edit opens the XY Series Editor dialog where x-velocity values can be entered.
    • Y velocity – Clicking Edit opens the XY Series Editor dialog where y-velocity values can be entered.
    • Depth – Clicking Edit opens the XY Series Editor dialog where depth values can be entered.
  • "Stationary lid elevation (DB LDE)" – Allows assigning lid elevations to an arc.
    • Snapping type
      • Point snap
      • Edgestring snap
      • Midstring snap
    • Elevation – Clicking Edit opens the XY Series Editor dialog where elevation values can be entered.
  • "Depth of water under stationary lid (DB LDH)" – Allows assigning lid depths to an arc.
    • Snapping type
      • Point snap
      • Edgestring snap
      • Midstring snap
    • Depth – Clicking Edit opens the XY Series Editor dialog where depth values can be entered.
  • "Floating stationary object (DB LID)" – Allows assigning liddraft to an arc.
    • Snapping type
      • Point snap
      • Edgestring snap
      • Midstring snap
    • Draft of lid – Clicking Edit opens the XY Series Editor dialog where draft values can be entered.

Friction

Example of the AdH Friction dialog

Friction controls are used to compute estimated values of the friction induced by several types of bed roughness and linear roughness conditions.

Friction can be applied to a feature arc by right-clicking on the arc and selecting the Assign Friction command. In the Friction dialog, specify the Friction type as one of the following options:

  • "Off" – No friction will be applied to the arc.
  • "Manning's N (MNG)" – Friction will be applied using Manning's n.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Manning's n – Specify the value of Manning's n.
  • "Manning's Equation (MNC)" – Friction will be applied using the classic formulation Manning's n.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Manning's n – Specify the value of Manning's n.
  • "Equivalent roughness height (ERH)" – Friction will be applied using equivalent sand roughness height.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Roughness height – Enter a value for the equivalent sand roughness height.
  • "Submerged aquatic vegetation (SAV)" – Compute the drag coefficient associated with the bottom shear stress resulting from a steady current field over a bed consisting of submerged aquatic vegetation.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Roughness height of canopy – Enter a value for the roughness height of the SAV canopy.
    • Undeflected stem height – Enter a value for the undeflected stem height of the SAV.
  • "Un-submerged rigid vegetation (URV)" – Compute a shear stress coefficient for use in computing the bottom shear stress resulting from a steady current through rigid, unsubmerged vegetation.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Bed roughness height – Enter a value for the bed roughness height.
    • Average stem diameter – Enter a value for the average stem diameter.
    • Average stem density – Enter a value for the average stem density.
  • "Equivalent drag obstructions (EDO)" – Computes a shear stress coefficient for use in computing the shear stress resulting from a steady current through or over an evenly distributed field of flow obstructions.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Bed roughness height – Enter a value for the bed roughness height.
    • Obstruction diameter – Enter a value for the average obstruction diameter.
    • Obstruction height – Enter a value for the average obstruction height.
  • "Ice friction (ICE, IRH, BRH)" – Applies as a pressure field on the water surface to account for the effects that stationary ice on the water surface has on the flow below.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Ice thickness
    • Ice density – Enter a value for the density of ice.
    • Ice movement
    • Ice roughness height – Enter a value for the equivalent ice roughness height.
    • Bed roughness height – Enter a value for the equivalent bed roughness height.
  • "Dune friction (DUN)" – Invokes the bedform friction model.
    • Edge/mid string
      • Edgestring
      • Midstring
    • Dune factor – Enter a value for the bedform roughness calibration coefficient.
    • Dune SEDLIB Inclusion – Turn on to use the sediment model for bedload
    • Dune D50 – Enter a value for the d50 of the bed material.
    • Dune D90 – Enter a value for the d90 of the bed material.
  • "Submerged dike (SDK)" – Simulates the loss associated with the expansion of flow downstream of a submerged dike or weir.
    • Dike height – Enter a value for the height of the dike above the bed.
  • "Bridge deck (BRD)" – Simulates the the loss associated with a bridge deck.
    • Bridge deck elevation – Enter a value for the elevation of the bridge deck.
    • Bridge deck thickness – Enter a value for the thickness of the bridge deck.

Flux Output

The Flux Output dialog

The flux output calculates of flow and constituent mass across strings. To assign flux to a feature arc, right-click on the arc and select the Assign Flux command to open the Flux Output dialog. The Flux Output dialog contains the following options:

  • Flux output – Turn on to include fluz output calculations in the model run.
  • Edgestring – Select if the flux output is to be calculated along the edge of the mesh domain.
  • Midstring – Select if the flux output is to be calculated from internal strings inside the mesh domain.

Sediment Diversion

  • Sediment diversion
    • Edgestring/midstring
      • Edgestring
      • Midstring
    • Top elevation of the zone of withdrawal
    • Bottom elevation of the zone of withdrawal
    • Bottom elevation of the main channel

Arc Transport Constituents

Example of the Arc Transport Constituent dialog

The Arc Transport Constituents dialog allows assigning transport constituents to an arc. This requires that transport constituents component to have been created in the AdH simulation. To assign transport constituents to a feature arc, right-click on the arc and select the Assign Arc Transport command to open the Arc Transport Constituents dialog. The Arc Transport Constituents dialog contains the following options:

  • Transport constituents
    • Transport constituents
      • Name
      • Type
      • Time Series
      • Snapping Method
  • Sediment transport constituents
    • Sediment transport constituents
      • Name
      • Type
      • Time Series
      • Snapping Method

Select Transport Constituents

Example of the AdH Select Transport Constituents dialog

When working with transport constituents, the transport constituent component in the simulation needs be attached to transport constituents attributes assigned to feature objects. In the Project Explorer, right-clicking on the AdH boundary condition coverage and selecting the Assign Transport command will being up the Select Transport Constituents dialog. This dialog allows assigning the transport feature object attributes to the transport components.

  • Transport constituents – Clicking the Select button in this section will being up the Select Transport Constituents dialog. In the Select Transport Constituents dialog, the transport component can be assigned to the coverage.
  • Sediment transport constituents – Clicking the Select button in this section will being up the Select Sediment Transport Constituents dialog. In the Select Sediment Transport Constituents dialog, the transport component can be assigned to the coverage.

Point Attributes

Example of the AdH Point Attributes dialog

The Point Attributes dialog is reached by right-clicking on a point in the AdH boundary conditions and selecting the Assign Point Attributes command. In the dialog, the Point type option have several boundary condition attributes for the selected point. The following Point type options are as follows:

  • "Off" – No attributes will be assigned to the point.
  • "Velocity and depth (DB OVH)" – Dirichlet boundary condition for supercritical flow.
    • X velocity – Clicking Edit opens the XY Series Editor dialog where x-velocity values can be entered.
    • Y velocity – Clicking Edit opens the XY Series Editor dialog where y-velocity values can be entered.
    • Depth – Clicking Edit opens the XY Series Editor dialog where depth values can be entered.
  • "Stationary lid elevation (DB LDE)" – Allows assigning lid elevations to an arc.
    • Elevation – Clicking Edit opens the XY Series Editor dialog where elevation values can be entered.
  • "Depth of water under stationary lid (DB LDH)" – Allows assigning lid depths to an arc.
    • Depth – Clicking Edit opens the XY Series Editor dialog where depth values can be entered.
  • "Floating stationary object (DB LID)" – Allows assigning liddraft to an arc.
    • Draft of lid – Clicking Edit opens the XY Series Editor dialog where draft values can be entered.
  • "Wind Definition (OP WND)" – Defines wind stressing.
    • Wind – Clicking Edit opens the XY Series Editor dialog where wind values can be entered.

AdH Materials

AdH Sediment Materials

AdH Simulation

Example of an AdH simulation in the Project Explorer

Simulations are available for AdH starting in SMS 13.3. A simulation should contain a 2D mesh and an AdH boundary conditions coverage, and optional AdH coverages. Right-clicking on the simulation will display options and dialogs.

To create a new simulation:

  1. Right-click on empty space in the Project Explorer and select New Simulation | AdH. A new tree item Simulation Folder Icon.svg will appear.
  2. Drag and drop simulation components under the newly created simulation tree item Simulation Icon.svg. Components available include:
    • 2D mesh
    • Boundary Conditions coverage
    • Materials coverage

Multiple AdH simulations can be included in a single project.

Simulation Components

An AdH simulation uses the following components in the model run:

  • 2D mesh – Any generic 2D mesh will work. Generally this mesh should be created from the Mesh Generation coverage.
  • Boundary Conditions coverage – Contains arcs defining the boundary condition attributes for the model run.
  • Materials coverage – Allows creating recording stations at specified nodal locations.
  • Sediment Material coverage –

Each component can be added to the simulation by selecting the component and dragging it under the simulation item Simulation Icon.svg in the Project Explorer. Linked 2D mesh Mesh Link.svg and coverages Coverage Link.svg will be displayed under the simulation.

Linking Components

After a simulation has been created, components may be added to the simulation. Components are usually added by clicking on the component item in the Project Explorer and dragging the item under the AdH simulation. A link Mesh Link.svg is then created between the component and the simulation.

Components can also be added to a simulation by right-clicking on the component in the project explorer and selecting the simulation name in the Apply To submenu. The Apply To submenu becomes available once a simulation has been created.

Components can be removed by right-clicking on the component link under the simulation and select Remove.

If a component is updated, it must be reapplied to the simulation.

Running the AdH Simulation

After all components have been added to the simulation and the model parameters have been established, the simulation can be run. This is done by right-clicking on the simulation and choosing the Run Simulation command or the Save and Run Simulation command.

The simulation run involves three steps.

  1. Exporting the AdH files – SMS writes out an AdH folder in the same directory where the SMS project is saved. The AdH folder has several files which have mesh geometry information, and boundary conditions as well as model control information defined in the model.
  2. Running AdH – After using a launch command, the Simulation Run Queue dialog will appear. If there are any errors in the model run, the model wrapper will exit early. The model run can also be exited early by clicking the Abort button. When the model run is completed, select Exit to close the model wrapper.

The Load solution button appears with the model run has finished. Clicking this button will load the solution into SMS.

AdH Model Control

The ADH Model Control dialog contains the graphical prompts for specifying model options. The dialog is accessed through the ADH | Model Control... menu item.

The dialog is divided into several tabs which each contain a number of parameter options. Before running ADH, set and review model control parameters. Entered data will be used to write the files employed in the ADH model run.

The available tabs are:

  • Time – Specifies the simulation duration. By default, ADH uses transient conditions, but steady state simulations can be specified.
  • Control Iteration –
  • Control Operation –
  • Model Control Output – Set parameters for how often solution data will be written.
  • Control Constants –
  • Hot Start –
  • Interface – Allows maintaining options which are not otherwise supported by the SMS interface.

See the individual articles for each of the ADH model control tabs.

Time

Time tab of the ADH Model Control dialog
  • Time option provides the following:
    • Start time field
    • Start time units numbered as seconds, minutes, hours, days, and weeks.
    • End time field (with the defined start) specifies the simulation run length on the TC TF card.
    • End time units numbered as seconds, minutes, hours, days, and weeks.
    • Time step option lists one of three options:
      • Steady state solution (TC STD)
        • Steady state min time step size
        • Steady state max time step size
      • Time step series (SERIES DT)
        • Max time step size time series opens an XY Series Editor
      • Auto Time Step Find (TC ATF)
        • Auto time step find min time step size
        • Auto time step find max time step size series

Iteration

Iteration tab of the ADH Model Control dialog

Operation

Operation tab of the ADH Model Control dialog

Output

Time tab of the ADH Model Control dialog

Constants

Hot Start

Advanced