HEC-Commander

HEC-Commander Tools

HEC-Commander Tools is a suite of python notebooks developed with AI assistance for water resource engineering workflows, primarily focused on providing automation for HEC-RAS and HEC-HMS through Jupyter Notebooks. Additionally, this repository contains blog posts and ChatGPT assistants relevant to H&H modeling, automation and the use of LLM’s for water resources workflows.

Primary Author

William Mark Katzenmeyer, P.E., C.F.M.

Notable Contributors

Sean Micek, P.E. - HMS-Commander Jython core logic, implementation of calibration regions. RAS-Commander infiltration HDF revision prototyping
Tyler Young, E.I. - DSS-Commander calibration metrics, debugging, and testing of all tools.

HMS-Commander

Contains automation scripts for HEC-HMS that allow the generation of multiple DSS output files with user-defined calibration parameters. This tool was developed to support 1D HEC-RAS calibration and validation workflows using deficit and constant loss methods with optional recession baseflow, and employs a user-generated CSV file to input scale factors for each individual parameter. A second version of the script allows definition of multiple calibration regions, enabling spatial variability of scale factors.

RAS-Commander

Includes a suite of HEC-RAS automation scripts that support the parallel execution of HEC-RAS unsteady plans, as well as construction of plan files utilizing multiple HEC-HMS inputs. Defines DSS output file names, generates batch scripts for headless execution, and manages the deployment and parallel execution of HEC-RAS runs on local and remote machines using peer-to-peer Windows network shares. These scripts are applicable for both 1D and 2D model formats, and now support overriding RASMapper infiltration override layers.

DSS-Commander

Provides a script for plotting 1D HEC-RAS results from DSS against gauge results, creating zoomable HTML plots with Bokeh. It calculates calibration statistics (RMSE, r, PBIAS, NSE) for each plotted location and supports multiple gauges, as well as the plotting of multiple DSS results files for both Stage and Flow.

New GHNCD to DSS Precipitation Grid Comparison Tool

Miscellaneous Scripts and Tools

Under each HMS, RAS, and DSS Commander folders are miscellaneous scripts and tools to assist with workflows related to those programs. These include soil statistics tools, tools for setting ineffective flow area permanency + more.

Extras

HEC-Commander Blog

A collection of blogs and missives about AI, HEC-RAS and HMS scripting, and topics related to the tools in this repo HEC-Commander Blog

ChatGPT Examples and GPT’s

A collection of other useful GPT’s and ChatGPT conversation examples to complement this repository can be found in the ChatGPT Examples Folder

ChatGPT Assistant for HEC-Commander Repository

HEC-Commander Repository Assistant | GPT Link has access to a compiled version of the documentation in its Knowledge Base, as well as a zip file containing all of the content in the repo for retrieval This GPT can be used to learn about the scripts, ask for instructions to help you debug any errors, as well as provide coding assistance for revising scripts for your use:

HEC-Commander Tools and AI-Assisted Scripting Presentations

The HEC-Commander tools and AI-assisted scripting were presented at Association of State Flooplain Managers (ASFPM) Annual Conference in Salt Lake City on June 27, 2024.* Check out a PDF of the presentation!

Quick Start Guide

Quick Start Guide for HEC-Commander Tools (Click to Expand)

[PDF Version of Quick Start Guide](https://github.com/billk-FM/HEC-Commander/blob/main/Quick%20Start%20Guide%20for%20HEC-Commander.pdf) **Install Python using Anaconda Navigator** Download via [Anaconda.com](https://www.anaconda.com/) Then, create a Python 3.11 Environment: 1. Open Anaconda Navigator 2. Environments > Create 3. Name: `HEC-Env`, Packages: Search and select Python, Version: `3.11` 4. Launch a Terminal in the new environment 5. Install required dependencies with the command: `pip install -r requirements.txt` **Install Visual Studio Code (VSCode) + Jupyter and Python Extensions** Download via [Visual Studio Code](https://code.visualstudio.com/Download) After installing VSCode: - Open Extension View (`Ctrl+Shift+X`) - Search and install: `Jupyter`, `Python`, `Python Environment Manager` **Install Java Software Development Kit** Download the JDK version 20.0.1 required for HEC-HMS 4.9 from [Oracle](https://download.oracle.com/java/20/archive/jdk-20.0.1_windows-x64_bin.msi). **Install Jython** Download the Jython Installer from [Jython.org](https://www.jython.org/download.html) and install to the default location (C:\jython2.7.3). **Create Local Windows File Share for Remote Execution** 1. Log into the remote machine 2. Create a directory (e.g., `C:\RASCommander_Run`) 3. Right-click on the folder, select "Properties" 4. Go to "Sharing" tab, click "Share..." 5. Add 'Everyone' and set permissions to 'Read/Write', click "Share" **Install C++ Build Tools for Visual Studio 2019 (for DSS-Commander)** [https://aka.ms/vs/17/release/vs_BuildTools.exe](https://aka.ms/vs/17/release/vs_BuildTools.exe) When installing, select the "C++ Build Tools for Visual Studio 2019" option

Youtube Channel

A Youtube Channel with instructional videos to accompany this repository can be found here: GPT-Commander Youtube Channel