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

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

Arc Attributes

  • Off
  • Natural outflow (OB OF)
  • Discharge (NB DIS)
    • Edit
  • Flow (NB OVL)
    • Edit
  • Water surface elevation (NB OTW)
    • Edit
  • Spillway (NB SPL)
    • Edit
  • Tidal boundary (NB TID)
  • Stage discharge boundary (NB SDR)
    • Coefficient
  • Velocity and depth (DB OVH)
    • Snapping type
      • Point snap
      • Edgestring snap
      • Midstring snap
    • X velocity
    • Y velocity
    • Depth
  • Stationary lid elevation (DB LDE)
    • Snapping type
      • Point snap
      • Edgestring snap
      • Midstring snap
    • Elevation

Friction

  • Off
  • Manning's N (MNG)
    • Edge/mid string
      • Edgestring
      • Midstring
    • Manning's n
  • Manning's Equation (MNC)
    • Edge/mid string
      • Edgestring
      • Midstring
    • Manning's n
  • Equivalent roughness height (ERH)
    • Edge/mid string
      • Edgestring
      • Midstring
    • Roughness height
  • Submerged aquatic vegetation (SAV)
    • Edge/mid string
      • Edgestring
      • Midstring
    • Roughness height of canopy
    • Undeflected stem height
  • Un-submerged rigid vegetation (URV)
    • Edge/mid string
      • Edgestring
      • Midstring
    • Bed roughness height
    • Average stem diameter
    • Average stem density
  • Equivalent drag obstructions (EDO)
    • Edge/mid string
      • Edgestring
      • Midstring
    • Bed roughness height
    • Obstruction diameter
    • Obstruction height
  • Ice friction (ICE, IRH, BRH)
    • Edge/mid string
      • Edgestring
      • Midstring
    • Ice thickness
    • Ice density
    • Ice movement
    • Ice roughness height
    • Bed roughness height
  • Dune friction (DUN)
    • Edge/mid string
      • Edgestring
      • Midstring
    • Dune factor
    • Dune SEDLIB Inclusion
    • Dune D50
    • Dune D90
  • Submerged dike (SDK)
    • Dike height
  • Bridge deck (BRD)
    • Bridge deck elevation
    • Bridge deck thickness

Flux Output

  • Flux output
  • Edgestring
  • Midstring

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

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

  • Point type
    • Off
    • Velocity and depth (DB OVH)
      • X velocity
      • Y velocity
      • Depth
    • Stationary lid elevation (DB LDE)
      • Elevation
    • Depth of water under stationary lid (DB LDH)
      • Depth
    • Floating stationary object (DB LID)
      • Draft of lid
    • Wind Definition (OP WND)
      • Wind

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

Time

Iteration

Operation

Output

Constants

Hot Start

Advanced