Skip to main content

View on GitHub Available on pypi Docker DOI Support on Patreon ChatGPT Assistant

PyGMTSAR (Python InSAR): Powerful, Accessible Satellite Interferometry

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.

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).

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).

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.

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

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

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'.

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.

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

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, low-coherence regions, or significant atmospheric delays. You can run these privately shared notebooks online with Colab Pro or locally/on remote servers.

Projects and Publications Using PyGMTSAR

See the Projects and Publications page for real-world projects and academic research applying PyGMTSAR. This is not an exhaustive list—contact me if you’d like your project or publication included.

Resources

PyGMTSAR projects and e-books Available on Patreon. Preview versions can be found in this GitHub repo:

Video Lessons and Notebooks Find PyGMTSAR (Python InSAR) video lessons and educational notebooks on Patreon and YouTube.

PyGMTSAR AI Assistant The PyGMTSAR AI Assistant, powered by OpenAI ChatGPT, can explain InSAR theory, guide you through examples, help build an InSAR processing pipeline, and troubleshoot.

PyGMTSAR AI Assistant

PyGMTSAR on DockerHub Run InSAR processing on macOS, Linux, or Windows via Docker images.

PyGMTSAR on PyPI Install the library from PyPI.

PyGMTSAR Previous Versions 2023 releases are still on GitHub, PyPI, DockerHub, and Google Colab. Compare PyGMTSAR InSAR with other software by checking out the PyGMTSAR 2023 Repository.

© Alexey Pechnikov, 2025

Metadata

Release files for pygmtsar 2025.4.8.post1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pygmtsar 2025.4.8.post1
File Size Uploaded
pygmtsar-2025.4.8.post1.tar.gz 10.8 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for pygmtsar 2025.4.8.post1
File Interpreter ABI Platform
pygmtsar-2025.4.8.post1-py3-none-any.whl Python 3 none any Details

Total release size: 21.6 MB

Release files / pygmtsar-2025.4.8.post1.tar.gz

Download URL pygmtsar-2025.4.8.post1.tar.gz
Size 10.8 MB
Tags Source
SHA-256 checksum
How to use checksums
cf946afed2c03cd70ab1442ffa4ebd0dc41dcc3e82b311b9ee493476c39961a1
BLAKE2b-256 checksum
How to use checksums
bf51922a6b0e13481c459f8fd1fa58b0836d8f85c470508ff0b2baf8fe864f5f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.2

Release files / pygmtsar-2025.4.8.post1-py3-none-any.whl

Download URL pygmtsar-2025.4.8.post1-py3-none-any.whl
Size 10.8 MB
Tags Python 3
SHA-256 checksum
How to use checksums
e42bb0bbfec06acce01ee2cdbda9e5dd7e0583245499af07a1a0df6a46780e16
BLAKE2b-256 checksum
How to use checksums
b53923bdae6cfea7a96037dd17c89f1ed53fd913893bd609dad7358831db3636
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.2

Release history Release notifications | RSS feed

This release

2025.4.8.post1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page