Skip to content

Meteorologic Models

Managing precipitation, evapotranspiration, and gage assignments in HEC-HMS meteorologic models (.met).

Overview

The HmsMet class provides methods for working with meteorologic model files, including precipitation methods, gage assignments, and frequency storm parameters.

Quick Examples

Get Gage Assignments

from hms_commander import HmsMet

# Read gage assignments
gages_df = HmsMet.get_gage_assignments("model.met")
print(gages_df)

Update Gage Assignment

# Assign gage to subbasin
HmsMet.set_gage_assignment(
    "model.met",
    subbasin="Sub1",
    gage="Precip_Gage_1"
)

Update Precipitation Depths (Atlas 14)

# Update TP-40 to Atlas 14 depths
atlas14_depths = [2.5, 3.1, 3.8, 4.5, 5.2, 6.0]
HmsMet.update_tp40_to_atlas14(
    "model.met",
    atlas14_depths=atlas14_depths
)

Key Operations

  • Precipitation methods - get_precipitation_method(), set_precipitation_method()
  • Gage assignments - get_gage_assignments(), set_gage_assignment()
  • Frequency storms - get_frequency_storm_params(), set_precipitation_depths()
  • Clone workflow - clone_met() for QAQC comparisons

Atlas 14 Updates

HMS Commander includes specialized support for updating precipitation from TP-40 to NOAA Atlas 14:

# Get current depths
depths = HmsMet.get_precipitation_depths("model.met")

# Update to Atlas 14 (from API or manual entry)
HmsMet.update_tp40_to_atlas14("model.met", new_depths)

For complete API documentation, see HmsMet 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.