Skip to content

Cloud-Native Results Export with ras2cng

Export HEC-RAS simulation results to cloud-native GeoParquet, build interactive flood depth maps, and generate PMTiles for web deployment using ras2cng.

Python
#!pip install --upgrade ras-commander ras2cng "ras2cng[duckdb]"
Python
USE_LOCAL_SOURCE = False

if USE_LOCAL_SOURCE:
    import sys
    from pathlib import Path
    local_path = str(Path.cwd().parent)
    if local_path not in sys.path:
        sys.path.insert(0, local_path)
    print(f"LOCAL SOURCE MODE: Loading from {local_path}/ras_commander")
else:
    print("PIP PACKAGE MODE: Loading installed ras-commander")

from ras_commander import RasExamples, init_ras_project, RasCmdr, ras
from pathlib import Path
import geopandas as gpd

import ras_commander
print(f"ras-commander: {ras_commander.__file__}")

import ras2cng
print(f"ras2cng: {ras2cng.__file__}")
Text Only
PIP PACKAGE MODE: Loading installed ras-commander


2026-06-11 14:48:33 - numexpr.utils - INFO - NumExpr defaulting to 8 threads.


ras-commander: <repo>\ras_commander\__init__.py


ras2cng: <symphony-dev>\Lib\site-packages\ras2cng\__init__.py

