Skip to content

chrislyonsKY/FaultLine

FaultLine Banner

FaultLine

Spatial Change Detection for Cloud‑Native Geospatial Data

License Build Rust GeoRust Cloud Native Geo Version Issues PRs


Overview

FaultLine is an open‑source engine for detecting, classifying, and validating spatial changes in cloud‑native geospatial datasets.

It is designed for modern geospatial infrastructure and supports formats such as:

  • GeoParquet
  • Cloud Optimized GeoTIFF (COG)
  • PMTiles
  • STAC catalogs

FaultLine brings version‑control style change detection to spatial data.


Features

  • Spatial dataset diffing
  • Geometry change detection
  • Dataset lineage analysis
  • Cloud‑optimization validation
  • Machine‑readable change manifests
  • Integration with cloud‑native geospatial pipelines

Installation

cargo install faultline

Example Usage

faultline diff parcels_v1.parquet parcels_v2.parquet

Validate cloud optimization:

faultline validate dataset.parquet

Architecture

FaultLine is built as a modular Rust workspace.

crates/
  faultline-core
  faultline-geometry
  faultline-diff
  faultline-sync

apps/
  faultline-cli

The project is built on the GeoRust ecosystem for geometry operations and spatial indexing.


Development

Requirements:

  • Rust toolchain
  • Cargo
  • VS Code + Rust Analyzer
  • GitHub Copilot (recommended)

Build the project:

cargo build

Run tests:

cargo test

Roadmap

Planned features include:

  • advanced spatial diff algorithms
  • topology change detection
  • cloud optimization validation rules
  • distributed dataset comparison
  • visualization tooling

Execution plan and acceptance criteria are tracked in:

  • docs/planned-features.md

Contributing

Contributions are welcome.

Please open an issue to discuss major changes before submitting a pull request.


License

This project is licensed under the MIT License.

About

FaultLine is a cloud-native geospatial change engine for comparing, validating, and tracking spatial dataset evolution across modern formats like GeoParquet, COG, and PMTiles.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages