HEC-RAS

HEC-RAS or Hydrologic Engineering Center's River Analysis System is a software that allows the user to perform one-deminosonal steady flow, 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 Xforwarding

HEC-RAS produces results that might need software to view them in graphical user interface software. To be able to view the data you'll need to connect to Elja with xforwarding. 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 gather three load in three executables to the user's path. These executables are RasGeomPreprocess, RasSteady and RasUnsteady

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

Note! On 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

Like previously mentioned when loading HEC-RAS it will load in the binaries RasGeomPreprocess, RasSteady and RasUnsteady. This linux version does not have for example GUI like the Windows version does but it produces outcome from these three binary files.

However we have two softwares 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 HEC-RAS installation folder can be gotten here

This example should show how the binaries are used based on the instructions set that where given with the HEC-RAS installation file.

First let's look at the directroy that the test file is located in:

|-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 prdouce and 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 Munchie.r04 # Produces Muncie.O04 file