You need a HEC-RAS 2D model (v6.5 or newer) and WASP (v8.4 or newer). The workflow below summarizes how the External Coupler connects them.
Prepare and run your HEC-RAS 2D model
Set up an unsteady flow analysis in HEC-RAS 2D (version 6.5 or newer). Under Unsteady Flow Analysis, activate the Post Processor and Floodplain Mapping options so the extra 2D variables are written to the results file, and enable Face Flow in the HDF5 Write Parameters output options. Then run the simulation.
Create a shapefile of the HEC-RAS 2D cells
In RAS Mapper, right-click the 2D Flow Areas layer and use Export Layer → Create Polygon Shapefile for 2D Cells to save the computational cells.
Create a shapefile of the WASP segments
Create a second geometry for WASP and save its 2D flow area as a shapefile. WASP segments are usually larger than HEC-RAS 2D cells; if both models use the same grid, the HEC-RAS 2D cells can be used directly as WASP segments.
Run the External Coupler
In the External Coupler interface, set the paths to the two shapefiles, the HEC-RAS 2D output, and the coupler output folder. Select the downstream boundaries, set the minimum depth for dry segments, choose the number of surface sediment layers, and run the program.
Create the binary hydrodynamic file for WASP
Copy the Hydrolink control file, the segment name file, and the hydrodynamic text file from the coupler output folder into the WASP bin folder, then run the WASP Hydrolink API (Hydrolink.exe) to generate the binary hydrodynamic (.hyd) input.
Import the hydrodynamics into WASP
Create a new WASP project, import the .hyd file in the Pre-processor under Hydrodynamics, set the model type to Advanced Toxicant, define the surface sediment layers, and add your water quality or contaminant parameters and boundary conditions.
02 — TIPS
Tips for reliable results
Flow quality
Check your HEC-RAS 2D face flow
Linking the models requires flow-volume continuity and mass balance for WASP segments. Noisy face flow hydrographs, caused by topography, cell size, or time step, can produce large negative volumes. Review the volume report from the coupler and refine the HEC-RAS 2D model if needed.
Boundary conditions
Generate WASP boundary conditions
The coupler saves WASP segment boundaries to a CSV file and a shapefile. Add time series for water quality constituents to the CSV, then convert them in the WASP Boundaries tab into the database WASP uses as input.
Ready to model flood contaminant transport?
Download the External Coupler or read about the research behind it.