extracting-dss-results

Extract HMS DSS peak flows, hydrographs, and time-series data via RasDss with Python APIs.

6|2|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/gpt-cmdr/hms-commander --skill extracting-dss-results
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: extracting-dss-results
Source: https://github.com/gpt-cmdr/hms-commander/tree/main/.claude/skills/extracting-dss-results
Command: npx skills add https://github.com/gpt-cmdr/hms-commander --skill extracting-dss-results

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ras-commander, and includes references (resource) components.

What problem does it solve?

This Skill eliminates manual data extraction from HEC-HMS results files, automatically converting complex DSS data into clear, usable formats.

Core Features & Use Cases

  • Peak Flow Analysis: Automatically extract maximum flows and timing for all watershed elements.
  • Time Series Processing: Extract complete hydrographs for plotting, analysis, and export to other systems.

Quick Start

Get the peak flows from the results.dss file and display them in a clear summary table.

Frequently Asked Questions about extracting-dss-results

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract peak flows from HEC-HMS DSS result files?

Extract peak flows by parsing DSS files with the get_peak_flows API to automatically retrieve maximum flow values and timing for all watershed elements, eliminating manual data extraction from results files.

Can I export hydrograph time-series data from DSS files for use in other analysis tools?

Yes, use get_outflow_timeseries to extract complete hydrographs from DSS files and export_results_to_csv to convert time-series data into formats compatible with plotting and external systems like HEC-RAS.

Does this Skill support DSS V6 and V7 file formats?

Yes, the Skill provides DSS V6/V7 compatibility through RasDss, parsing standard DSS pathname formats to ensure reliable extraction across HMS result file versions.

How do I compare results across multiple HEC-HMS simulation runs?

Use the compare_runs API to analyze multiple DSS result files side-by-side, examining peak timing, hydrograph shapes, and volume summaries to identify differences across watershed simulations.

What data does the volume summary API extract from DSS files?

The get_volume_summary API quantifies total runoff volumes and flow accumulation from time-series data, supporting post-simulation analysis and HMS-to-HEC-RAS boundary condition workflows.

Do I need RasDss installed to parse HEC-HMS DSS result files?

Yes, ras-commander (which includes RasDss functionality) is a required dependency to parse DSS files and access hydrograph, peak flow, and time-series data from HMS simulations.