SMS:ADH SMS 13.2 and Earlier

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

The ADH model can be added to a paid edition of SMS.

Graphical Interface

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.

ADH Menu

• Assign BC – When a node or arc is selected, brings up a dialog where boundary condition parameters can be assigned.
• Assign Bed Layers – Brings up a dialog to assign bed layer specifications.
• Assign Consolidations
• Material Properties – Brings up a dialog where material properties are defined.
• Hot Start Initial Conditions – Brings up a dialog to define the initial condition dataset to start a simulation.
• Time Series Data – Brings up a Time Series dialog.
• Model Check
• Model Control – Brings up the Model Control dialog where model run parameters are set.
• Sediment Library Control
• Run Model – Launches the model check, pre-ADH model wrapper, and ADH model wrapper.
• Read ADH Solution

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)

Functionality

ADH can address a range of modeling application, including:[2]

• Design of approach channel improvements
• Guardwall porting design
• Design of a fish passage structure through an existing spillway
• Velocity field calculations during different stages of construction
• Overall effects of sedimentation due to the proposed work.
• Evaluating the effects of multiple projects constructed within a river reach to support objectives for both navigation and ecosystem restoration.
• Salinity intrusion analysis in conjunction with system changes.
• Impacts of navigation channel design changes on ship passage by supplying hydrodynamic results.
• Effects of vessel traffic on hydrodynamics, salinity, and sedimentation with the use of simulating vessel movement in the model.
• Flood inundation by use of dynamic and continuous wetting/drying fronts.

Using the Model / Practical Notes

• Sediment Transport and Bed Layers
• Time Series
• Wind Stations

ADH String Structures

ADH uses string structures to assign properties to entities. The following table describes the relation between the string structures and SMS structures.

ADH to SMS (Reading)

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 to ADH (Writing)

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.

Related Topics

• SMS Models