Checking for missing content type metadata ...

Checking for non-preferred file/folder path names (may take a long time depending on the number of files/folders) ...

HECinBOX: an Automated Agent-Based Flood Warning Framework using 2D Unsteady HEC-RAS Simulation


Authors:
Owners: This resource does not have an owner who is an active HydroShare user. Contact CUAHSI (help@cuahsi.org) for information on this resource.
Type: Resource
Storage: The size of this resource is 498 bytes
Created: Sep 20, 2026 at 10:28 p.m. (UTC)
Last updated: Oct 01, 2026 at 8:41 p.m. (UTC)
Citation: See how to cite this resource
Content types: Single File Content 
Sharing Status: Public
Views: 300
Downloads: 29
+1 Votes: Be the first one to 
 this.
Comments: No comments (yet)

Abstract

Operational flood early warning requires continuous ingestion of forcing data, execution of hydrodynamic models, and translation of outputs into actionable alerts. These steps are often manual or semi-automated, limiting operational use of high-resolution two-dimensional flood models. This paper presents HECinBOX, an open-source, containerized framework that transforms existing HEC-RAS models into continuously operating flood early-warning systems. HECinBOX integrates HEC-RAS simulations with a configurable warning agent, automates retrieval and injection of gauge/forecast data into model boundary conditions, and enables scheduled flood forecasting, mapping, and alert generation. Deterministic modules handle model scanning, data ingestion, boundary condition orchestration, headless HEC-RAS execution, and result extraction, while a stateful agent evaluates user-defined thresholds, tracks prior alerts, and issues alerts. Tested on several ready-to-run HEC-RAS models, including Brays Bayou in Houston, Texas, HECinBOX demonstrates applicability across model configurations and provides a generalizable path from static flood studies to operational, self-updating early-warning systems.

Subject Keywords

Coverage

Spatial

Coordinate System/Geographic Projection:
WGS 84 EPSG:4326
Coordinate Units:
Decimal degrees
North Latitude
49.3800°
East Longitude
-66.9500°
South Latitude
24.5200°
West Longitude
-124.7700°

Content

README.md

Access the Software

Please use the following GitHub repository to access the latest version of HECinBOX:

GitHub repository: https://github.com/Ehsankahrizi/HECinBOX/

Website: https://hecinbox.com/

Demo: https://demo.hecinbox.com/

Contact

Ehsan Kahrizi
University of Alabama
Civil, Construction and Environmental Engineering

Credits

Funding Agencies

This resource was created using funding from the following sources:
Agency Name Award Title Award Number
Cooperative Institute for Research to Operations in Hydrology (CIROH) None NA22NWS4320003

How to Cite

Kahrizi, E., Moftakhari, H. (2026). HECinBOX: an Automated Agent-Based Flood Warning Framework using 2D Unsteady HEC-RAS Simulation, HydroShare, http://www.hydroshare.org/resource/cd3bb5c96a0f42e49faf3f0fcd9631cf

This resource is shared under the Creative Commons Attribution CC BY.

http://creativecommons.org/licenses/by/4.0/
CC-BY

Comments

There are currently no comments

New Comment

required