Skip to content

Acknowledgments

CLB Engineering Corporation

CLB Engineering Corporation

RAS Commander is a free and open-source project of CLB Engineering Corporation. Within two years, CLB built the most robust and feature-complete HEC-RAS and HEC-HMS automation solution on the open internet using LLM Forward approaches -- proving that licensed professional engineers working alongside Large Language Models can create extraordinary value in compressed timeframes.

For agencies and organizations seeking to modernize H&H workflows, CLB Engineering brings unmatched expertise in HEC-RAS automation. Contact CLB to partner with the early LLM pioneers who are redefining what's possible in hydraulic engineering.

LLM Forward Development Framework

RAS Commander was developed using the LLM Forward approach, a framework for responsible adoption of large language models in professional engineering practice.

Framework Origin: CLB Engineering Corporation

Formalization: The LLM Forward philosophy was formalized by William Katzenmeyer, P.E., C.F.M., Owner & Vice President of CLB Engineering Corporation, as a response to the transformative potential of LLMs in engineering workflows while maintaining professional responsibility and public safety standards.

Core Tenets:

  • Focus specifically on Large Language Models (not general AI/ML)
  • Professional responsibility first - public safety, ethics, licensure remain paramount
  • LLMs positioned forward to accelerate insight without eroding accountability
  • Human-in-the-loop with licensed professionals reviewing and approving implementations
  • Verifiability and interpretability as centerpiece of adoption strategy
  • HEC-RAS projects with descriptive plan titles; models openable in GUI for traditional review
  • Visual outputs (plots/figures) at each calculation step for domain expert review
  • Code audit trails with @log_call decorators and comprehensive logging

Learn More: LLM Forward Engineering


Repository Author

William Katzenmeyer, P.E., C.F.M. Owner & Vice President CLB Engineering Corporation Email: [email protected] Website: clbengineering.com/llm-forward

RAS Commander represents a practical demonstration of LLM Forward principles applied to hydraulic & hydrologic modeling automation. The library was built through iterative prompt-code-test cycles with multiple LLMs (Claude, GPT-4, Gemini, Cursor IDE) over a 4-month development period.


Technical Contributors

Spatial Results Queries and Rivia

Gyan Basyal (gyanz) and Rivia provided the conceptual basis for HdfResultsQuery. Rivia's elegant spatial, profile, velocity, and flow query functions inspired this design. We gratefully acknowledge Gyan and WEST Consultants, Inc., credited by Rivia's license. Rivia also supplied the StoreAllMaps approach used by RasProcess. See Related libraries for a comparison and demonstrations of Rivia capabilities that remain useful alongside RAS Commander.

pyHMT2D HDF Extraction and Spatial Probing

Xiaofeng Liu and the pyHMT2D contributors, through pyHMT2D, influenced early HDF extraction and the spatial probing, transect, calibration, and uncertainty workflows explored during development. Its VTK-based analysis motivated useful direct HDF/scipy query workflows in RAS Commander. See Related libraries for release context and complementary ParaView/SRH-2D workflows.

Native HEC-DSS Access

Gyan Basyal (gyanz) maintains pydsstools, the MIT-licensed Python/Cython interface to HEC-DSS. RAS Commander's optional direct precipitation-array writer calls pydsstools' native grid API. We gratefully acknowledge this work; the upstream implementation is used as a dependency and is not copied into RAS Commander. See the upstream project for its documentation, contribution, and sponsorship options.

HDF Readers and the Java DSS Bridge

FEMA-FFRD's rashdf provided HDF readers that were incorporated, revised, adapted, and extended where noted in RAS Commander's HDF modules. We acknowledge the upstream authors and contributors.

Michael Koohafkan's dssrip2 is an R HEC-DSS library. Its HEC Monolith JAR download, platform-native library, and cache-management approach was replicated in RAS Commander's _hec_monolith.py Java bridge. We gratefully acknowledge that foundation.

HDF Data Access & Structure Analysis

Sean Micek, P.E. Hydraulic Engineer HEC-RAS Reservoir Engineering

Sean's blog posts documenting HEC-RAS HDF file structure were instrumental in understanding the organization of HDF datasets for 2D mesh results, boundary conditions, and structure data. His detailed breakdowns of HDF paths and dataset hierarchies enabled rapid development of the HdfResults* classes.

Key Contributions: - HDF structure documentation for 2D unsteady results - Boundary condition dataset mappings - Structure data organization (bridges, culverts, lateral structures)


Terrain Modification and Cell Size Optimization

Xiaofeng (Frank) Liu, Ph.D. Associate Professor, University of Texas at Arlington DualSPHysics: Learn by Example Hydraulic Modeling Studio YouTube Channel

