Skip to content

Project Management

Working with HEC-HMS projects using HMS Commander's DataFrame-based approach.

Overview

HMS Commander provides the HmsPrj class for managing HEC-HMS projects. The project object maintains DataFrames for all project components (basins, meteorologic models, controls, runs, gages) and provides methods for project-wide operations.

Quick Start

from hms_commander import init_hms_project, hms

# Initialize project
init_hms_project(r"C:\path\to\project")

# Access project DataFrames
print(hms.basin_df)      # Basin models
print(hms.met_df)        # Meteorologic models
print(hms.control_df)    # Control specifications
print(hms.run_df)        # Simulation runs
print(hms.gage_df)       # Time-series gages

Key Features

  • DataFrame-based interface - All project data in pandas DataFrames
  • Multi-project support - Manage multiple projects simultaneously
  • Automatic discovery - Scans project folder for all HMS files
  • Path management - Maintains absolute paths to all project files

The API reference is generated from current package docstrings. Agent-facing files such as AGENTS.md and CLAUDE.md describe coding-agent behavior and should not be used as the user API reference.

CLB Engineering Corporation  ·  LLM Forward Engineering
HMS Commander is a free and open-source project maintained by CLB Engineering Corporation. For agencies and firms seeking to modernize H&H workflows with LLM Forward approaches, contact CLB to partner with the engineers who wrote the automation.