SMS:AdH: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
(moved SMS:AdH to SMS:ADH)
 
(Removed redirect to SMS:ADH)
Tag: Removed redirect
 
Line 1: Line 1:
#REDIRECT [[SMS:ADH]]
"ADH is a state-of-the-art ADaptive Hydraulics Modeling system developed by the [https://chl.erdc.dren.mil/adh/main/index.html 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."
Information about the ADH model can be found at the [http://www.erdc.usace.army.mil/Media/Fact-Sheets/Fact-Sheet-Article-View/Article/476708/adaptive-hydraulics-model-system/ ADaptive Hydraulics Modeling home page].
 
The ADH model can be added to a [http://www.aquaveo.com/software/sms-pricing paid edition] of SMS.
[[Category:Link to Store]]
 
==Graphical Interface==
ADH  makes use of a simulation process that includes using coverages, meshes, and a model control.
*[[SMS:AdH Simulations|AdH Simulations]]
*[[SMS:AdH Model Control|Model Control]]
 
===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:
*[[SMS:AdH Boundary Conditions|Boundary Conditions]]
*[[SMS:AdH Materials|Materials]]
*Sediment Materials
 
===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).
* [[SMS:2D Mesh Files *.2dm | Mesh geometry file (*.2dm/*.3dm)]]
* [[SMS:ADH Boundary Condition File Cards | Boundary condition file (*.bc)]]
* [[SMS:ADH Hot Start File| Hot start file (*.hot)]]
* [[SMS:ADH Boat Definition File Cards | Boat definition file (*.bt)]]
 
==Functionality==
ADH can address a range of modeling application, including:[http://adh.usace.army.mil/new_webpage/main/adh_overview.htm]
*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.
 
==AdH Parallel==
In SMS 13.3 or higher, run AdH in parallel by doing the following:
# Download the [http://sms.aquaveo.com.s3.amazonaws.com/ADH-4.6.0.exe ADH installer].
# Run the installer and follow the on-screen instructions. Note the path that is used for the install.
# Set the Microsoft MPIEXEC path:
## Right-click on the Project Explorer and select '''Preferences''' to open the ''Preferences'' dialog.
## Select the ''File Locations'' tab.
## In the ''Other Files'' spreadsheet scroll down to ''Microsoft MPIEXEC''.
## Click the '''Browse''' button to open a file browser.
## Select the location of the ‘mpiexec.exe’ from step 2 for the install. It is probably C:\Program Files\Microsoft MPI\Bin\.
## Click '''Open''' to close the browser.
## Click '''Close''' to exit the ''Preferences'' dialog.
# Set the number of processors to use:
## Right-click the desired AdH simulation and select '''Model Control...''' to open the AdH ''Model Control'' dialog.
##Select the ''Operation'' tab.
##Set the ''Number of processors'' to the desired amount.
##Press '''OK''' to close the ''Model Control'' dialog.
 
===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.
{|class="wikitable"
|+'''ADH to SMS (Reading)'''
!colspan="2"|ADH String Structure
!width="300"|SMS Structure
|-
|rowspan="2" width="150"|NDS with DB card
|width="150"|and only 1 node ID
|Node with boundary condition (BC)
|-
|and 2 or more node IDs
|Nodestring with BC
|-
|colspan="2"|EGS with NB card (and possibly FLX card)
 
|Nodestring with BC (and flux output)
|-
|colspan="2"|MDS with FLX card
 
|Nodestring with flux output
|-
|colspan="2"|MTS with MP cards
 
|Material with properties
|}
 
{|class="wikitable"
|+'''SMS to ADH (Writing)'''
!colspan="3"|SMS Structure
 
!width="400"|ADH String Structure
|-
|colspan="3"|Node with BC (Dirichlet)
 
|NDS (only 1 node ID) with DB card
|-
|rowspan="5" width="100"|Nodestring
|rowspan="2" width="100"|with Natural BC
|rowspan="2" width="100"|with flux output
|EGS with NB and FLX cards
|-
|EGS with NB card
|-
|rowspan="2"|with Dirichlet BC
|rowspan="2"|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
|-
|colspan="2"|with flux output
 
|MDS with FLX card
|-
|colspan="3"|Material with properties
|MTS with MP cards
|}
 
==Case Studies / Sample Problems==
The following ADH simulation files have been provided by [http://chl.erdc.usace.army.mil/ 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:
* '''[http://sms.aquaveo.com/ADH-bayousorrel.zip Bayou_Sorrel]''' &ndash; Uses the <font color="green">NB OVL</font> and <font color="green">NB OTW</font> boundary condition cards. Includes two materials on a complex mesh.
* '''[http://sms.aquaveo.com/ADH-pool5.zip Pool5]''' &ndash; Uses the <font color="green">NB OVL</font> and <font color="green">NB OTW</font> boundary condition cards. Includes two inflows with one outflow and four materials on a complex mesh.
* '''[http://sms.aquaveo.com/ADH-nb_dis.zip nb dis]''' &ndash; Tests the <font color="green">NB DIS</font> boundary card on a straight flume.
* '''[http://sms.aquaveo.com/ADH-op_bt.zip op bt]''' &ndash; Tests the <font color="green">OP BT</font> card which includes the vessel movement library. This test case contains a boat definition file (*.bt).
* '''[http://sms.aquaveo.com/ADH-db_lde.zip db lde]''' &ndash; Tests the <font color="green">DB LDE</font> pressure lid card on a straight flume.
* '''[http://sms.aquaveo.com/ADH-db_ldh.zip db ldh]''' &ndash; Tests the <font color="green">DB LDH</font> pressure lid card on a straight flume.
* '''[http://sms.aquaveo.com/ADH-db_lid.zip db lid]''' &ndash; Tests the <font color="green">DB LID</font> pressure lid card on a straight flume.
 
==External Links==
*[https://www.erdc.usace.army.mil/Media/Fact-Sheets/Fact-Sheet-Article-View/Article/476708/adaptive-hydraulics-model-system/ Information page on the Adaptive Hydraulics Model System.]
*[https://www.erdc.usace.army.mil/Locations/CHL/AdH/Documentation/ ADH Manual]
 
==Related Topics==
*[[SMS:SMS Models|SMS Models]]
 
 
{{Template:Navbox SMS}}
 
[[Category:ADH|A]]
[[Category:External Links]]

Latest revision as of 19:06, 11 September 2023

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

Information about the ADH model can be found at the ADaptive Hydraulics Modeling home page.

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

Graphical Interface

ADH makes use of a simulation process that includes using coverages, meshes, and a model control.

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:

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

Functionality

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

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

AdH Parallel

In SMS 13.3 or higher, run AdH in parallel by doing the following:

  1. Download the ADH installer.
  2. Run the installer and follow the on-screen instructions. Note the path that is used for the install.
  3. Set the Microsoft MPIEXEC path:
    1. Right-click on the Project Explorer and select Preferences to open the Preferences dialog.
    2. Select the File Locations tab.
    3. In the Other Files spreadsheet scroll down to Microsoft MPIEXEC.
    4. Click the Browse button to open a file browser.
    5. Select the location of the ‘mpiexec.exe’ from step 2 for the install. It is probably C:\Program Files\Microsoft MPI\Bin\.
    6. Click Open to close the browser.
    7. Click Close to exit the Preferences dialog.
  4. Set the number of processors to use:
    1. Right-click the desired AdH simulation and select Model Control... to open the AdH Model Control dialog.
    2. Select the Operation tab.
    3. Set the Number of processors to the desired amount.
    4. Press OK to close the Model Control dialog.

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.

External Links

Related Topics