Expand description
Core library for GeoParquet multi-resolution overviews and PMTiles export.
The product pipeline lives in overview: convert a (gpio-sorted)
GeoParquet file into a level-banded overview GeoParquet file
(overview::convert), validate it against the spec
(overview::check), and export it to a PMTiles vector-tile archive
(overview::export).
The remaining top-level modules are shared infrastructure the overview
pipeline builds on: Arrow/Parquet geometry decoding (batch_processor,
wkb, covering), tile math (tile, world_coord), geometry
clipping (clip, ioverlay_clip, sutherland_hodgman), MVT
encoding (mvt), and the PMTiles v3 writer (pmtiles_writer,
compression, dedup).
The legacy per-tile pipeline (pipeline, Converter) was removed in
favor of the overview pipeline; see context/ARCHITECTURE.md for the
decision record. The one-shot GeoParquet → PMTiles UX survives as the
CLI tiles facade, which chains overview convert → export-pmtiles
through a temporary file.
§Memory Profiling
Build with --features dhat-heap to enable heap profiling with dhat.
When enabled, the program will write dhat-heap.json on exit which can
be analyzed at https://nnethercote.github.io/dh_view/dh_view.html
Re-exports§
pub use compression::Compression;pub use pmtiles_writer::StreamingPmtilesWriter;pub use pmtiles_writer::StreamingWriteStats;pub use quality::extract_crs;pub use quality::validate_wgs84;pub use quality::CrsInfo;
Modules§
- batch_
processor - Arrow-native geometry batch decoding.
- clip
- Geometry clipping to tile bounds.
- compression
- Compression support for PMTiles v3.
- covering
- GeoParquet covering metadata extraction for row group filtering.
- decode
- PMTiles → GeoParquet decoding (issue #112).
- dedup
- Tile deduplication for PMTiles.
- fs_
probe - Best-effort detection of RAM-backed (tmpfs/ramfs) directories.
- input
- Input-source abstraction: local files or remote objects (issue #210).
- input_
set - Multi-partition conversion input:
ConvertSource(v0.7). - ioverlay_
clip - i_overlay-based polygon clipping for robust tile boundary clipping.
- mvt
- MVT (Mapbox Vector Tile) encoding module.
- overview
- GeoParquet multi-resolution overviews (COG-style vector overviews) — the product pipeline of this crate.
- pmtiles_
writer - PMTiles v3 writer implementation.
- pyramid
- Multi-band pyramids: several inputs, each owning a zoom range, one archive.
- quality
- GeoParquet CRS extraction and WGS84 validation.
- sutherland_
hodgman - Sutherland-Hodgman polygon clipping for axis-aligned rectangles.
- tile
- Tile coordinate math and utilities
- vector_
tile - wkb
- WKB serialization utilities for temporary file storage.
- world_
coord - Integer world coordinate system for tippecanoe parity.
Enums§
- Error
- Errors that can occur while reading GeoParquet or writing PMTiles.