Prerequisites

  • ras-commander installed: pip install ras-commander
  • ras2cng installed: pip install "ras2cng[duckdb]"
  • HEC-RAS installed: Required to run simulation (results export needs .p##.hdf files)
  • Optional: tippecanoe + pmtiles CLIs for PMTiles generation

What You'll Learn

  • Run a HEC-RAS plan and export results to GeoParquet
  • Join results to mesh cell polygons for thematic mapping
  • Query flood depth statistics with DuckDB SQL
  • Display interactive flood depth maps in the notebook
  • Archive a complete project (geometry + results + terrain)
  • Generate PMTiles for serverless flood map deployment
  • 960_cloud_native_geometry_export.ipynb — Export geometry to GeoParquet
  • 410_2d_hdf_data_extraction.ipynb — Extract 2D results with ras-commander
  • 110_single_plan_execution.ipynb — Execute plans with ras-commander

Parameters

Python
PROJECT_NAME = "BaldEagleCrkMulti2D"
RAS_VERSION = "6.6"
OUTPUT_DIR = Path("out/961_cloud_native_results")
OUTPUT_DIR.mkdir(parents=True, exist_ok=True)

Example 1: Results Export with Polygon Join

Extract a project, run a simulation, then export the results joined to mesh cell polygons for thematic flood mapping.

Extract and Initialize Project

Python
project_path = RasExamples.extract_project(PROJECT_NAME)
ras_obj = init_ras_project(project_path, RAS_VERSION)

print(f"Project: {project_path}")
print(f"Plans: {len(ras.plan_df)}")
print(f"Geometries: {len(ras.geom_df)}")
ras.plan_df[['plan_number', 'Plan Title', 'Geom File']].head()
Text Only
2026-06-11 14:48:37 - ras_commander.RasExamples - INFO - Successfully extracted project 'BaldEagleCrkMulti2D' to <repo>\examples\example_projects\BaldEagleCrkMulti2D


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 7.0 at <hec-ras-install>\7.0\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.7 Beta 5 at <hec-ras-install>\6.7 Beta 5\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.7 Beta 4 at <hec-ras-install>\6.7 Beta 4\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.6 at <hec-ras-install>\6.6\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.5 at <hec-ras-install>\6.5\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.4.1 at <hec-ras-install>\6.4.1\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.3.1 at <hec-ras-install>\6.3.1\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.3 at <hec-ras-install>\6.3\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.2 at <hec-ras-install>\6.2\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.1 at <hec-ras-install>\6.1\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.0 at <hec-ras-install>\6.0\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.7 at <hec-ras-install>\5.0.7\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.6 at <hec-ras-install>\5.0.6\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.5 at <hec-ras-install>\5.0.5\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.4 at <hec-ras-install>\5.0.4\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.3 at <hec-ras-install>\5.0.3\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.1 at <hec-ras-install>\5.0.1\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0 at <hec-ras-install>\5.0\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 4.1.0 at <hec-ras-install>\4.1.0\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 4.0 at <hec-ras-install>\4.0\Ras.exe via filesystem (x86)


2026-06-11 14:48:37 - ras_commander.RasUtils - INFO - Discovered 20 installed HEC-RAS version(s)


2026-06-11 14:48:37 - ras_commander.RasPrj - INFO - HEC-RAS 6.6 found via version discovery: <hec-ras-install>\6.6\Ras.exe


2026-06-11 14:48:37 - ras_commander.RasMap - INFO - Successfully parsed RASMapper file: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.rasmap


2026-06-11 14:48:37 - ras_commander.RasPrj - INFO - ras-commander v0.98.0 | An open-source project of CLB Engineering Corporation (https://clbengineering.com/) | Docs: https://rascommander.info | GitHub: https://github.com/gpt-cmdr/ras-commander


2026-06-11 14:48:37 - ras_commander.RasPrj - INFO - Project initialized: BaldEagleDamBrk | Folder: <repo>\examples\example_projects\BaldEagleCrkMulti2D


2026-06-11 14:48:37 - ras_commander.RasPrj - INFO - Using HEC-RAS executable: <hec-ras-install>\6.6\Ras.exe


2026-06-11 14:48:37 - ras_commander.RasPrj - INFO - 
═══════════════════════════════════════════════════════════════════════
ras-commander | HEC-RAS Automation Library
Docs: https://rascommander.info/
Repo: https://github.com/gpt-cmdr/ras-commander
═══════════════════════════════════════════════════════════════════════

PROJECT DATAFRAMES (single source of truth — use these, not file globbing):
  ras.plan_df        Plans, HDF paths, geometry/flow associations
  ras.geom_df        Geometry files and HDF preprocessor paths
  ras.flow_df        Steady flow files
  ras.unsteady_df    Unsteady flow files and configurations
  ras.boundaries_df  Boundary conditions (type, name, location)
  ras.results_df     Lightweight HDF results summaries
  ras.rasmap_df      RASMapper layers, terrain, land cover paths

KEY APIS (static classes — call directly, never instantiate):
  Execution:    RasCmdr.compute_plan() / compute_parallel() / compute_test_mode()
  Plan Files:   RasPlan.clone_plan() / clone_geom() / set_geom()
  Unsteady:     RasUnsteady — IC/BC management, gate openings, precipitation
  Geometry:     GeomCrossSection, GeomBridge, GeomStorage, GeomLateral, GeomMesh
  HDF Results:  HdfResultsPlan.get_wse() / get_compute_messages()
                HdfResultsMesh.get_mesh_max_ws() / get_mesh_cells_timeseries()
                HdfMesh.get_mesh_cell_points()
  QA/QC:        RasCheck.run_check() / RasFixit (geometry repair)
  DSS:          RasDss.get_timeseries() / check_pathname()
  USGS:         UsgsGaugeSpatial, GaugeMatcher, RasUsgsBoundaryGeneration
  Precipitation: StormGenerator, Atlas14Storm, PrecipAorc, Atlas14Variance
  Terrain:      RasTerrain.create_terrain_hdf() / RasTerrainMod

MULTI-PROJECT: Pass ras_object= to all API calls when using local RasPrj instances.

EXAMPLES: 100+ notebooks in examples/ (100s=execution, 200s=geometry, 300s=unsteady,
  400s=HDF results, 500s=remote, 800s=QA/QC, 900s=data integration).
  Review relevant notebooks before assembling new workflows.

PLATFORM: Most HEC-RAS operations require Windows. Linux/Wine support for
  headless execution, data access, geometry modification, and preprocessing
  is available via RasProcess (HEC-RAS 6.6+). See ras_commander/RasProcess.py.
  Remote distributed execution: ras_commander/remote/ (PsExec, Docker, SSH, cloud).
═══════════════════════════════════════════════════════════════════════


Project: <repo>\examples\example_projects\BaldEagleCrkMulti2D
Plans: 11
Geometries: 10
plan_number Plan Title Geom File
0 13 PMF with Multi 2D Areas 06
1 15 1d-2D Dambreak Refined Grid 08
2 17 2D to 1D No Dam 10
3 18 2D to 2D Run 11
4 19 SA to 2D Dam Break Run 12

Run Simulation

Execute the first plan to generate results HDF files. Smart skip will avoid re-running if results are already current.

Python
plan_number = ras.plan_df['plan_number'].iloc[0]
print(f"Running plan {plan_number}...")

try:
    RasCmdr.compute_plan(plan_number)
    print(f"Plan {plan_number} completed.")
except Exception as e:
    print(f"Execution failed: {e}")
    print("Continuing with any existing HDF files...")
Text Only
2026-06-11 14:48:37 - ras_commander.RasCmdr - INFO - Using ras_object with project folder: <repo>\examples\example_projects\BaldEagleCrkMulti2D


2026-06-11 14:48:37 - ras_commander.RasCmdr - INFO - Running HEC-RAS from the Command Line:


2026-06-11 14:48:37 - ras_commander.RasCmdr - INFO - Running command: "<hec-ras-install>\6.6\Ras.exe" -c "<repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.prj" "<repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.p13"


2026-06-11 14:48:37 - ras_commander.RasDialogWatchdog - INFO - DialogWatchdog started — polling every 1.5s for RAS dialog windows


Running plan 13...


2026-06-11 14:51:40 - ras_commander.RasCmdr - INFO - HEC-RAS execution completed for plan: 13


2026-06-11 14:51:40 - ras_commander.RasCmdr - INFO - Total run time for plan 13: 183.28 seconds


2026-06-11 14:51:40 - ras_commander.RasDialogWatchdog - INFO - DialogWatchdog stopped — no dialogs encountered


Plan 13 completed.
Python
plan_hdfs = sorted(project_path.glob("*.p??.hdf"))
geom_hdfs = sorted(project_path.glob("*.g??.hdf"))

print(f"Plan HDF files: {[f.name for f in plan_hdfs]}")
print(f"Geometry HDF files: {[f.name for f in geom_hdfs]}")

if not plan_hdfs:
    print("\nNo plan HDF files found. Run HEC-RAS first to generate results.")
    plan_hdf = None
else:
    plan_hdf = plan_hdfs[0]
    print(f"\nUsing plan HDF: {plan_hdf.name} ({plan_hdf.stat().st_size / 1e6:.1f} MB)")

# Match geometry HDF to the plan being used
plan_row = ras.plan_df[ras.plan_df['plan_number'] == plan_number].iloc[0]
geom_num = plan_row.get('Geom File', '01')
geom_hdf_match = project_path / f"{ras.project_name}.g{geom_num}.hdf"

if geom_hdf_match.exists():
    geom_hdf = geom_hdf_match
else:
    geom_hdf = geom_hdfs[0] if geom_hdfs else None

if geom_hdf:
    print(f"Using geom HDF: {geom_hdf.name} (matched to plan {plan_number})")
Text Only
Plan HDF files: ['BaldEagleDamBrk.p13.hdf']
Geometry HDF files: ['BaldEagleDamBrk.g01.hdf', 'BaldEagleDamBrk.g02.hdf', 'BaldEagleDamBrk.g03.hdf', 'BaldEagleDamBrk.g06.hdf', 'BaldEagleDamBrk.g08.hdf', 'BaldEagleDamBrk.g09.hdf', 'BaldEagleDamBrk.g10.hdf', 'BaldEagleDamBrk.g11.hdf', 'BaldEagleDamBrk.g12.hdf', 'BaldEagleDamBrk.g13.hdf']

Using plan HDF: BaldEagleDamBrk.p13.hdf (17.8 MB)
Using geom HDF: BaldEagleDamBrk.g06.hdf (matched to plan 13)

Export Mesh Geometry

First, export the mesh cell polygons. These serve as the base layer for joining results.

Python
from ras2cng import export_geometry_layers

mesh_out = OUTPUT_DIR / "mesh_cells.parquet"

if geom_hdf:
    export_geometry_layers(geom_hdf, mesh_out, layer="mesh_cells")
    gdf_mesh = gpd.read_parquet(mesh_out)
    print(f"Exported {len(gdf_mesh)} mesh cells")
elif plan_hdf:
    export_geometry_layers(plan_hdf, mesh_out, layer="mesh_cells")
    gdf_mesh = gpd.read_parquet(mesh_out)
    print(f"Exported {len(gdf_mesh)} mesh cells (from plan HDF)")
else:
    print("No HDF files available for geometry export")
    gdf_mesh = None
Text Only
Exported 4120 mesh cells

Export Results Joined to Polygons

Export Maximum Water Surface results joined to mesh cell polygons. Each row becomes a polygon with the result value as an attribute — ready for thematic mapping.

Python
from ras2cng import export_results_layer, export_all_variables

gdf_wse = None
if plan_hdf and mesh_out.exists():
    wse_out = OUTPUT_DIR / "maximum_wse.parquet"
    try:
        export_results_layer(
            plan_hdf,
            wse_out,
            variable="Maximum Water Surface",
            geom_file=mesh_out,
        )

        gdf_wse = gpd.read_parquet(wse_out)
        print(f"Exported {len(gdf_wse)} cells with Maximum Water Surface")
        print(f"WSE range: {gdf_wse['maximum_water_surface'].min():.2f} - {gdf_wse['maximum_water_surface'].max():.2f}")
        gdf_wse.head()
    except Exception as e:
        print(f"Results export failed: {e}")
        print("This may occur if the plan has no 2D summary results.")
else:
    print("No plan HDF or mesh geometry available for results export")
Text Only
2026-06-11 14:51:41 - ras_commander.hdf.HdfResultsMesh - INFO - Processed 4785 rows of summary output data


Exported 4120 cells with Maximum Water Surface
WSE range: 559.70 - 889.99

DuckDB Analytics on Results

Query water surface elevation statistics by mesh area using DuckDB.

Python
from ras2cng import query_parquet

if gdf_wse is not None:
    df_flood_stats = query_parquet(
        wse_out,
        """
        SELECT
            mesh_name,
            COUNT(*) AS total_cells,
            ROUND(MIN(maximum_water_surface), 2) AS min_wse,
            ROUND(MAX(maximum_water_surface), 2) AS max_wse,
            ROUND(AVG(maximum_water_surface), 2) AS avg_wse
        FROM _
        GROUP BY mesh_name
        ORDER BY max_wse DESC
        """
    )
    print("Water surface elevation statistics by mesh area:")
    df_flood_stats
else:
    print("No results available for DuckDB analytics.")
Text Only
Water surface elevation statistics by mesh area:
Python
if gdf_wse is not None:
    df_high_wse = query_parquet(
        wse_out,
        """
        SELECT mesh_name, cell_id, ROUND(maximum_water_surface, 2) AS wse_ft
        FROM _
        ORDER BY maximum_water_surface DESC
        LIMIT 20
        """
    )
    print("Top 20 highest WSE cells:")
    df_high_wse
else:
    print("No results available.")
Text Only
Top 20 highest WSE cells:

Interactive Water Surface Elevation Map

Display the WSE results as a choropleth map. Cells are colored by maximum water surface elevation.

Python
if gdf_wse is not None:
    try:
        gdf_wse_wgs84 = gdf_wse.to_crs("EPSG:4326")

        print(f"Displaying {len(gdf_wse)} cells with WSE results")

        gdf_wse_wgs84.explore(
            column="maximum_water_surface",
            cmap="Blues",
            tooltip=["mesh_name", "cell_id", "maximum_water_surface"],
            style_kwds={"weight": 0.3, "fillOpacity": 0.6},
            legend_kwds={"caption": "Maximum Water Surface (ft)"},
            tiles="CartoDB positron",
        )
    except ImportError as e:
        print(f"Interactive map requires folium and mapclassify: {e}")
        print("Install with: pip install folium mapclassify")
        print(f"\nWSE range: {gdf_wse['maximum_water_surface'].min():.2f} - {gdf_wse['maximum_water_surface'].max():.2f}")
else:
    print("No results available for mapping.")
Text Only
Displaying 4120 cells with WSE results
Interactive map requires folium and mapclassify: The 'folium>=0.12', 'matplotlib' and 'mapclassify' packages are required for 'explore()'. You can install them using 'conda install -c conda-forge "folium>=0.12" matplotlib mapclassify' or 'pip install "folium>=0.12" matplotlib mapclassify'.
Install with: pip install folium mapclassify

WSE range: 559.70 - 889.99

Example 2: Full Project Archive

Archive the entire project — all geometry files, plan results, and terrain — to a consolidated GeoParquet archive with a manifest.json catalog.

Python
from ras2cng import archive_project, inspect_project

info = inspect_project(project_path)
print(f"Project: {info.name}")
print(f"Geometry files: {len(info.geom_files)}")
print(f"Plan files: {len(info.plan_files)}")
print(f"Has terrain: {bool(info.terrain_files)}")
Text Only
2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 7.0 at <hec-ras-install>\7.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.7 Beta 5 at <hec-ras-install>\6.7 Beta 5\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.7 Beta 4 at <hec-ras-install>\6.7 Beta 4\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.6 at <hec-ras-install>\6.6\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.5 at <hec-ras-install>\6.5\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.4.1 at <hec-ras-install>\6.4.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.3.1 at <hec-ras-install>\6.3.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.3 at <hec-ras-install>\6.3\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.2 at <hec-ras-install>\6.2\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.1 at <hec-ras-install>\6.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.0 at <hec-ras-install>\6.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.7 at <hec-ras-install>\5.0.7\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.6 at <hec-ras-install>\5.0.6\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.5 at <hec-ras-install>\5.0.5\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.4 at <hec-ras-install>\5.0.4\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.3 at <hec-ras-install>\5.0.3\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.1 at <hec-ras-install>\5.0.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0 at <hec-ras-install>\5.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 4.1.0 at <hec-ras-install>\4.1.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 4.0 at <hec-ras-install>\4.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered 20 installed HEC-RAS version(s)


2026-06-11 14:51:42 - ras_commander.RasPrj - INFO - HEC-RAS 5.0.3 found via version discovery: <hec-ras-install>\5.0.3\Ras.exe


2026-06-11 14:51:42 - ras_commander.RasPrj - INFO - Detected HEC-RAS version 5.03 from BaldEagleDamBrk.p01


2026-06-11 14:51:42 - ras_commander.RasMap - INFO - Successfully parsed RASMapper file: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.rasmap


2026-06-11 14:51:42 - ras_commander.RasPrj - INFO - ras-commander v0.98.0 | An open-source project of CLB Engineering Corporation (https://clbengineering.com/) | Docs: https://rascommander.info | GitHub: https://github.com/gpt-cmdr/ras-commander


2026-06-11 14:51:42 - ras_commander.RasPrj - INFO - Project initialized: BaldEagleDamBrk | Folder: <repo>\examples\example_projects\BaldEagleCrkMulti2D


2026-06-11 14:51:42 - ras_commander.RasPrj - INFO - Using HEC-RAS executable: <hec-ras-install>\5.0.3\Ras.exe


2026-06-11 14:51:42 - ras_commander.RasPrj - INFO - 
═══════════════════════════════════════════════════════════════════════
ras-commander | HEC-RAS Automation Library
Docs: https://rascommander.info/
Repo: https://github.com/gpt-cmdr/ras-commander
═══════════════════════════════════════════════════════════════════════

PROJECT DATAFRAMES (single source of truth — use these, not file globbing):
  ras_object.plan_df        Plans, HDF paths, geometry/flow associations
  ras_object.geom_df        Geometry files and HDF preprocessor paths
  ras_object.flow_df        Steady flow files
  ras_object.unsteady_df    Unsteady flow files and configurations
  ras_object.boundaries_df  Boundary conditions (type, name, location)
  ras_object.results_df     Lightweight HDF results summaries
  ras_object.rasmap_df      RASMapper layers, terrain, land cover paths

KEY APIS (static classes — call directly, never instantiate):
  Execution:    RasCmdr.compute_plan() / compute_parallel() / compute_test_mode()
  Plan Files:   RasPlan.clone_plan() / clone_geom() / set_geom()
  Unsteady:     RasUnsteady — IC/BC management, gate openings, precipitation
  Geometry:     GeomCrossSection, GeomBridge, GeomStorage, GeomLateral, GeomMesh
  HDF Results:  HdfResultsPlan.get_wse() / get_compute_messages()
                HdfResultsMesh.get_mesh_max_ws() / get_mesh_cells_timeseries()
                HdfMesh.get_mesh_cell_points()
  QA/QC:        RasCheck.run_check() / RasFixit (geometry repair)
  DSS:          RasDss.get_timeseries() / check_pathname()
  USGS:         UsgsGaugeSpatial, GaugeMatcher, RasUsgsBoundaryGeneration
  Precipitation: StormGenerator, Atlas14Storm, PrecipAorc, Atlas14Variance
  Terrain:      RasTerrain.create_terrain_hdf() / RasTerrainMod

MULTI-PROJECT: Pass ras_object= to all API calls when using local RasPrj instances.

EXAMPLES: 100+ notebooks in examples/ (100s=execution, 200s=geometry, 300s=unsteady,
  400s=HDF results, 500s=remote, 800s=QA/QC, 900s=data integration).
  Review relevant notebooks before assembling new workflows.

PLATFORM: Most HEC-RAS operations require Windows. Linux/Wine support for
  headless execution, data access, geometry modification, and preprocessing
  is available via RasProcess (HEC-RAS 6.6+). See ras_commander/RasProcess.py.
  Remote distributed execution: ras_commander/remote/ (PsExec, Docker, SSH, cloud).
═══════════════════════════════════════════════════════════════════════


2026-06-11 14:51:42 - ras_commander.RasMap - INFO - Extracted terrain names: ['Terrain50']


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 7.0 at <hec-ras-install>\7.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.7 Beta 5 at <hec-ras-install>\6.7 Beta 5\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.7 Beta 4 at <hec-ras-install>\6.7 Beta 4\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.6 at <hec-ras-install>\6.6\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.5 at <hec-ras-install>\6.5\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.4.1 at <hec-ras-install>\6.4.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.3.1 at <hec-ras-install>\6.3.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.3 at <hec-ras-install>\6.3\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.2 at <hec-ras-install>\6.2\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.1 at <hec-ras-install>\6.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.0 at <hec-ras-install>\6.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.7 at <hec-ras-install>\5.0.7\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.6 at <hec-ras-install>\5.0.6\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.5 at <hec-ras-install>\5.0.5\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.4 at <hec-ras-install>\5.0.4\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.3 at <hec-ras-install>\5.0.3\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.1 at <hec-ras-install>\5.0.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0 at <hec-ras-install>\5.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 4.1.0 at <hec-ras-install>\4.1.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 4.0 at <hec-ras-install>\4.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:42 - ras_commander.RasUtils - INFO - Discovered 20 installed HEC-RAS version(s)


2026-06-11 14:51:42 - ras_commander.RasPrj - INFO - HEC-RAS 5.0.3 found via version discovery: <hec-ras-install>\5.0.3\Ras.exe


2026-06-11 14:51:42 - ras_commander.RasPrj - INFO - Detected HEC-RAS version 5.03 from BaldEagleDamBrk.p01


2026-06-11 14:51:43 - ras_commander.RasMap - INFO - Successfully parsed RASMapper file: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.rasmap


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - ras-commander v0.98.0 | An open-source project of CLB Engineering Corporation (https://clbengineering.com/) | Docs: https://rascommander.info | GitHub: https://github.com/gpt-cmdr/ras-commander


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - Project initialized: BaldEagleDamBrk | Folder: <repo>\examples\example_projects\BaldEagleCrkMulti2D


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - Using HEC-RAS executable: <hec-ras-install>\5.0.3\Ras.exe


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - 
═══════════════════════════════════════════════════════════════════════
ras-commander | HEC-RAS Automation Library
Docs: https://rascommander.info/
Repo: https://github.com/gpt-cmdr/ras-commander
═══════════════════════════════════════════════════════════════════════

PROJECT DATAFRAMES (single source of truth — use these, not file globbing):
  ras_object.plan_df        Plans, HDF paths, geometry/flow associations
  ras_object.geom_df        Geometry files and HDF preprocessor paths
  ras_object.flow_df        Steady flow files
  ras_object.unsteady_df    Unsteady flow files and configurations
  ras_object.boundaries_df  Boundary conditions (type, name, location)
  ras_object.results_df     Lightweight HDF results summaries
  ras_object.rasmap_df      RASMapper layers, terrain, land cover paths

KEY APIS (static classes — call directly, never instantiate):
  Execution:    RasCmdr.compute_plan() / compute_parallel() / compute_test_mode()
  Plan Files:   RasPlan.clone_plan() / clone_geom() / set_geom()
  Unsteady:     RasUnsteady — IC/BC management, gate openings, precipitation
  Geometry:     GeomCrossSection, GeomBridge, GeomStorage, GeomLateral, GeomMesh
  HDF Results:  HdfResultsPlan.get_wse() / get_compute_messages()
                HdfResultsMesh.get_mesh_max_ws() / get_mesh_cells_timeseries()
                HdfMesh.get_mesh_cell_points()
  QA/QC:        RasCheck.run_check() / RasFixit (geometry repair)
  DSS:          RasDss.get_timeseries() / check_pathname()
  USGS:         UsgsGaugeSpatial, GaugeMatcher, RasUsgsBoundaryGeneration
  Precipitation: StormGenerator, Atlas14Storm, PrecipAorc, Atlas14Variance
  Terrain:      RasTerrain.create_terrain_hdf() / RasTerrainMod

MULTI-PROJECT: Pass ras_object= to all API calls when using local RasPrj instances.

EXAMPLES: 100+ notebooks in examples/ (100s=execution, 200s=geometry, 300s=unsteady,
  400s=HDF results, 500s=remote, 800s=QA/QC, 900s=data integration).
  Review relevant notebooks before assembling new workflows.

PLATFORM: Most HEC-RAS operations require Windows. Linux/Wine support for
  headless execution, data access, geometry modification, and preprocessing
  is available via RasProcess (HEC-RAS 6.6+). See ras_commander/RasProcess.py.
  Remote distributed execution: ras_commander/remote/ (PsExec, Docker, SSH, cloud).
═══════════════════════════════════════════════════════════════════════


Project: BaldEagleDamBrk
Geometry files: 10
Plan files: 11
Has terrain: True
Python
archive_dir = OUTPUT_DIR / "archive"
archive_dir.mkdir(parents=True, exist_ok=True)

manifest = archive_project(
    project_path,
    archive_dir,
    include_results=bool(plan_hdfs),
    include_terrain=False,
)

print(f"\nArchive complete:")
print(f"  Geometry configs: {len(manifest.geometry)}")
if hasattr(manifest, 'plans'):
    print(f"  Plan results: {len(manifest.plans)}")

print(f"\nArchive files:")
for f in sorted(archive_dir.glob("*")):
    print(f"  {f.name:40s} {f.stat().st_size / 1e3:>8.1f} KB")

ras2cng archive -> out\961_cloud_native_results\archive

  Project : BaldEagleDamBrk.prj
Text Only
2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 7.0 at <hec-ras-install>\7.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.7 Beta 5 at <hec-ras-install>\6.7 Beta 5\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.7 Beta 4 at <hec-ras-install>\6.7 Beta 4\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.6 at <hec-ras-install>\6.6\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.5 at <hec-ras-install>\6.5\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.4.1 at <hec-ras-install>\6.4.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.3.1 at <hec-ras-install>\6.3.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.3 at <hec-ras-install>\6.3\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.2 at <hec-ras-install>\6.2\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.1 at <hec-ras-install>\6.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 6.0 at <hec-ras-install>\6.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.7 at <hec-ras-install>\5.0.7\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.6 at <hec-ras-install>\5.0.6\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.5 at <hec-ras-install>\5.0.5\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.4 at <hec-ras-install>\5.0.4\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.3 at <hec-ras-install>\5.0.3\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0.1 at <hec-ras-install>\5.0.1\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 5.0 at <hec-ras-install>\5.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 4.1.0 at <hec-ras-install>\4.1.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered HEC-RAS 4.0 at <hec-ras-install>\4.0\Ras.exe via filesystem (x86)


2026-06-11 14:51:43 - ras_commander.RasUtils - INFO - Discovered 20 installed HEC-RAS version(s)


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - HEC-RAS 5.0.3 found via version discovery: <hec-ras-install>\5.0.3\Ras.exe


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - Detected HEC-RAS version 5.03 from BaldEagleDamBrk.p01


2026-06-11 14:51:43 - ras_commander.RasMap - INFO - Successfully parsed RASMapper file: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.rasmap


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - ras-commander v0.98.0 | An open-source project of CLB Engineering Corporation (https://clbengineering.com/) | Docs: https://rascommander.info | GitHub: https://github.com/gpt-cmdr/ras-commander


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - Project initialized: BaldEagleDamBrk | Folder: <repo>\examples\example_projects\BaldEagleCrkMulti2D


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - Using HEC-RAS executable: <hec-ras-install>\5.0.3\Ras.exe


2026-06-11 14:51:43 - ras_commander.RasPrj - INFO - 
═══════════════════════════════════════════════════════════════════════
ras-commander | HEC-RAS Automation Library
Docs: https://rascommander.info/
Repo: https://github.com/gpt-cmdr/ras-commander
═══════════════════════════════════════════════════════════════════════

PROJECT DATAFRAMES (single source of truth — use these, not file globbing):
  ras_object.plan_df        Plans, HDF paths, geometry/flow associations
  ras_object.geom_df        Geometry files and HDF preprocessor paths
  ras_object.flow_df        Steady flow files
  ras_object.unsteady_df    Unsteady flow files and configurations
  ras_object.boundaries_df  Boundary conditions (type, name, location)
  ras_object.results_df     Lightweight HDF results summaries
  ras_object.rasmap_df      RASMapper layers, terrain, land cover paths

KEY APIS (static classes — call directly, never instantiate):
  Execution:    RasCmdr.compute_plan() / compute_parallel() / compute_test_mode()
  Plan Files:   RasPlan.clone_plan() / clone_geom() / set_geom()
  Unsteady:     RasUnsteady — IC/BC management, gate openings, precipitation
  Geometry:     GeomCrossSection, GeomBridge, GeomStorage, GeomLateral, GeomMesh
  HDF Results:  HdfResultsPlan.get_wse() / get_compute_messages()
                HdfResultsMesh.get_mesh_max_ws() / get_mesh_cells_timeseries()
                HdfMesh.get_mesh_cell_points()
  QA/QC:        RasCheck.run_check() / RasFixit (geometry repair)
  DSS:          RasDss.get_timeseries() / check_pathname()
  USGS:         UsgsGaugeSpatial, GaugeMatcher, RasUsgsBoundaryGeneration
  Precipitation: StormGenerator, Atlas14Storm, PrecipAorc, Atlas14Variance
  Terrain:      RasTerrain.create_terrain_hdf() / RasTerrainMod

MULTI-PROJECT: Pass ras_object= to all API calls when using local RasPrj instances.

EXAMPLES: 100+ notebooks in examples/ (100s=execution, 200s=geometry, 300s=unsteady,
  400s=HDF results, 500s=remote, 800s=QA/QC, 900s=data integration).
  Review relevant notebooks before assembling new workflows.

PLATFORM: Most HEC-RAS operations require Windows. Linux/Wine support for
  headless execution, data access, geometry modification, and preprocessing
  is available via RasProcess (HEC-RAS 6.6+). See ras_commander/RasProcess.py.
  Remote distributed execution: ras_commander/remote/ (PsExec, Docker, SSH, cloud).
═══════════════════════════════════════════════════════════════════════

Geometry: 10 file(s)

   -> BaldEagleDamBrk.g06.parquet
Text Only
2026-06-11 14:51:44 - ras_commander.hdf.HdfBndry - WARNING - Breaklines path 'Geometry/2D Flow Area Break Lines' not found in HDF file.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 0.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 2.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 4.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 5.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 8.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 17.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 19.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Dropped 7 structures due to invalid geometries.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Table Info count does not match Structures count. Skipping merge.


2026-06-11 14:51:44 - ras_commander.hdf.HdfStruc - WARNING - Required columns for Profile Data not found in Table Info.


2026-06-11 14:51:44 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g06


2026-06-11 14:51:44 - ras_commander.geom.GeomParser - INFO - Found 192 XS cut lines


2026-06-11 14:51:44 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g06


2026-06-11 14:51:44 - ras_commander.geom.GeomParser - INFO - Found 1 river centerlines


<symphony-dev>\Lib\site-packages\geopandas\array.py:1770: UserWarning: CRS not set for some of the concatenation inputs. Setting output's CRS as NAD83 / Pennsylvania North (ftUS) (the single non-null crs provided).
  return GeometryArray(data, crs=_get_common_crs(to_concat))

   -> BaldEagleDamBrk.g08.parquet
Text Only
2026-06-11 14:51:47 - ras_commander.hdf.HdfXsec - WARNING - No river bank lines found in geometry file


2026-06-11 14:51:47 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 0.


2026-06-11 14:51:47 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 2.


2026-06-11 14:51:47 - ras_commander.hdf.HdfStruc - WARNING - Dropped 2 structures due to invalid geometries.


2026-06-11 14:51:47 - ras_commander.hdf.HdfStruc - WARNING - Table Info count does not match Structures count. Skipping merge.


2026-06-11 14:51:47 - ras_commander.hdf.HdfStruc - WARNING - Required columns for Profile Data not found in Table Info.


2026-06-11 14:51:47 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g08


2026-06-11 14:51:47 - ras_commander.geom.GeomParser - INFO - Found 89 XS cut lines


2026-06-11 14:51:47 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g08


2026-06-11 14:51:47 - ras_commander.geom.GeomParser - INFO - Found 1 river centerlines


<symphony-dev>\Lib\site-packages\geopandas\array.py:1770: UserWarning: CRS not set for some of the concatenation inputs. Setting output's CRS as NAD83 / Pennsylvania North (ftUS) (the single non-null crs provided).
  return GeometryArray(data, crs=_get_common_crs(to_concat))

   -> BaldEagleDamBrk.g10.parquet
Text Only
2026-06-11 14:51:48 - ras_commander.hdf.HdfXsec - WARNING - No river bank lines found in geometry file


2026-06-11 14:51:48 - ras_commander.hdf.HdfBndry - WARNING - Breaklines path 'Geometry/2D Flow Area Break Lines' not found in HDF file.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 1.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 3.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 5.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 7.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 9.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 10.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Insufficient points for LineString in structure index 12.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Dropped 7 structures due to invalid geometries.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Table Info count does not match Structures count. Skipping merge.


2026-06-11 14:51:48 - ras_commander.hdf.HdfStruc - WARNING - Required columns for Profile Data not found in Table Info.


2026-06-11 14:51:48 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g10


2026-06-11 14:51:48 - ras_commander.geom.GeomParser - INFO - Found 69 XS cut lines


2026-06-11 14:51:48 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g10


2026-06-11 14:51:48 - ras_commander.geom.GeomParser - INFO - Found 1 river centerlines


<symphony-dev>\Lib\site-packages\geopandas\array.py:1770: UserWarning: CRS not set for some of the concatenation inputs. Setting output's CRS as NAD83 / Pennsylvania North (ftUS) (the single non-null crs provided).
  return GeometryArray(data, crs=_get_common_crs(to_concat))

   -> BaldEagleDamBrk.g11.parquet
Text Only
2026-06-11 14:51:49 - ras_commander.hdf.HdfXsec - ERROR - Error processing cross-section data: 'Unable to synchronously open object (component not found)'


2026-06-11 14:51:49 - ras_commander.hdf.HdfXsec - WARNING - No river centerlines found in geometry file


2026-06-11 14:51:49 - ras_commander.hdf.HdfXsec - WARNING - No river bank lines found in geometry file


2026-06-11 14:51:50 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g11


2026-06-11 14:51:50 - ras_commander.geom.GeomParser - INFO - Found 0 XS cut lines


2026-06-11 14:51:50 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g11


2026-06-11 14:51:50 - ras_commander.geom.GeomParser - INFO - Found 0 river centerlines

   -> BaldEagleDamBrk.g12.parquet
Text Only
2026-06-11 14:51:51 - ras_commander.hdf.HdfXsec - ERROR - Error processing cross-section data: 'Unable to synchronously open object (component not found)'


2026-06-11 14:51:51 - ras_commander.hdf.HdfXsec - WARNING - No river centerlines found in geometry file


2026-06-11 14:51:51 - ras_commander.hdf.HdfXsec - WARNING - No river bank lines found in geometry file


2026-06-11 14:51:51 - ras_commander.hdf.HdfBndry - WARNING - Breaklines path 'Geometry/2D Flow Area Break Lines' not found in HDF file.


2026-06-11 14:51:51 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g12


2026-06-11 14:51:51 - ras_commander.geom.GeomParser - INFO - Found 0 XS cut lines


2026-06-11 14:51:51 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g12


2026-06-11 14:51:51 - ras_commander.geom.GeomParser - INFO - Found 0 river centerlines

   -> BaldEagleDamBrk.g09.parquet
Text Only
2026-06-11 14:51:53 - ras_commander.hdf.HdfXsec - ERROR - Error processing cross-section data: "Unable to synchronously open object (object 'Polyline Info' doesn't exist)"


2026-06-11 14:51:53 - ras_commander.hdf.HdfXsec - WARNING - No river centerlines found in geometry file


2026-06-11 14:51:53 - ras_commander.hdf.HdfXsec - WARNING - No river bank lines found in geometry file


2026-06-11 14:51:53 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g09


2026-06-11 14:51:53 - ras_commander.geom.GeomParser - INFO - Found 0 XS cut lines


2026-06-11 14:51:53 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g09


2026-06-11 14:51:53 - ras_commander.geom.GeomParser - INFO - Found 0 river centerlines

   -> BaldEagleDamBrk.g13.parquet
Text Only
2026-06-11 14:51:56 - ras_commander.hdf.HdfXsec - ERROR - Error processing cross-section data: 'Unable to synchronously open object (component not found)'


2026-06-11 14:51:56 - ras_commander.hdf.HdfXsec - WARNING - No river centerlines found in geometry file


2026-06-11 14:51:56 - ras_commander.hdf.HdfXsec - WARNING - No river bank lines found in geometry file


2026-06-11 14:51:56 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g13


2026-06-11 14:51:56 - ras_commander.geom.GeomParser - INFO - Found 0 XS cut lines


2026-06-11 14:51:56 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g13


2026-06-11 14:51:56 - ras_commander.geom.GeomParser - INFO - Found 0 river centerlines

   -> BaldEagleDamBrk.g01.parquet
Text Only
2026-06-11 14:52:08 - ras_commander.hdf.HdfXsec - ERROR - Error processing cross-section data: 'Unable to synchronously open object (component not found)'


2026-06-11 14:52:08 - ras_commander.hdf.HdfXsec - WARNING - No river centerlines found in geometry file


2026-06-11 14:52:08 - ras_commander.hdf.HdfXsec - WARNING - No river bank lines found in geometry file


2026-06-11 14:52:08 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g01


2026-06-11 14:52:08 - ras_commander.geom.GeomParser - INFO - Found 0 XS cut lines


2026-06-11 14:52:08 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g01


2026-06-11 14:52:08 - ras_commander.geom.GeomParser - INFO - Found 0 river centerlines

   -> BaldEagleDamBrk.g03.parquet
Text Only
2026-06-11 14:52:13 - ras_commander.hdf.HdfXsec - ERROR - Error processing cross-section data: 'Unable to synchronously open object (component not found)'


2026-06-11 14:52:13 - ras_commander.hdf.HdfXsec - WARNING - No river centerlines found in geometry file


2026-06-11 14:52:13 - ras_commander.hdf.HdfXsec - WARNING - No river bank lines found in geometry file


2026-06-11 14:52:14 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g03


2026-06-11 14:52:14 - ras_commander.geom.GeomParser - INFO - Found 0 XS cut lines


2026-06-11 14:52:14 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g03


2026-06-11 14:52:14 - ras_commander.geom.GeomParser - INFO - Found 0 river centerlines

   -> BaldEagleDamBrk.g02.parquet
Text Only
2026-06-11 14:52:18 - ras_commander.hdf.HdfXsec - ERROR - Error processing cross-section data: 'Unable to synchronously open object (component not found)'


2026-06-11 14:52:18 - ras_commander.hdf.HdfXsec - WARNING - No river centerlines found in geometry file


2026-06-11 14:52:18 - ras_commander.hdf.HdfXsec - WARNING - No river bank lines found in geometry file


2026-06-11 14:52:18 - ras_commander.geom.GeomParser - INFO - Extracting XS cut lines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g02


2026-06-11 14:52:18 - ras_commander.geom.GeomParser - INFO - Found 0 XS cut lines


2026-06-11 14:52:18 - ras_commander.geom.GeomParser - INFO - Extracting river centerlines from: <repo>\examples\example_projects\BaldEagleCrkMulti2D\BaldEagleDamBrk.g02


2026-06-11 14:52:18 - ras_commander.geom.GeomParser - INFO - Found 0 river centerlines

Results: 11 plan(s) in project

   -> BaldEagleDamBrk.p13.parquet
Text Only
2026-06-11 14:52:18 - ras_commander.hdf.HdfResultsMesh - ERROR - Error processing summary output data: Unexpected data shape for Cell Cumulative Iter Lookup in 193. Got shape (1, 2)


2026-06-11 14:52:18 - ras_commander.hdf.HdfResultsMesh - INFO - Processed 4785 rows of summary output data


Warning: Could not extract 'Cell Cumulative Iter Lookup': Error processing summary output data: Unexpected data shape for Cell Cumulative Iter Lookup in 193. Got shape (1, 2)


2026-06-11 14:52:19 - ras_commander.hdf.HdfResultsMesh - INFO - Processed 4785 rows of summary output data


2026-06-11 14:52:19 - ras_commander.hdf.HdfResultsMesh - INFO - Processed 4785 rows of summary output data


2026-06-11 14:52:19 - ras_commander.hdf.HdfResultsMesh - INFO - Processed 8721 rows of summary output data


2026-06-11 14:52:19 - ras_commander.hdf.HdfResultsMesh - INFO - Processed 4785 rows of summary output data


2026-06-11 14:52:20 - ras_commander.hdf.HdfResultsMesh - INFO - Processed 8721 rows of summary output data


2026-06-11 14:52:20 - ras_commander.hdf.HdfResultsMesh - INFO - Processed 4785 rows of summary output data


2026-06-11 14:52:20 - ras_commander.hdf.HdfResultsMesh - ERROR - Error processing summary output data: Unexpected data shape for Starting Differences Velocity in 193. Got shape (3, 2130)


2026-06-11 14:52:20 - ras_commander.hdf.HdfResultsMesh - ERROR - Error processing summary output data: Unexpected data shape for Starting Differences WSE in 193. Got shape (3, 1216)


Warning: Could not extract 'Starting Differences Velocity': Error processing summary output data: Unexpected data shape for Starting Differences Velocity in 193. Got shape (3, 2130)
Warning: Could not extract 'Starting Differences WSE': Error processing summary output data: Unexpected data shape for Starting Differences WSE in 193. Got shape (3, 1216)

   No HDF results - skipping

   No HDF results - skipping

   No HDF results - skipping

   No HDF results - skipping

   No HDF results - skipping

   No HDF results - skipping

   No HDF results - skipping

   No HDF results - skipping

   No HDF results - skipping

   No HDF results - skipping

Metadata: BaldEagleDamBrk.parquet

OK manifest.json written -> out\961_cloud_native_results\archive\manifest.json

OK Archive complete: out\961_cloud_native_results\archive
Text Only
Archive complete:
  Geometry configs: 10

Archive files:
  BaldEagleDamBrk.g01.parquet                2954.4 KB
  BaldEagleDamBrk.g02.parquet                1307.9 KB
  BaldEagleDamBrk.g03.parquet                1929.1 KB
  BaldEagleDamBrk.g06.parquet                 913.0 KB
  BaldEagleDamBrk.g08.parquet                1073.6 KB
  BaldEagleDamBrk.g09.parquet                 889.6 KB
  BaldEagleDamBrk.g10.parquet                 504.6 KB
  BaldEagleDamBrk.g11.parquet                 343.4 KB
  BaldEagleDamBrk.g12.parquet                 280.1 KB
  BaldEagleDamBrk.g13.parquet                 781.0 KB
  BaldEagleDamBrk.p13.parquet                 512.3 KB
  BaldEagleDamBrk.parquet                     101.4 KB
  manifest.json                                19.5 KB
Python
archive_parquets = sorted(archive_dir.glob("*.parquet"))

if archive_parquets:
    for pq in archive_parquets:
        try:
            gdf = gpd.read_parquet(pq)
            if 'layer' in gdf.columns:
                layers = gdf['layer'].unique()
                print(f"{pq.name}: {len(gdf)} features, layers: {list(layers)}")
            elif '_table' in gdf.columns:
                tables = gdf['_table'].unique()
                print(f"{pq.name}: {len(gdf)} rows, tables: {list(tables)}")
            else:
                print(f"{pq.name}: {len(gdf)} features")
        except Exception as e:
            import pandas as pd
            try:
                df = pd.read_parquet(pq)
                print(f"{pq.name}: {len(df)} rows (non-spatial)")
            except Exception:
                print(f"{pq.name}: could not read ({e})")
Text Only
BaldEagleDamBrk.g01.parquet: 174087 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'bc_lines', 'breaklines', 'structures', 'storage_areas_text']
BaldEagleDamBrk.g02.parquet: 56910 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'bc_lines', 'breaklines', 'structures']
BaldEagleDamBrk.g03.parquet: 49454 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'bc_lines', 'breaklines', 'structures']


BaldEagleDamBrk.g06.parquet: 8648 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'cross_sections', 'centerlines', 'bank_lines', 'structures', 'cross_sections_text', 'centerlines_text', 'storage_areas_text']
BaldEagleDamBrk.g08.parquet: 28601 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'cross_sections', 'centerlines', 'bc_lines', 'breaklines', 'structures', 'cross_sections_text', 'centerlines_text', 'storage_areas_text']
BaldEagleDamBrk.g09.parquet: 36141 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'bc_lines', 'breaklines', 'structures']
BaldEagleDamBrk.g10.parquet: 10810 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'cross_sections', 'centerlines', 'bc_lines', 'structures', 'cross_sections_text', 'centerlines_text', 'storage_areas_text']


