geoparquet-validation

What problem does it solve?

GeoParquet datasets often fail spec expectations or perform poorly in query engines unless they are validated and optimized with consistent metadata, spatial ordering, and compression settings.

Core Features & Use Cases

• Inspect and audit GeoParquet metadata using a gpio-first workflow to quickly summarize dataset structure and characteristics.
• Validate and auto-fix GeoParquet issues with gpio check all, producing corrected outputs when needed.
• Optimize for distribution and query performance by applying zstd compression (level 15), Hilbert spatial sorting, bbox covering metadata, and appropriate row-group sizing, plus partitioning and STAC publishing for large datasets.
• Use DuckDB for advanced SQL transforms when the workflow requires custom query logic before final GeoParquet validation.

Quick Start

Use the geoparquet-validation skill to validate and fix an output dataset by running: gpio check all input.parquet --fix --output fixed.parquet