FloodToxDownload coupler

HEC-RAS 2D and WASP External Coupler

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.

01 — OVERVIEW

What is the External Coupler?

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.

HEC-RAS 2D and WASP Coupler interface showing input files, model settings, and the Run Coupler button
The External Coupler interface
02 — HOW IT WORKS

How HEC-RAS 2D and WASP are coupled

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

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

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

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

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

Download Coupler v1.1 ↗

New to the coupler? Follow the step-by-step getting started guide or watch the training video.

05 — FAQ

Frequently asked questions

What is HEC-RAS 2D and WASP coupling?

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.