BaldEagleDamBrk.g11.parquet: 8859 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'bc_lines', 'breaklines', 'structures']
BaldEagleDamBrk.g12.parquet: 6883 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'bc_lines', 'structures', 'storage_areas_text']
BaldEagleDamBrk.g13.parquet: 28740 features, layers: ['mesh_cells', 'mesh_faces', 'mesh_areas', 'bc_lines', 'breaklines', 'structures', 'storage_areas_text']
BaldEagleDamBrk.p13.parquet: 38042 features, layers: ['cell_cumulative_iteration', 'cell_last_iteration', 'cell_maximum_water_surface_error', 'maximum_face_velocity', 'maximum_water_surface', 'minimum_face_velocity', 'minimum_water_surface']
BaldEagleDamBrk.parquet: 94 rows (non-spatial)

PMTiles for Flood Results (Optional)

Generate vector PMTiles from the flood depth results for web map deployment.

Python
import shutil

has_tools = bool(shutil.which("tippecanoe") and shutil.which("pmtiles"))

if has_tools and gdf_wse is not None:
    from ras2cng import generate_pmtiles_from_input

    pmtiles_out = OUTPUT_DIR / "flood_wse.pmtiles"
    generate_pmtiles_from_input(
        wse_out,
        pmtiles_out,
        layer_name="flood_wse",
        min_zoom=8,
        max_zoom=14,
    )
    print(f"PMTiles: {pmtiles_out.name} ({pmtiles_out.stat().st_size / 1e6:.1f} MB)")
    print("\nDeploy to S3/R2/GitHub Pages for serverless flood maps.")
