Extract HEC-RAS hydraulic results from HDF files including water surface elevations (WSE), depths, velocities, and flows for both steady and unsteady simulations. Handles cross section time series, 2D mesh results, maximum envelopes, and dam breach results. Use when you need to extract, analyze, or post-process HEC-RAS simulation outputs, retrieve water levels, query velocity fields, get depth grids, extract flow data, analyze breach hydrographs, or pull hydraulic variables from .hdf result files. Triggers: HDF results, extract WSE, water surface elevation, depth grid, velocity, flow data, mesh results, cross section time series, maximum envelope, breach results, HdfResultsPlan, HdfResultsMesh, HdfResultsBreach, steady results, unsteady results, plan HDF, .p01.hdf, get_wse, get_depth, get_velocity, post-process, simulation output.
When the user asks to extract HEC-RAS results, use the patterns below. Read the primary sources for complete details -- do not duplicate their content here.
Primary Sources:
ras_commander/hdf/AGENTS.md (215 lines) - Complete class hierarchy, lazy loading patterns, decoratorsras_commander/CLAUDE.md - HDF architecture overview, subpackage organizationexamples/400_1d_hdf_data_extraction.ipynb - 1D cross section results (unsteady)examples/410_2d_hdf_data_extraction.ipynb - 2D mesh results (comprehensive)examples/401_steady_flow_analysis.ipynb - Steady state results (complete workflow)examples/420_breach_results_extraction.ipynb - Dam breach resultsfrom ras_commander import init_ras_project, HdfResultsPlan, HdfResultsMesh
# Initialize project
init_ras_project("path/to/project", "6.6")
# Check simulation type
is_steady = HdfResultsPlan.is_steady_plan("01")
# Extract results based on type
if is_steady:
profiles = HdfResultsPlan.get_steady_profile_names("01")
wse = HdfResultsPlan.get_steady_wse("01", profile_name="100 year")