RAS Commander GUI

✓ Installation Status: RAS Commander is installed and ready to use!

System Information

Python Version: Loading...

RAS Commander Version: 0.87.6

Example Projects Available: Loading...

Platform: macOS

Quick Start Guide

Configure HEC-RAS Path - Set the path to your HEC-RAS installation below
Load a Project - Go to the Projects tab to open an existing HEC-RAS project or extract example projects
Execute Plans - Run simulations from the Execute Plans tab
Extract Results - Analyze results in the Extract Results tab

HEC-RAS Configuration

⚠️ Note: You're on macOS. HEC-RAS is a Windows-only application. To use this GUI fully, you'll need to:

Run this on a Windows machine with HEC-RAS installed, OR
Use remote execution to connect to a Windows machine with HEC-RAS

HEC-RAS Installation Path (for Windows):

HEC-RAS Version:

Open Existing Project

Project Folder Path:

Extract Example Project

RAS Commander includes example projects for testing and learning.

Select Example Project:

Output Location:

Current Project

No project loaded

Ready to load projects...

Single Plan Execution

Plan Number:

Number of CPU Cores (optional):

Clear geometry preprocessor files (slower but ensures fresh processing)

Parallel Plan Execution

Plan Numbers (comma-separated):

Maximum Workers:

Ready to execute HEC-RAS plans...

Extract Water Surface Elevation (WSE)

HDF File Path:

Time Index (-1 for last timestep):

Extract Cross Section Data

Geometry File Path:

Export Results

Export Format:

Output File Path:

Ready to extract results...

🔍 Project Inspector

View detailed information about your HEC-RAS project structure.

🗺️ RASMapper Tools

Work with RASMapper layers and terrain data.

📐 Geometry Tools

Parse and modify HEC-RAS geometry files.

🌊 USGS Gauge Integration

Integrate USGS gauge data for boundary conditions.

☁️ Precipitation Data

Work with AORC and Atlas 14 precipitation data.

🔧 Validation Tools

Validate DSS files, pathnames, and model data quality.

Select a tool above to get started...

About RAS Commander

RAS Commander is a Python library for automating HEC-RAS operations. It provides comprehensive API for project interaction, simulation execution, and HDF results processing.

Key Features

Execute HEC-RAS plans (single, parallel, distributed remote)
Parse and modify project files (geometry, plans, unsteady flow)
Extract results from HDF files (steady and unsteady)
Integrate USGS gauge data for validation and boundary conditions
Automate geometry repair (RasFixit module)
Real-time execution monitoring with callbacks

Python Example

If you want to use RAS Commander in Python code:

from ras_commander import init_ras_project, RasCmdr
from ras_commander.hdf import HdfResultsPlan

# Initialize project
init_ras_project("/path/to/project", "6.5")

# Execute plan
RasCmdr.compute_plan("01")

# Extract results
hdf = HdfResultsPlan("/path/to/project/plan.p01.hdf")
wse = hdf.get_wse(time_index=-1)

Documentation & Resources

About This GUI

This HTML interface is a standalone tool designed for non-coders to use RAS Commander features through a graphical interface. It communicates with RAS Commander via a Python backend server.

⚠️ Important: This GUI requires a Python backend server to be running. See the setup instructions for launching the server.

🌊 RAS Commander GUI