elif not has_tools:
    print("PMTiles CLIs not found. Install: conda install -c conda-forge tippecanoe pmtiles")
    print("\nCLI equivalent:")
    print(f"  ras2cng pmtiles {wse_out if gdf_wse is not None else 'results.parquet'} flood_wse.pmtiles --layer flood --min-zoom 8 --max-zoom 14")
else:
    print("No results available for PMTiles generation.")
Text Only
PMTiles CLIs not found. Install: conda install -c conda-forge tippecanoe pmtiles



CLI equivalent:
  ras2cng pmtiles out\961_cloud_native_results\maximum_wse.parquet flood_wse.pmtiles --layer flood --min-zoom 8 --max-zoom 14

Flood Depth Web Map with PMTiles

Style the flood depth PMTiles with a color ramp in MapLibre GL JS:

HTML
<script src="https://unpkg.com/maplibre-gl/dist/maplibre-gl.js"></script>
<script src="https://unpkg.com/pmtiles/dist/pmtiles.js"></script>
<script>
  let protocol = new pmtiles.Protocol();
  maplibregl.addProtocol("pmtiles", protocol.tile);

  const map = new maplibregl.Map({
    container: "map",
    style: {
      version: 8,
      sources: {
        flood: {
          type: "vector",
          url: "pmtiles://./flood_depth.pmtiles",
        },
      },
      layers: [
        {
          id: "flood-fill",
          source: "flood",
          "source-layer": "flood_depth",
          type: "fill",
          paint: {
            "fill-color": [
              "interpolate", ["linear"], ["get", "maximum_depth"],
              0, "#ffffcc",
              1, "#feb24c",
              3, "#f03b20",
              10, "#bd0026"
            ],
            "fill-opacity": 0.7,
          },
        },
      ],
    },
  });