Dr. Liu's YouTube tutorials on HEC-RAS terrain modifications and pilot channel creation inspired the terrain optimization workflows and cell size analysis features. His practical demonstrations of fixing LIDAR-defined flat-bottom channels informed the geometric analysis capabilities.

Key Contributions: - Terrain modification profile generation concepts - Pilot channel design principles for LIDAR channels - Cell size and Courant number relationships


HEC-RAS Example Projects

U.S. Army Corps of Engineers Hydrologic Engineering Center (HEC)

The publicly available HEC-RAS example projects provided the foundation for Test Driven Development and reproducible demonstrations. Projects like "Muncie," "Bald Eagle Creek," "Dam Breaching," and others enabled validation testing with real hydraulic & hydrologic scenarios.

Purpose: Example projects allow: - Functional testing without synthetic data - Reproducible demonstrations for all users - Version compatibility validation across HEC-RAS releases


Fluvial-Pluvial Modeling Approaches

FEMA Flood Forecasting & Risk Dynamics (FFRD) Team

Conversations with FEMA FFRD researchers informed the fluvial-pluvial boundary condition calculation methods, particularly the approaches for combining river boundary flows with local precipitation to avoid double-counting in hydrodynamic models.

Concepts Implemented: - Fluvial-pluvial boundary adjustments - Precipitation-flow integration strategies - HUC-based hydrologic regionalization


HECRASController Documentation

Chris Goodell, P.E., D.WRE Author: "Breaking the HEC-RAS Code" (2014) The RAS Solution YouTube Channel

Chris's book remains the definitive reference for COM-based automation of HEC-RAS 3.x-5.x versions. The RasControl class implementation follows patterns documented in his work, adapted to modern Python with type hints and pandas DataFrames.

Legacy Integration: - COM interface patterns (HECRASController API) - Steady state profile extraction methods - Version compatibility guidance across HEC-RAS 3.x-6.x


Community Testing & Feedback

Community Contributors

  • Harris Bienn (@harrisbienn) identified the retained-request identity mismatch in the governed scenario-worker retry workflow and authored the original correction and regression coverage in #310 and #311. That finding was generalized in the portable execution contract as separate retained-payload and normalized-specification identities, without coupling the public API to any application-specific orchestration workflow.
  • @PMacAddress supplied detailed, reproducible Windows/Wine reports and follow-up testing for headless mesh generation, refinement-region activation, Manning's n geometry associations, and solver-readable gridded precipitation in #361, #369, #370, and #371.
  • @jacobrbeatty reported that RasControl.run_plan() could accept a current-plan signal without a result HDF, motivating stronger result-artifact and completion-evidence checks in #323.

Early Adopters & Testers

The following individuals and organizations provided valuable testing feedback during beta releases:

  • Practitioners testing parallel execution workflows on HUC-8 scale models
  • Engineers validating HDF extraction against RAS Mapper and HEC-DSSVue
  • Developers integrating ras-commander into Arc Hydro Tools workflows

If you contributed feedback during development, please submit a pull request to add your name.


Open Source Contributions

Third-Party Libraries

RAS Commander builds on exceptional open-source Python libraries:

Library Purpose Maintainers
h5py HDF5 file access HDF Group / Andrew Collette
pandas Structured data analysis NumFOCUS
geopandas Geospatial data operations GeoPandas Developers
matplotlib Visualization Matplotlib Development Team
pathlib Cross-platform path handling Python Software Foundation
dataretrieval USGS NWIS data access USGS

Inspiration & Context

AI-Driven Engineering Transformation

The rapid development of RAS Commander (4 months from concept to v0.80.0) was enabled by:

  • Claude Sonnet 3.5 - Iterative code generation and debugging
  • GPT-4o - API design exploration and docstring generation
  • Gemini Pro - Alternative implementation approaches and validation
  • Cursor IDE - Real-time code completion with codebase context

This demonstrates the LLM Forward approach in practice: engineers bring domain expertise (hydraulics, HEC-RAS file formats, workflow requirements), while LLMs translate that knowledge into working Python implementations.


Contributing Acknowledgments

If you contributed code, documentation, bug reports, or testing feedback, thank you! To add your name to this list, please submit a pull request with:

  1. Your name and affiliation
  2. Brief description of your contribution
  3. Optional: Links to your GitHub profile, website, or blog

License

RAS Commander is released under the MIT License. See LICENSE for details.

The MIT License permits commercial and non-commercial use, modification, and distribution subject to the terms in the repository's LICENSE file, including retaining its copyright and permission notice in copies or substantial portions of the software. Publication citation, product acknowledgment, and social sharing are separate, voluntary ways to recognize RAS Commander and its contributors. See Cite and Support RAS Commander.


Last Updated: 2026-10-13