Link 2D hydrodynamic flood simulations in HEC-RAS with the WASP water quality model to simulate sediment, contaminant transport, and water quality during flood conditions.
The External Coupler is a Python-based program that links HEC-RAS 2D (version 6.5 and newer) and the Water Quality Analysis Simulation Program (WASP) (version 8.4 and newer). It creates a hydrodynamic input for WASP from HEC-RAS 2D output, so flood hydraulics and flood contaminant transport can be modeled together.
WASP uses water volume, depth, velocity, and flow from HEC-RAS 2D to simulate sediment, water quality constituents, and contaminants in two dimensions with its Eutrophication and TOXI modules. The coupler supplies these data to the WASP Hydrolink Application Program Interface (API), which converts hydrodynamic data into a binary input file for WASP.
The External Coupler interface
02 — HOW IT WORKS
How HEC-RAS 2D and WASP are coupled
Read HEC-RAS 2D hydrodynamic output
Depth, water surface elevation, face velocity, cell volume, and face flow are read from the HEC-RAS 2D HDF5 results file.
Generate WASP segments and a catalog table
WASP segments are generated and a catalog table connects the HEC-RAS 2D computational grid to the WASP segments.
Aggregate the hydrodynamic data
Flow, volume, depth, and velocity are aggregated from HEC-RAS 2D cells to WASP segments, with an optional surface sediment layer.
Write the input for the WASP Hydrolink API
The coupler writes the hydrodynamic data and segment files that Hydrolink converts into a binary hydrodynamic file for WASP.
03 — SPECIFICATIONS
Compatibility and requirements
HEC-RAS 2DVersion 6.5 and newer
WASPVersion 8.4 and newer (Eutrophication and TOXI modules)
LanguagePython, with a graphical interface
Hydrodynamic inputsFlow, volume, depth, and velocity from HEC-RAS 2D
OutputsHydrolink API inputs for a binary WASP hydrodynamic file, and WASP boundary condition templates
Current version1.1
04 — DOWNLOAD
Download the External Coupler
Version 1.1 of the HEC-RAS 2D and WASP External Coupler is available as a ZIP file (approximately 844 MB).
HEC-RAS 2D and WASP coupling means using the hydrodynamic results of a 2D HEC-RAS flood simulation (water volume, depth, velocity, and flow) as the transport input for the WASP water quality model, so that sediment, water quality constituents, and contaminants can be simulated during flood conditions.
Which software versions does the External Coupler support?
The External Coupler works with HEC-RAS 2D version 6.5 and newer and WASP version 8.4 and newer.
What does the External Coupler produce?
It reads HEC-RAS 2D output, builds WASP segments and a catalog that connects HEC-RAS 2D cells to those segments, aggregates the hydrodynamic data, and writes the input files used by the WASP Hydrolink API to create a binary hydrodynamic file for WASP.
Can WASP simulate contaminants and sediment with the coupler?
Yes. WASP uses the coupled hydrodynamics to simulate sediment, water quality constituents, and contaminant transport in 2D with its Eutrophication and TOXI modules.
Learn the science behind the tool
Read the publications that describe the coupler and its application to flood contaminant transport.