</script>

Output Summary

Python
print("Output files:")
for f in sorted(OUTPUT_DIR.rglob("*")):
    if f.is_file():
        rel = f.relative_to(OUTPUT_DIR)
        print(f"  {str(rel):45s} {f.stat().st_size / 1e3:>8.1f} KB")
Text Only
Output files:
  archive\BaldEagleDamBrk.g01.parquet             2954.4 KB
  archive\BaldEagleDamBrk.g02.parquet             1307.9 KB
  archive\BaldEagleDamBrk.g03.parquet             1929.1 KB
  archive\BaldEagleDamBrk.g06.parquet              913.0 KB
  archive\BaldEagleDamBrk.g08.parquet             1073.6 KB
  archive\BaldEagleDamBrk.g09.parquet              889.6 KB
  archive\BaldEagleDamBrk.g10.parquet              504.6 KB
  archive\BaldEagleDamBrk.g11.parquet              343.4 KB
  archive\BaldEagleDamBrk.g12.parquet              280.1 KB
  archive\BaldEagleDamBrk.g13.parquet              781.0 KB
  archive\BaldEagleDamBrk.p13.parquet              512.3 KB
  archive\BaldEagleDamBrk.parquet                  101.4 KB
  archive\manifest.json                             19.5 KB
  maximum_wse.parquet                              157.6 KB
  mesh_cells.parquet                               133.8 KB

