RRINGG — Referencing InSAR with GPS/GNSS data

RRINGG corrects InSAR velocity fields and references InSAR displacement time series to a global geodetic datum using GNSS ground-truth data. It fits a bilinear bias plane to InSAR–GNSS differences at co-located stations and subtracts it from the raster, removing long-wavelength artefacts such as orbital ramps and reference-frame offsets.

Developed at ISTerre (Université Grenoble Alpes / CNRS) as part of the Geo-INQUIRE project (EU Horizon 2020, grant 101058518).

---

Getting started

New user? Follow this path:

1. Installation — set up the conda environment (≈ 5 min)

2. Quick Start — run the three worked examples on sample data

3. Running RRINGG — CLI reference for your own data

Already installed? Jump to:

• Input Data — input format specifications

• Configuration — tuning default parameters

• Principles of RRINGG — mathematical and algorithmic details

• Troubleshooting — common errors and fixes

---

Usage

• Installation
  • Prerequisites
  • Installation method — editable clone (required)
  • Windows — preliminary setup
  • Updating RRINGG
  • Modifying default parameters
  • Running RRINGG after installation
• Input Data
  • Overview
  • Part I — InSAR Input Data
  • Part II — GNSS Input Data
• Running RRINGG
  • Overview
  • Preprocessing — EPOS TCS CSV data
  • Command syntax
  • Command-line arguments
  • Example workflows
  • Notes and best practices
• Quick Start
  • Overview
  • Example Data
  • Case 1 — EPOS TCS CSV input, NGL GNSS
  • Case 2 — GeoTIFF input, EPOS GNSS
  • Case 3 — EPOS TCS CSV input, local GNSS file
  • Outputs
  • Comparing with Reference Outputs
• Output Files
  • Overview
  • Correction mode
  • Referencing mode
  • Interpreting the quality metrics
  • Guidance by situation

Reference

• Configuration
  • How to change the defaults
  • Design rationale
  • Physical Constants
  • IOConfig — I/O directories
  • FittingConfig — plane-fitting parameters
  • GNSSConfig — data source and station selection
  • SpatialConfig — bounding box and distribution analysis
  • ProcessingConfig — top-level container
• Principles of RRINGG
  • Overview
  • Part I — Correction of the InSAR velocity field
  • Part II — Referencing of InSAR time series
  • Part III — Station weighting
  • Part IV — Plane fitting algorithms
  • Part V — Spatial distribution and Kriging fallback
• Project Structure
  • Top-level Directories
  • Source Packages
  • Configuration and Metadata Files
• Release Notes
  • 0.4.0 (2026-04-26) — API cleanup, unit fixes, and footprint improvements
  • 0.3.0 (2026-04-18) — Robustness, weighting, and output quality
  • 0.2.0 (2025-04-17) — Modular architecture refactoring
  • 0.0.1 (2024-01-13) — Initial release

Help

• Troubleshooting
• About RRINGG
• Automating Publication on Zenodo

Indices and tables

• Search Page