HEC-RAS

HEC-RAS or Hydrologic Engineering Center's River Analysis System is a software that allows users to perform one-dimensional steady flow and one and two-dimensional unsteady flow calculations.

Websites

• HEC

Usage on Elja

To use HEC-RAS on Elja, you'll need to follow these instructions:

Step 1 | Connect to Elja with X-forwarding

HEC-RAS produces results that require graphical user interface software to view. To be able to view the data, you'll need to connect to Elja with X-forwarding. Instructions on how to do that can be found here.

Step 2 | Setting up environment

module use /hpcapps/lib-edda/modules/all/Core   # Use module lib-edda/Core 
module use /hpcapps/lib-geo/modules/all         # Use module lib-geo
module load HEC-RAS                             # Loading HEC-RAS

Step 3 | Connect to a compute node and run software

Once the HEC-RAS module is loaded, it will add three executables to the user's path. These executables are RasGeomPreprocess, RasSteady and RasUnsteady.

srun --partition gpu-2xA100 -n 1 --pty --x11 bash

Athugið

For more information about srun and sbatch, please have a look at Submitting Slurm Jobs General usage on submitting a job

Step 4 | Run HEC-RAS software

As previously mentioned, when loading HEC-RAS, it will make the binaries RasGeomPreprocess, RasSteady and RasUnsteady available. This Linux version does not have a GUI like the Windows version, but it produces output from these three binary files.

However, we have two software tools that can help view these outputs in a graph format via a GUI: HEC-DSSVue and HDFView, which are loaded with HEC-RAS.

Examples | Taken from the test instructions

Instructions and the HEC-RAS installation folder can be downloaded here.

This example shows how the binaries are used based on the instructions provided with the HEC-RAS installation file.

First, let's look at the directory structure for the test files:

|-Muncie/
|--|-Muncie.b04     # Unsteady input text file
|--|-Muncie.c04     # Binary geom file for Unsteady
|--|-Muncie.g04.hdf # Binary geom file for Unsteady
|--|-Muncie.p04     # Unsteady Compute
|--|-Muncie.p04.hdf # HDF Result file from Unsteady compute
|--|-Muncie.pej
|--|-Muncie.r04     # Text input file Steady Compute
|--|-Muncie.u01
|--|-Muncie.x04     # Text input file for Geometry Preprocessor

Run the GeomPreprocessor

[user@elja-irhpc ~]$ RasGeomPreprocess Muncie.x04 # Should produce Muncie.c04

Run RasUnsteady

[user@elja-irhpc ~]$ RasUnsteady Muncie.c04 b04 # Produces Muncie.p04.hdf and Muncie.dss

The RasUnsteady should produce an hdf and a DSS file. HEC-DSSVue can view the .dss file and HDFView can view the hdf file.

# View the DSS file
[user@elja-irhpc ~]$ hec-dssvue

# View the hdf file
[user@elja-irhpc ~]$ hdfview hdf_file.hdf

Run RasSteady

[user@elja-irhpc ~]$ RasSteady Muncie.r04 # Produces Muncie.O04 file