ras2cng 0.1.0__tar.gz

ras2cng-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,38 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - "docs/**"
+      - "ras2cng/**"
+      - "mkdocs.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # needed for git-revision-date-localized
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install docs dependencies
+        run: |
+          pip install -r docs/requirements-docs.txt
+          pip install -e .
+
+      - name: Deploy to GitHub Pages
+        run: mkdocs gh-deploy --force

ras2cng-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+.env
+.pytest_cache/
+outputs/
+out/
+agent_tasks/
+*.parquet
+*.pmtiles
+site/

ras2cng-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

ras2cng-0.1.0/.readthedocs.yaml

@@ -0,0 +1,15 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+
+mkdocs:
+  configuration: mkdocs.yml
+
+python:
+  install:
+    - requirements: docs/requirements-docs.txt
+    - method: pip
+      path: .

ras2cng-0.1.0/CLAUDE.md

@@ -0,0 +1,55 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+**ras2cng** (RAS to Cloud Native GIS) — CLI tool for exporting HEC-RAS geometry and results to GeoParquet, querying with DuckDB, generating PMTiles vector/raster tiles, and syncing to PostGIS. Built on [`ras-commander`](https://github.com/gpt-cmdr/ras-commander) for HEC-RAS file parsing.
+
+## Build & Development Commands
+
+```bash
+# Install with all optional dependencies (creates/updates .venv and uv.lock)
+uv sync --all-extras
+
+# Run tests
+uv run pytest
+
+# Run a single test
+uv run pytest tests/test_geometry_detection.py -v
+
+# Run the CLI
+uv run ras2cng --help
+
+# Build distributable wheel
+uv build
+
+# Add a runtime dependency
+uv add somepackage
+
+# Add a dev-only dependency
+uv add --dev somepackage
+```
+
+Python >= 3.10 required (`.python-version` pins 3.12). Virtual environment is managed by uv in `.venv/`.
+
+## Architecture
+
+**CLI layer** (`cli.py`): Typer app with 5 commands (`geometry`, `results`, `query`, `pmtiles`, `sync`). Uses lazy imports — heavy dependencies are imported inside command functions, not at module level.
+
+**Core modules** — each handles one concern:
+- `geometry.py` — Detects file type (HDF `.g??.hdf` vs text `.g??`) and routes to the appropriate ras-commander parser (`HdfMesh`, `HdfXsec`, `GeomParser`). Falls back from mesh cell polygons to points if polygons unavailable.
+- `results.py` — Exports 2D mesh summary variables from plan HDF files. When results are points and a polygon geometry file is provided, joins results onto polygons via `mesh_name`/`cell_id` merge.
+- `duckdb_session.py` — `DuckSession` class wraps DuckDB with auto-loaded spatial extension. `register_parquet()` detects WKB geometry columns and converts them to DuckDB GEOMETRY type. The table alias is always `_`.
+- `pmtiles.py` — Dispatches between vector (GeoParquet → GeoJSON → tippecanoe → PMTiles) and raster (GeoTIFF → gdal_translate → pmtiles) pipelines. Requires external CLIs: `tippecanoe`, `gdal_translate`, `pmtiles`.
+- `postgis_sync.py` — GeoParquet → PostGIS via SQLAlchemy/GeoAlchemy2 with automatic spatial index creation.
+
+**Data flow**: HEC-RAS files → ras-commander → GeoDataFrame → GeoParquet (snappy compression). All output uses `to_parquet(..., compression="snappy", index=False)`.
+
+## Key Conventions
+
+- ras-commander normalizes column names to **snake_case** (e.g., "Maximum Depth" → `maximum_depth`)
+- DuckDB queries use `_` as the table name placeholder
+- Geometry layers: `mesh_cells`, `cross_sections`, `centerlines`
+- File type detection is suffix-based: `.g01.hdf` = HDF geometry, `.g01` = text geometry, `.p01.hdf` = plan results
+- Tests mock ras-commander calls since actual HEC-RAS model files are not in the repo

ras2cng-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 William M. Katzenmeyer, P.E., C.F.M. / CLB Engineering
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ras2cng-0.1.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: ras2cng
+Version: 0.1.0
+Summary: CLI for exporting HEC-RAS geometry/results to cloud-native GIS formats (GeoParquet, PMTiles, DuckDB, PostGIS)
+Project-URL: Homepage, https://github.com/gpt-cmdr/ras2cng
+Project-URL: Repository, https://github.com/gpt-cmdr/ras2cng
+Project-URL: Documentation, https://gpt-cmdr.github.io/ras2cng/
+Project-URL: Bug Tracker, https://github.com/gpt-cmdr/ras2cng/issues
+Author-email: "William M. Katzenmeyer, P.E., C.F.M." <bill@clbengineering.com>
+License: MIT License
+        
+        Copyright (c) 2024 William M. Katzenmeyer, P.E., C.F.M. / CLB Engineering
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: cloud-native-gis,duckdb,flood-modeling,geoparquet,geospatial,hec-ras,hydraulics,pmtiles,postgis,ras-commander
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Hydrology
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: geopandas>=0.14.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: pyarrow>=14.0.0
+Requires-Dist: ras-commander>=0.89.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: all
+Requires-Dist: duckdb>=1.0.0; extra == 'all'
+Requires-Dist: geoalchemy2>=0.14.0; extra == 'all'
+Requires-Dist: psycopg2-binary>=2.9.0; extra == 'all'
+Requires-Dist: rasterio>=1.3.0; extra == 'all'
+Requires-Dist: sqlalchemy>=2.0.0; extra == 'all'
+Provides-Extra: duckdb
+Requires-Dist: duckdb>=1.0.0; extra == 'duckdb'
+Provides-Extra: pmtiles
+Requires-Dist: rasterio>=1.3.0; extra == 'pmtiles'
+Provides-Extra: postgis
+Requires-Dist: geoalchemy2>=0.14.0; extra == 'postgis'
+Requires-Dist: psycopg2-binary>=2.9.0; extra == 'postgis'
+Requires-Dist: sqlalchemy>=2.0.0; extra == 'postgis'
+Description-Content-Type: text/markdown
+
+# ras2cng — RAS to Cloud Native GIS
+
+[![PyPI version](https://badge.fury.io/py/ras2cng.svg)](https://badge.fury.io/py/ras2cng)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+CLI tool for exporting HEC-RAS **geometry** and **results** to cloud-native GIS formats:
+**GeoParquet**, **DuckDB**, **PMTiles**, and **PostGIS**.
+
+Built on [`ras-commander`](https://github.com/gpt-cmdr/ras-commander) for HEC-RAS file parsing.
+
+## Installation
+
+```bash
+# Core (geometry + results export)
+pip install ras2cng
+
+# All optional extras (DuckDB analytics, PostGIS sync, PMTiles rasterio)
+pip install "ras2cng[all]"
+
+# Individual extras
+pip install "ras2cng[duckdb]"    # DuckDB SQL analytics
+pip install "ras2cng[postgis]"   # PostGIS sync
+pip install "ras2cng[pmtiles]"   # rasterio (PMTiles also needs tippecanoe + pmtiles CLIs)
+```
+
+## Quick Start
+
+```bash
+# Export mesh cell geometry from HDF
+ras2cng geometry model.g01.hdf mesh_cells.parquet --layer mesh_cells
+
+# Export max depth results joined to polygon geometry
+ras2cng results model.p01.hdf max_depth.parquet \
+  --geometry mesh_cells.parquet --var "Maximum Depth"
+
+# Query with DuckDB (use _ as table name)
+ras2cng query max_depth.parquet \
+  "SELECT mesh_name, AVG(maximum_depth) FROM _ GROUP BY mesh_name"
+
+# Generate PMTiles (requires tippecanoe + pmtiles on PATH)
+ras2cng pmtiles max_depth.parquet flood_depth.pmtiles --layer flood --min-zoom 8 --max-zoom 14
+
+# Sync to PostGIS
+ras2cng sync max_depth.parquet "postgresql://user:pass@host/db" max_depth --schema hydraulics
+```
+
+## Python API
+
+```python
+from ras2cng import (
+    export_geometry_layers,
+    export_results_layer,
+    export_all_variables,
+    DuckSession,
+    query_parquet,
+    generate_pmtiles_from_input,
+    sync_to_postgres,
+)
+from pathlib import Path
+
+# Export geometry
+export_geometry_layers(Path("model.g01.hdf"), Path("mesh_cells.parquet"), layer="mesh_cells")
+
+# Export results joined to polygon geometry
+export_results_layer(
+    plan_hdf=Path("model.p01.hdf"),
+    output=Path("max_depth.parquet"),
+    variable="Maximum Depth",
+    geom_file=Path("mesh_cells.parquet"),
+)
+
+# DuckDB query (table alias is always _)
+df = query_parquet(Path("max_depth.parquet"), "SELECT * FROM _ WHERE maximum_depth > 3.0")
+
+# Advanced DuckDB session with spatial
+with DuckSession() as duck:
+    duck.register_parquet("max_depth.parquet")
+    df = duck.query("SELECT mesh_name, MAX(maximum_depth) FROM _ GROUP BY mesh_name")
+```
+
+## Extractable Data
+
+### Geometry Layers
+
+| Layer | Geometry | Source |
+|---|---|---|
+| `mesh_cells` | Polygon (Point fallback) | HDF geometry only (`*.g??.hdf`) |
+| `cross_sections` | LineString | HDF geometry + text geometry (`*.g??`) |
+| `centerlines` | LineString | HDF geometry + text geometry |
+
+### Results Variables
+
+Exported from plan HDF files (`*.p??.hdf`). Common 2D mesh summary variables:
+
+- `Maximum Depth` → `maximum_depth`
+- `Maximum Water Surface` → `maximum_water_surface`
+- `Maximum Velocity` → `maximum_velocity`
+
+Column names are **snake_case** (ras-commander normalization). Use `--all` to export every available variable.
+
+### Output Formats
+
+| Format | Command | Requirements |
+|---|---|---|
+| GeoParquet | `geometry`, `results` | Built-in |
+| DuckDB SQL | `query` | `pip install "ras2cng[duckdb]"` |
+| Vector PMTiles | `pmtiles` | tippecanoe + pmtiles CLIs |
+| Raster PMTiles | `pmtiles` | gdal_translate + pmtiles CLIs |
+| PostGIS | `sync` | `pip install "ras2cng[postgis]"` |
+
+## External CLIs for PMTiles
+
+```bash
+# via conda-forge
+conda install -c conda-forge tippecanoe pmtiles
+```
+
+Or download from [felt/tippecanoe](https://github.com/felt/tippecanoe/releases) and [protomaps/go-pmtiles](https://github.com/protomaps/go-pmtiles/releases).
+
+## Documentation
+
+Full documentation: [https://gpt-cmdr.github.io/ras2cng/](https://gpt-cmdr.github.io/ras2cng/)
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

ras2cng-0.1.0/README.md

@@ -0,0 +1,127 @@
+# ras2cng — RAS to Cloud Native GIS
+
+[![PyPI version](https://badge.fury.io/py/ras2cng.svg)](https://badge.fury.io/py/ras2cng)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+CLI tool for exporting HEC-RAS **geometry** and **results** to cloud-native GIS formats:
+**GeoParquet**, **DuckDB**, **PMTiles**, and **PostGIS**.
+
+Built on [`ras-commander`](https://github.com/gpt-cmdr/ras-commander) for HEC-RAS file parsing.
+
+## Installation
+
+```bash
+# Core (geometry + results export)
+pip install ras2cng
+
+# All optional extras (DuckDB analytics, PostGIS sync, PMTiles rasterio)
+pip install "ras2cng[all]"
+
+# Individual extras
+pip install "ras2cng[duckdb]"    # DuckDB SQL analytics
+pip install "ras2cng[postgis]"   # PostGIS sync
+pip install "ras2cng[pmtiles]"   # rasterio (PMTiles also needs tippecanoe + pmtiles CLIs)
+```
+
+## Quick Start
+
+```bash
+# Export mesh cell geometry from HDF
+ras2cng geometry model.g01.hdf mesh_cells.parquet --layer mesh_cells
+
+# Export max depth results joined to polygon geometry
+ras2cng results model.p01.hdf max_depth.parquet \
+  --geometry mesh_cells.parquet --var "Maximum Depth"
+
+# Query with DuckDB (use _ as table name)
+ras2cng query max_depth.parquet \
+  "SELECT mesh_name, AVG(maximum_depth) FROM _ GROUP BY mesh_name"
+
+# Generate PMTiles (requires tippecanoe + pmtiles on PATH)
+ras2cng pmtiles max_depth.parquet flood_depth.pmtiles --layer flood --min-zoom 8 --max-zoom 14
+
+# Sync to PostGIS
+ras2cng sync max_depth.parquet "postgresql://user:pass@host/db" max_depth --schema hydraulics
+```
+
+## Python API
+
+```python
+from ras2cng import (
+    export_geometry_layers,
+    export_results_layer,
+    export_all_variables,
+    DuckSession,
+    query_parquet,
+    generate_pmtiles_from_input,
+    sync_to_postgres,
+)
+from pathlib import Path
+
+# Export geometry
+export_geometry_layers(Path("model.g01.hdf"), Path("mesh_cells.parquet"), layer="mesh_cells")
+
+# Export results joined to polygon geometry
+export_results_layer(
+    plan_hdf=Path("model.p01.hdf"),
+    output=Path("max_depth.parquet"),
+    variable="Maximum Depth",
+    geom_file=Path("mesh_cells.parquet"),
+)
+
+# DuckDB query (table alias is always _)
+df = query_parquet(Path("max_depth.parquet"), "SELECT * FROM _ WHERE maximum_depth > 3.0")
+
+# Advanced DuckDB session with spatial
+with DuckSession() as duck:
+    duck.register_parquet("max_depth.parquet")
+    df = duck.query("SELECT mesh_name, MAX(maximum_depth) FROM _ GROUP BY mesh_name")
+```
+
+## Extractable Data
+
+### Geometry Layers
+
+| Layer | Geometry | Source |
+|---|---|---|
+| `mesh_cells` | Polygon (Point fallback) | HDF geometry only (`*.g??.hdf`) |
+| `cross_sections` | LineString | HDF geometry + text geometry (`*.g??`) |
+| `centerlines` | LineString | HDF geometry + text geometry |
+
+### Results Variables
+
+Exported from plan HDF files (`*.p??.hdf`). Common 2D mesh summary variables:
+
+- `Maximum Depth` → `maximum_depth`
+- `Maximum Water Surface` → `maximum_water_surface`
+- `Maximum Velocity` → `maximum_velocity`
+
+Column names are **snake_case** (ras-commander normalization). Use `--all` to export every available variable.
+
+### Output Formats
+
+| Format | Command | Requirements |
+|---|---|---|
+| GeoParquet | `geometry`, `results` | Built-in |
+| DuckDB SQL | `query` | `pip install "ras2cng[duckdb]"` |
+| Vector PMTiles | `pmtiles` | tippecanoe + pmtiles CLIs |
+| Raster PMTiles | `pmtiles` | gdal_translate + pmtiles CLIs |
+| PostGIS | `sync` | `pip install "ras2cng[postgis]"` |
+
+## External CLIs for PMTiles
+
+```bash
+# via conda-forge
+conda install -c conda-forge tippecanoe pmtiles
+```
+
+Or download from [felt/tippecanoe](https://github.com/felt/tippecanoe/releases) and [protomaps/go-pmtiles](https://github.com/protomaps/go-pmtiles/releases).
+
+## Documentation
+
+Full documentation: [https://gpt-cmdr.github.io/ras2cng/](https://gpt-cmdr.github.io/ras2cng/)
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

ras2cng-0.1.0/docs/about/acknowledgments.md

@@ -0,0 +1,28 @@
+# Acknowledgments
+
+## ras-commander
+
+ras2cng is built on top of [ras-commander](https://github.com/gpt-cmdr/ras-commander), the
+Python library for HEC-RAS automation and data extraction. ras-commander handles all the
+complexity of HEC-RAS HDF file parsing, text geometry parsing, and result extraction.
+
+## Cloud-Native Geospatial Stack
+
+ras2cng uses several excellent open-source projects in its pipeline:
+
+- [Apache Parquet / PyArrow](https://arrow.apache.org/) — columnar storage format
+- [GeoParquet](https://geoparquet.org/) — geospatial extension to Parquet
+- [DuckDB](https://duckdb.org/) — in-process analytical SQL engine
+- [PMTiles / Protomaps](https://protomaps.com/) — serverless tile archive format
+- [tippecanoe](https://github.com/felt/tippecanoe) — vector tile generation
+- [PostGIS](https://postgis.net/) — spatial extension for PostgreSQL
+- [GeoPandas](https://geopandas.org/) — geospatial DataFrames for Python
+- [Marimo](https://marimo.io/) — reactive Python notebooks
+
+## CLB Engineering
+
+ras2cng is developed and maintained by [CLB Engineering](https://clbengineering.com), a water
+resources engineering firm specializing in flood modeling, hydraulic analysis, and cloud-native
+geospatial tooling.
+
+**William M. Katzenmeyer, P.E., C.F.M.** — primary developer

ras2cng-0.1.0/docs/about/cloud-native-gis.md

@@ -0,0 +1,45 @@
+# Cloud-Native GIS Philosophy
+
+## The Traditional Geospatial Tax
+
+Traditional GIS workflows impose significant overhead on hydraulic model delivery:
+
+- Results must be exported to Shapefile or File GDB
+- A GIS analyst must symbolize, project, and publish to a map server
+- Users need licensed GIS software to view or query results
+- Every analysis requires loading the full dataset into memory
+
+## Cloud-Native Formats Break This Pattern
+
+Cloud-native geospatial formats were designed for the web and cloud environments from the ground up:
+
+**GeoParquet** stores geometry alongside attributes in Apache Parquet's columnar format. Reading
+10 columns out of 50 reads only those columns from disk — not the full row. Snappy compression
+achieves 5–10x size reduction versus Shapefiles. The Arrow memory layout enables zero-copy
+transfer into pandas, DuckDB, and other analytical engines.
+
+**PMTiles** is a single archive file containing all zoom levels of a tile pyramid. HTTP range
+requests fetch only the tiles needed for the current viewport. No tile server process needs to
+run — serve directly from S3, Cloudflare R2, or a CDN. A flood model result that previously
+required a $500/month tile server can be served for pennies.
+
+**DuckDB** is an in-process analytical SQL engine that reads GeoParquet files directly with its
+spatial extension. Complex queries across millions of mesh cells run in seconds on a laptop.
+No server to provision, no connection pool to manage, no network latency.
+
+## Why This Matters for Flood Modeling
+
+Flood model results are uniquely suited to the cloud-native stack:
+
+1. **Large**: 2D mesh models have 100k–10M cells. Columnar formats make per-column reads fast.
+2. **Spatial**: Every result is geometry. PMTiles serves flood extents at web speed.
+3. **Queryable**: "Show all cells where depth > 2 ft" is a trivial SQL filter on GeoParquet.
+4. **Shareable**: A single `.pmtiles` file on S3 can be embedded in any web map, shared via URL,
+   or downloaded without special software.
+
+## The ras2cng Philosophy
+
+ras2cng is the bridge between HEC-RAS simulation outputs and the cloud-native geospatial stack.
+It handles the parsing complexity of HEC-RAS HDF files (via ras-commander) and produces
+standards-compliant GeoParquet that works everywhere — QGIS, DuckDB, MapLibre, PostGIS,
+Observable, R, JavaScript.

ras2cng-0.1.0/docs/api/cli.md

@@ -0,0 +1,98 @@
+# CLI Reference
+
+## ras2cng --help
+
+```
+Usage: ras2cng [OPTIONS] COMMAND [ARGS]...
+
+  Export HEC-RAS geometry/results to GeoParquet; query with DuckDB; generate
+  PMTiles; sync to PostGIS.
+
+Commands:
+  geometry  Export HEC-RAS geometry to GeoParquet.
+  results   Export HEC-RAS 2D mesh summary results to GeoParquet.
+  query     Query GeoParquet files using DuckDB SQL.
+  pmtiles   Generate PMTiles from GeoParquet (vector) or GeoTIFF (raster).
+  sync      Sync GeoParquet data to PostGIS.
+```
+
+## ras2cng geometry
+
+```
+Usage: ras2cng geometry [OPTIONS] GEOM_FILE OUTPUT
+
+  Export HEC-RAS geometry to GeoParquet.
+
+Arguments:
+  GEOM_FILE  HEC-RAS geometry file (*.g??) or geometry HDF (*.g??.hdf)
+  OUTPUT     Output GeoParquet file path
+
+Options:
+  -l, --layer TEXT  Geometry layer: mesh_cells, cross_sections, centerlines
+```
+
+## ras2cng results
+
+```
+Usage: ras2cng results [OPTIONS] PLAN_HDF OUTPUT
+
+  Export HEC-RAS 2D mesh summary results to GeoParquet.
+
+Arguments:
+  PLAN_HDF  HEC-RAS plan HDF file (*.p??.hdf)
+  OUTPUT    Output GeoParquet path (or directory when using --all)
+
+Options:
+  -g, --geometry PATH   Geometry GeoParquet for spatial join
+  -v, --var TEXT        Result variable to export  [default: Maximum Depth]
+  --all                 Export all available summary variables to the output directory
+```
+
+## ras2cng query
+
+```
+Usage: ras2cng query [OPTIONS] INPUT_FILE SQL
+
+  Query GeoParquet files using DuckDB SQL.
+
+Arguments:
+  INPUT_FILE  Input GeoParquet file
+  SQL         SQL query (use _ as table name)
+
+Options:
+  -o, --output PATH  Optional output file (CSV or Parquet)
+```
+
+## ras2cng pmtiles
+
+```
+Usage: ras2cng pmtiles [OPTIONS] INPUT_FILE OUTPUT
+
+  Generate PMTiles from GeoParquet (vector) or GeoTIFF (raster).
+
+Arguments:
+  INPUT_FILE  Input GeoParquet file or GeoTIFF
+  OUTPUT      Output PMTiles file path
+
+Options:
+  -l, --layer TEXT    Vector tile layer name  [default: layer]
+  --min-zoom INTEGER  Minimum zoom
+  --max-zoom INTEGER  Maximum zoom
+```
+
+## ras2cng sync
+
+```
+Usage: ras2cng sync [OPTIONS] INPUT_FILE POSTGRES_URI TABLE_NAME
+
+  Sync GeoParquet data to PostGIS.
+
+Arguments:
+  INPUT_FILE    Input GeoParquet file
+  POSTGRES_URI  PostgreSQL connection URI
+  TABLE_NAME    Target table name
+
+Options:
+  -s, --schema TEXT    Target schema  [default: public]
+  --if-exists TEXT     replace|append|fail  [default: replace]
+```

ras2cng-0.1.0/docs/api/duckdb_session.md

@@ -0,0 +1,3 @@
+# ras2cng.duckdb_session
+
+::: ras2cng.duckdb_session

ras2cng-0.1.0/docs/api/geometry.md

@@ -0,0 +1,3 @@
+# ras2cng.geometry
+
+::: ras2cng.geometry