SkillAgentSearch skills...

Pygmtsar

PyGMTSAR (Python InSAR): Powerful and Accessible Satellite Interferometry

Install / Use

/learn @AlexeyPechnikov/Pygmtsar

README

View on GitHub Available on pypi Docker DOI Support on Patreon

Announcement: InSAR.dev—A Federated Python Ecosystem for InSAR

InSAR.dev is the next evolution of PyGMTSAR and is under active development. Whereas PyGMTSAR processes single-polarization scenes and bursts along one orbital path, InSAR.dev separates the workflow into two phases: preparing SLC data (including geocoding, flat-earth and topographic correction, and packaging into cloud-ready bursts) and then performing the core interferometric analysis on those datasets. This design scales to hundreds or thousands of bursts across multiple polarizations and orbital paths.

For example, the following interactive notebooks demonstrate processing of 8 Sentinel-1 scenes (~1000 bursts) across 2 orbital paths and 2 polarizations (VH, VV):

Open In Colab InSAR.dev Sentinel-1 SLC Burst Preprocessing.

Open In Colab InSAR.dev Sentinel‑1 Multi‑Polarization and Multi‑Path Interferograms (adopted for slow 2 vCPU free Google Colab).

Open In Colab InSAR.dev Sentinel‑1 Multi‑Polarization and Multi‑Path Interferograms on Google Colab Pro.

The InSAR.dev ecosystem comprises three Python packages. insardev_toolkit provides utility functions and helpers; insardev_pygmtsarhandles Sentinel‑1 SLC preprocessing (requires GMTSAR binaries); and insardev performs core interferometric processing and analysis with no external dependencies. Both insardev_toolkit and insardev_pygmtsar are BSD‑licensed, while insardev may require a subscription for certain use cases.

InSAR.dev documentation, use cases and project updates are available on Patreon.

PyGMTSAR (Python InSAR): Powerful, Accessible Satellite Interferometry

<img src="assets/logo.jpg" width="15%" />

PyGMTSAR (Python InSAR) is designed for both occasional users and experts working with Sentinel-1 satellite interferometry. It supports a wide range of features, including SBAS, PSI, PSI-SBAS, and more. In addition to the examples below, you’ll find more Jupyter notebook use cases on Patreon and updates on LinkedIn.

About PyGMTSAR

PyGMTSAR offers reproducible, high-performance Sentinel-1 interferometry accessible to everyone—whether you prefer Google Colab, cloud servers, or local processing. It automatically retrieves Sentinel-1 SLC scenes and bursts, DEMs, and orbits; computes interferograms and correlations; performs time-series analysis; and provides 3D visualization. This single library enables users to build a fully integrated InSAR project with minimal hassle. Whether you need a single interferogram or a multi-year analysis involving thousands of datasets, PyGMTSAR can handle the task efficiently, even on standard commodity hardware.

PyGMTSAR Live Examples on Google Colab

Google Colab is a free service that lets you run interactive notebooks directly in your browser—no powerful computer, extensive disk space, or special installations needed. You can even do InSAR processing from a smartphone. These notebooks automate every step: installing PyGMTSAR library and its dependencies on a Colab host (Ubuntu 22, Python 3.10), downloading Sentinel-1 SLCs, orbit files, SRTM DEM data (automatically converted to ellipsoidal heights via EGM96), land mask data, and then performing complete interferometry with final mapping. You can also modify scene or bursts names to analyze your own area of interest, and each notebook includes instant interactive 3D maps.

Open In Colab Central Türkiye Earthquakes (2023). The area is large, covering two consecutive Sentinel-1 scenes or a total of 56 bursts.

<img src="assets/turkie_2023a.jpg" width="40%" /><img src="assets/turkie_2023b.jpg" width="40%" />

Open In Colab Pico do Fogo Volcano Eruption, Fogo Island, Cape Verde (2014). The interferogram for this event is compared to the study The 2014–2015 eruption of Fogo volcano: Geodetic modeling of Sentinel-1 TOPS interferometry (Geophysical Research Letters, DOI: 10.1002/2015GL066003).

<img src="assets/pico_2014a.jpg" width="40%" /><img src="assets/pico_2014b.jpg" width="40%" />

Open In Colab La Cumbre Volcano Eruption, Ecuador (2020). The results compare with the report from Instituto Geofísico, Escuela Politécnica Nacional (IG-EPN) (InSAR software unspecified).

<img src="assets/la_cumbre_2020a.jpg" width="40%" /><img src="assets/la_cumbre_2020b.jpg" width="40%" />

Open In Colab Iran–Iraq Earthquake (2017). The event has been well investigated, and the results compared to outputs from GMTSAR, SNAP, and GAMMA software.

<img src="assets/iran_iraq_2017a.jpg" width="40%" /><img src="assets/iran_iraq_2017b.jpg" width="40%" />

Open In Colab Imperial Valley Subsidence, CA USA (2015). This example is provided in the GMTSAR project in the archive file S1A_Stack_CPGF_T173.tar.gz, titled 'Sentinel-1 TOPS Time Series'.

The resulting InSAR velocity map is available as a self-contained web page at: Imperial_Valley_2015.html

<img src="assets/imperial_valley_2015a.jpg" width="40%" /> <img src="assets/imperial_valley_2015b.jpg" width="40%" />

Open In Colab Kalkarindji Flooding, NT Australia (2024). Correlation loss serves to identify flooded areas.

<img src="assets/kalkarindji_2024.jpg" width="80%" />

Open In Colab Golden Valley Subsidence, CA USA (2021). This example demonstrates the case study 'Antelope Valley Freeway in Santa Clarita, CA,' as detailed in SAR Technical Series Part 4 Sentinel-1 global velocity layer: Using global InSAR at scale and Sentinel-1 Technical Series Part 5 Targeted Analysis with a significant subsidence rate 'exceeding 5cm/year in places'.

<img src="assets/golden_valley_2021.jpg" width="80%" />

Open In Colab Lake Sarez Landslides, Tajikistan (2017). The example reproduces the findings shared in the following paper: Integration of satellite SAR and optical acquisitions for the characterization of the Lake Sarez landslides in Tajikistan.

<img src="assets/lake_sarez_2017.jpg" width="80%" />

Open In Colab Erzincan Elevation, Türkiye (2019). This example reproduces 29-page ESA document DEM generation with Sentinel-1 IW.

<img src="assets/erzincan_2019.jpg" width="80%" />

More PyGMTSAR Live Examples on Google Colab

Open In Colab Mexico City Subsidence, Mexico (2016). This example replicates the 29-page ESA manual TRAINING KIT – HAZA03. LAND SUBSIDENCE WITH SENTINEL-1 using SNAP.

PyGMTSAR Live Examples on Google Colab Pro

I share additional InSAR projects on Google Colab Pro through my Patreon page. These are ideal for InSAR learners, researchers, and industry professionals tackling challenging projects with large areas, big stacks of interferograms, lo

View on GitHub
GitHub Stars571
CategoryDevelopment
Updated2d ago
Forks136

Languages

HTML

Security Score

100/100

Audited on Apr 3, 2026

No findings