Key Takeaways

  1. Results join to geometry polygons — each mesh cell becomes a polygon with flood depth as an attribute
  2. DuckDB enables SQL analytics — aggregate by mesh area, filter deep cells, compute statistics
  3. GeoPandas .explore() gives instant flood maps — choropleth visualization in the notebook
  4. Full project archive creates a manifest-tracked GeoParquet bundle — one file per geometry, one per plan
  5. PMTiles enable serverless flood maps — deploy to static hosting, no tile server needed

CLI Quick Reference

Bash
# Full project archive (geometry + results + terrain)
ras2cng archive path/to/project/ ./archive/ --results --terrain

# Export results joined to polygon geometry
ras2cng results model.p01.hdf max_depth.parquet \
  --geometry mesh_cells.parquet --var "Maximum Depth"

# Query flood statistics
ras2cng query max_depth.parquet \
  "SELECT mesh_name, MAX(maximum_depth) FROM _ GROUP BY mesh_name"

# Generate flood depth PMTiles
ras2cng pmtiles max_depth.parquet flood.pmtiles --layer flood

Next Steps

  • ras2cng documentation — Complete API and CLI reference
  • ras2cng GitHub — Source code and issues
  • 960_cloud_native_geometry_export.ipynb — Geometry-only export (no HEC-RAS required)
CLB Engineering Corporation  ·  LLM Forward Engineering
RAS Commander Documentation is a free and open-source project maintained by CLB Engineering Corporation. For agencies and firms modernizing H&H workflows with LLM Forward approaches, contact CLB to partner with the engineers who wrote the automation.