pygmtsar

PyGMTSAR (Python InSAR): Powerful and Accessible Satellite Interferometry

https://github.com/alexeypechnikov/pygmtsar

Science Score: 49.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: researchgate.net, zenodo.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.0%) to scientific vocabulary

Keywords

earth-observation earth-science earthquake flooding insar natural-disasters python3 remote-sensing sbas-insar scientific-computing scientific-visualization sentinel-1
Last synced: 6 months ago · JSON representation

Repository

PyGMTSAR (Python InSAR): Powerful and Accessible Satellite Interferometry

Basic Info
  • Host: GitHub
  • Owner: AlexeyPechnikov
  • License: bsd-3-clause
  • Language: HTML
  • Default Branch: pygmtsar2
  • Homepage: http://insar.dev/
  • Size: 2.01 GB
Statistics
  • Stars: 530
  • Watchers: 22
  • Forks: 128
  • Open Issues: 81
  • Releases: 1
Topics
earth-observation earth-science earthquake flooding insar natural-disasters python3 remote-sensing sbas-insar scientific-computing scientific-visualization sentinel-1
Created over 4 years ago · Last pushed 7 months ago
Metadata Files
Readme Funding License Code of conduct Citation

README.md

View on GitHub Available on pypi Docker DOI Support on Patreon

Announcement: InSAR.devA 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 Sentinel1 MultiPolarization and MultiPath Interferograms (adopted for slow 2 vCPU free Google Colab).

Open In Colab InSAR.dev Sentinel1 MultiPolarization and MultiPath Interferograms on Google Colab Pro.

The InSAR.dev ecosystem comprises three Python packages. insardev_toolkit provides utility functions and helpers; insardev_pygmtsarhandles Sentinel1 SLC preprocessing (requires GMTSAR binaries); and insardev performs core interferometric processing and analysis with no external dependencies. Both insardev_toolkit and insardev_pygmtsar are BSDlicensed, 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

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, youll find more Jupyter notebook use cases on Patreon and updates on LinkedIn.

About PyGMTSAR

PyGMTSAR offers reproducible, high-performance Sentinel-1 interferometry accessible to everyonewhether 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 browserno 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 Trkiye 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 20142015 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 Geofsico, Escuela Politcnica Nacional (IG-EPN) (InSAR software unspecified).

Open In Colab IranIraq 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 S1AStackCPGF_T173.tar.gz, titled 'Sentinel-1 TOPS Time Series'.

The resulting InSAR velocity map is available as a self-contained web page at: ImperialValley2015.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, Trkiye (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 listcontact me if youd 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

Owner

  • Name: Alexey Pechnikov
  • Login: AlexeyPechnikov
  • Kind: user
  • Company: Independent Contractor

Founder & Developer, InSAR.dev & Geo3D.dev | Geoscience, CS & ML Expert, MSc. Radiophysics

GitHub Events

Total
  • Commit comment event: 4
  • Issues event: 82
  • Watch event: 87
  • Issue comment event: 244
  • Push event: 53
  • Fork event: 33
Last Year
  • Commit comment event: 4
  • Issues event: 82
  • Watch event: 87
  • Issue comment event: 244
  • Push event: 53
  • Fork event: 33

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 104
  • Total pull requests: 1
  • Average time to close issues: 5 days
  • Average time to close pull requests: about 5 hours
  • Total issue authors: 55
  • Total pull request authors: 1
  • Average comments per issue: 4.88
  • Average comments per pull request: 1.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 58
  • Pull requests: 0
  • Average time to close issues: 6 days
  • Average time to close pull requests: N/A
  • Issue authors: 35
  • Pull request authors: 0
  • Average comments per issue: 3.45
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • Sci123-lab (9)
  • jie666-6 (7)
  • georgeboldeanu (6)
  • Hassan2211345 (6)
  • SteffanDavies (6)
  • athifsayyaf (5)
  • kangahdesmond (5)
  • mhotalebi (4)
  • oguzhannysr (3)
  • Smitrgeo15 (3)
  • kjz1997 (3)
  • anaferreira97 (3)
  • teagamrs (3)
  • Aragon-yggdrasill (3)
  • mbahmu25 (3)
Pull Request Authors
  • williamjablonski (2)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 2
  • Total downloads:
    • pypi 3,040 last-month
  • Total docker downloads: 587
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 0
    (may contain duplicates)
  • Total versions: 118
  • Total maintainers: 1
pypi.org: pygmtsar

PyGMTSAR (Python GMTSAR): Powerful and Accessible Satellite Interferometry

  • Versions: 113
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 2,970 Last month
  • Docker Downloads: 587
Rankings
Docker downloads count: 2.0%
Stargazers count: 4.9%
Forks count: 6.0%
Dependent packages count: 7.3%
Downloads: 7.3%
Average: 11.4%
Dependent repos count: 40.8%
Maintainers (1)
mbg
Last synced: 6 months ago
pypi.org: insardev

InSAR.dev (Python InSAR): Satellite Interferometry Framework

  • Versions: 5
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 70 Last month
Rankings
Dependent packages count: 9.6%
Average: 31.8%
Dependent repos count: 54.0%
Maintainers (1)
mbg
Last synced: 6 months ago

Dependencies

.github/workflows/gmtsar.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
.github/workflows/macos.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
.github/workflows/pypi.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
.github/workflows/todo.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
.github/workflows/ubuntu.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • actions/upload-artifact v3 composite
pygmtsar/setup.py pypi
  • dask *
  • distributed *
  • geopandas *
  • importlib-metadata <=4.12.0
  • numpy *
  • pandas *
  • xarray >=0.19.0