Parse HEC-RAS compute output from HDF files to extract execution status, diagnostic messages, and performance metrics. Converts raw computation messages into structured diagnostics for workflow orchestration. Use when checking plan completion status, extracting compute messages, diagnosing execution failures, analyzing runtime performance, or interpreting HEC-RAS error codes. Keywords: compute messages, execution status, plan complete, runtime, performance, error diagnostics, HEC-RAS output, simulation results, warnings, convergence, instability, time step, iteration.
Primary Sources (navigate to these for complete details):
ras_commander/hdf/AGENTS.md - Class hierarchy, decoratorsras_commander/hdf/HdfResultsPlan.py - Compute message methodsexamples/400_1d_hdf_data_extraction.ipynb - Compute message extractionWhen the user asks about execution status or compute messages, use these patterns. Read the primary sources above for implementation details.
from ras_commander import init_ras_project, HdfResultsPlan
# Initialize project
init_ras_project("path/to/project", "6.6")
# Extract compute messages (handles HDF + .txt fallback automatically)
messages = HdfResultsPlan.get_compute_messages("01")
# Check if plan has results (runtime data exists only for completed plans)
runtime = HdfResultsPlan.get_runtime_data("01")
is_complete = runtime is not None
if is_complete:
print(f"Plan completed in {runtime['Complete Process (hr)'].values[0]:.2f} hours")