ras-commander: Skill for Claude Code

Parsing HEC-RAS Compute Messages

Primary Sources (navigate to these for complete details):

• HDF Class Reference: ras_commander/hdf/AGENTS.md - Class hierarchy, decorators
• HdfResultsPlan Implementation: ras_commander/hdf/HdfResultsPlan.py - Compute message methods
• Working Example: examples/400_1d_hdf_data_extraction.ipynb - Compute message extraction

When the user asks about execution status or compute messages, use these patterns. Read the primary sources above for implementation details.

---

Quick Start

Check Plan Completion and Extract Messages

from ras_commander import init_ras_project, HdfResultsPlan

# Initialize project
init_ras_project("path/to/project", "7.0")

# 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")
else:
    print("Plan has not been executed or did not complete")

---

API Reference

HdfResultsPlan.get_compute_messages()

Call this to extract raw computation messages from HDF files.

Signature:

@staticmethod
@log_call
@standardize_input(file_type='plan_hdf')
def get_compute_messages(hdf_path: Path) -> str

Parameters:

• hdf_path: Plan HDF file path OR plan number string (e.g., "01")

Returns: String containing all computation messages, empty string if unavailable

Fallback Behavior:

1. First attempts: HDF path /Results/Summary/Compute Messages (text)
2. Fallback: .txt file via RasControl (for pre-6.x HEC-RAS)

Example:

messages = HdfResultsPlan.get_compute_messages("01")
print(len(messages))  # Character count

HdfResultsPlan.get_compute_messages_hdf_only()

Purpose: Extract compute messages WITHOUT RasControl/COM fallback