SMS:ADH 2D Shallow Water Flow
 |
This article is for a model that is under development by Aquaveo and its partners. The model is not available to the public at this time. It is not known when or if the model will be released. The content may not apply to current or older versions. |
 |
(Note: ADH is currently available only for government agencies)
"ADH is a state-of-the-art ADaptive Hydraulics Modeling system developed by the Coastal and Hydraulics Laboratory (CHL), ERDC, USACE, and is capable of handling both saturated and unsaturated groundwater, overland flow, three-dimensional Navier-Stokes flow, and two- or three-dimensional shallow water problems." [1]
Information about the ADH model can be found at the ADaptive Hydraulics Modeling HomePage.
Functionality
Graphical Interface
The model was initially included in the 9.2 version release and was overhauled for the 10.0 version release, however it is available only to the model developers. We are continuing to develop an interface to allow SMS users to utilize ADH for 2D shallow water flow and sediment transport analysis.
Files
An ADH simulation is defined using three main files: mesh geometry (*.3dm), boundary conditions (*.bc), and hot start conditions (*.hot). ADH expects a 3-dimensional mesh geometry since it can solve 3D models, but SMS will only interface the 2D capabilities and will therefore only read and write 2D entities in the *.3dm file. A generic SMS mesh geometry file (*.2dm) can be used by ADH if the extension is changed to *.3dm. To facilitate handling the ADH files, SMS creates a simulation file (*.sim) which lists the individual files. Opening the *.sim will load the ADH files in SMS.
Each file is a card based text file that can be viewed and edited by a text editor (i.e. Notepad).
- Mesh geometry file (*.2dm/*.3dm)
- Boundary condition file (*.bc)
- Hot start file (*.hot)
- Boat definition file (*.bt)
Dialogs
SMS provides the capability to view and edit model parameters via dialog boxes specific to the ADH interface. The following are descriptions of important windows accessible from the ADH menu and right-click menus.
- Model Control
- Boundary Condition Assignment
- Material Properties
- Hot Start Initial Conditions
- Model Check (currently unavailable - under development)
- Boundary Layers (currently unavailable - under development)
- Run Model
Using the Model / Practical Notes
ADH uses string structures to assign properties to entities. The following table describes the relation between the string structures and SMS structures.
| ADH String Structure | SMS Structure | |
|---|---|---|
| NDS with DB card | and only 1 node ID | Node with boundary condition (BC) |
| and 2 or more node IDs | Nodestring with BC | |
| EGS with NB card (and possibly FLX card) | Nodestring with BC (and flux output) | |
| MDS with FLX card | Nodestring with flux output | |
| MTS with MP cards | Material with properties | |
| SMS Structure | ADH String Structure | ||
|---|---|---|---|
| Node with BC (Dirichlet) | NDS (only 1 node ID) with DB card | ||
| Nodestring | with Natural BC | with flux output | EGS with NB and FLX cards |
| EGS with NB card | |||
| with Dirichlet BC | with flux output | NDS (2 or more node IDs) with DB card, and MDS with FLX card | |
| NDS (2 or more node IDs) with DB card | |||
| with flux output | MDS with FLX card | ||
| Material with properties | MTS with MP cards | ||
Case Studies / Sample Problems
The following ADH simulation files have been provided by CHL to test ADH and the SMS interface capabilities. Additional test cases will be posted here as the interface can successfully read, write, and run the ADH model from within SMS.
SMS 10.1 Development version using ADH rev #3669 dated August 2007:
- Bayou_Sorrel - Uses the NB OVL and NB OTW boundary condition cards. Includes two materials on a complex mesh.
- Pool5 - Uses the NB OVL and NB OTW boundary condition cards. Includes two inflows with one outflow and four materials on a complex mesh.
- nb dis - Tests the NB DIS boundary card on a straight flume.
- op bt - Tests the OP BT card which includes the vessel movement library. This test case contains a boat definition file (*.bt).
- db lde - Tests the DB LDE pressure lid card on a straight flume.
- db ldh - Tests the DB LDH pressure lid card on a straight flume.
- db lid - Tests the DB LID pressure lid card on a straight flume.
