[](https://github.com/AlexeyPechnikov/pygmtsar)
[](https://pypi.python.org/pypi/pygmtsar/)
[](https://hub.docker.com/r/pechnikov/pygmtsar)
[](https://zenodo.org/badge/latestdoi/398018212)
[](https://www.patreon.com/pechnikov)
[](https://insar.dev/ai)
## 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](https://www.patreon.com/pechnikov) and updates on [LinkedIn](https://www.linkedin.com/in/alexey-pechnikov/).
## 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.
[](https://colab.research.google.com/drive/1TARVTB7z8goZyEVDRWyTAKJpyuqZxzW2?usp=sharing) **CENTRAL Türkiye Mw 7.8 & 7.5 Earthquakes Co-Seismic Interferogram (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%" />
[](https://colab.research.google.com/drive/1dDFG8BoF4WfB6tOF5sAi5mjdBKRbhxHo?usp=sharing) **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](https://doi.org/10.1002/2015GL066003)).
<img src="assets/pico_2014a.jpg" width="40%" /><img src="assets/pico_2014b.jpg" width="40%" />
[](https://colab.research.google.com/drive/1d9RcqBmWIKQDEwJYo8Dh6M4tMjJtvseC?usp=sharing) **La Cumbre Volcano Eruption Interferogram (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%" />
[](https://colab.research.google.com/drive/1shNGvUlUiXeyV7IcTmDbWaEM6XrB0014?usp=sharing) **Iran–Iraq Earthquake Co-Seismic Interferogram (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%" />
[](https://colab.research.google.com/drive/1h4XxJZwFfm7EC8NUzl34cCkOVUG2uJr4?usp=sharing) **Imperial Valley SBAS Analysis (2015).** This example is provided in the [GMTSAR project](https://topex.ucsd.edu/gmtsar/downloads/) in the archive file [S1A_Stack_CPGF_T173.tar.gz](http://topex.ucsd.edu/gmtsar/tar/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](https://insar.dev/ui/Imperial_Valley_2015.html)
<img src="assets/imperial_valley_2015a.jpg" width="40%" /> <img src="assets/imperial_valley_2015b.jpg" width="40%" />
[](https://colab.research.google.com/drive/1aqAr9KWKzGx9XpVie1M000C3vUxzNDxu?usp=sharing) **Flooding [Correlation] Map: Kalkarindji, NT Australia (2024).** Correlation loss serves to identify flooded areas.
<img src="assets/kalkarindji_2024.jpg" width="80%" />
[](https://colab.research.google.com/drive/1ipiQGbvUF8duzjZER8v-_R48DSpSmgvQ?usp=sharing) **PyGMTSAR SBAS & PSI: Golden Valley, CA (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](https://blog.descarteslabs.com/using-global-insar-at-scale) and [Sentinel-1 Technical Series Part 5 Targeted Analysis](https://blog.descarteslabs.com/sentinel-1-targeted-analysis) with a significant subsidence rate 'exceeding 5cm/year in places'.
<img src="assets/golden_valley_2021.jpg" width="80%" />
[](https://colab.research.google.com/drive/1O3aZtZsTrQIldvCqlVRel13wJRLhmTJt?usp=sharing) **PyGMTSAR SBAS & PSI: 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](https://www.google.com/url?q=https%3A%2F%2Fwww.researchgate.net%2Fpublication%2F378176884_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%" />
[](https://colab.research.google.com/drive/19PLuebOZ4gaYX5ym1H7SwUbJKfl23qPr?usp=sharing) **PyGMTSAR Elevation Map: Erzincan, Türkiye (2019).** This example reproduces 29-page ESA document [DEM generation with Sentinel-1 IW](https://step.esa.int/docs/tutorials/S1TBX%20DEM%20generation%20with%20Sentinel-1%20IW%20Tutorial.pdf).
<img src="assets/erzincan_2019.jpg" width="80%" />
## More PyGMTSAR Live Examples on Google Colab
[](https://colab.research.google.com/drive/1yuuA1ES2ly4QG3hyPg8YYT0nnpGDiQDw?usp=sharing) **Mexico City Interferogram (2016).** This example replicates the 29-page ESA manual [TRAINING KIT – HAZA03. LAND SUBSIDENCE WITH SENTINEL-1 using SNAP](https://eo4society.esa.int/wp-content/uploads/2022/01/HAZA03_Land-Subsidence_Mexico-city.pdf).
## PyGMTSAR Live Examples on Google Colab Pro
I share additional InSAR projects on Google Colab Pro through my [Patreon page](https://www.patreon.com/pechnikov). 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](/pubs/README.md) 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](https://www.patreon.com/c/pechnikov/shop). Preview versions can be found in this GitHub repo:
- [PyGMTSAR Introduction Preview](https://github.com/AlexeyPechnikov/pygmtsar/blob/pygmtsar2/book/PyGMTSAR_preview.pdf)
- [PyGMTSAR Gaussian Filtering Preview](https://github.com/AlexeyPechnikov/pygmtsar/blob/pygmtsar2/book/Gaussian_preview.pdf)
<img src="assets/listing.jpg" width="40%" />
**Video Lessons and Notebooks**
Find PyGMTSAR (Python InSAR) video lessons and educational notebooks on [Patreon](https://www.patreon.com/collection/12458) and [YouTube](https://www.youtube.com/channel/UCSEeXKAn9f_bDiTjT6l87Lg).
**PyGMTSAR AI Assistant**
The [PyGMTSAR AI Assistant](https://insar.dev/ai), powered by OpenAI ChatGPT, can explain InSAR theory, guide you through examples, help build an InSAR processing pipeline, and troubleshoot.
<img width="40%" alt="PyGMTSAR AI Assistant" src="assets/ai.jpg" />
**PyGMTSAR on DockerHub**
Run InSAR processing on macOS, Linux, or Windows via [Docker images](https://hub.docker.com/r/pechnikov/pygmtsar).
**PyGMTSAR on PyPI**
Install the library from [PyPI](https://pypi.python.org/pypi/pygmtsar).
**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](https://github.com/AlexeyPechnikov/pygmtsar/tree/pygmtsar).
© Alexey Pechnikov, 2025
Raw data
{
"_id": null,
"home_page": "https://github.com/AlexeyPechnikov/pygmtsar",
"name": "pygmtsar",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "satellite interferometry, InSAR, remote sensing, geospatial analysis, Sentinel-1, SBAS, PSI",
"author": "Alexey Pechnikov",
"author_email": "alexey@pechnikov.dev",
"download_url": "https://files.pythonhosted.org/packages/9a/ff/79478f2a33faabf9d3ad48e8b9c94da2af6eeabed4eedf651094527584b0/pygmtsar-2025.2.4.tar.gz",
"platform": null,
"description": "[](https://github.com/AlexeyPechnikov/pygmtsar)\n[](https://pypi.python.org/pypi/pygmtsar/)\n[](https://hub.docker.com/r/pechnikov/pygmtsar)\n[](https://zenodo.org/badge/latestdoi/398018212)\n[](https://www.patreon.com/pechnikov)\n[](https://insar.dev/ai)\n\n## PyGMTSAR (Python InSAR): Powerful, Accessible Satellite Interferometry\n\n<img src=\"assets/logo.jpg\" width=\"15%\" />\n\nPyGMTSAR (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\u2019ll find more Jupyter notebook use cases on [Patreon](https://www.patreon.com/pechnikov) and updates on [LinkedIn](https://www.linkedin.com/in/alexey-pechnikov/).\n\n## About PyGMTSAR\n\nPyGMTSAR offers reproducible, high-performance Sentinel-1 interferometry accessible to everyone\u2014whether 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.\n\n## PyGMTSAR Live Examples on Google Colab\n\nGoogle Colab is a free service that lets you run interactive notebooks directly in your browser\u2014no 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.\n\n[](https://colab.research.google.com/drive/1TARVTB7z8goZyEVDRWyTAKJpyuqZxzW2?usp=sharing) **CENTRAL T\u00fcrkiye Mw 7.8 & 7.5 Earthquakes Co-Seismic Interferogram (2023).** The area is large, covering two consecutive Sentinel-1 scenes or a total of 56 bursts.\n\n<img src=\"assets/turkie_2023a.jpg\" width=\"40%\" /><img src=\"assets/turkie_2023b.jpg\" width=\"40%\" />\n\n[](https://colab.research.google.com/drive/1dDFG8BoF4WfB6tOF5sAi5mjdBKRbhxHo?usp=sharing) **Pico do Fogo Volcano Eruption, Fogo Island, Cape Verde (2014).** The interferogram for this event is compared to the study *The 2014\u20132015 eruption of Fogo volcano: Geodetic modeling of Sentinel-1 TOPS interferometry* (*Geophysical Research Letters*, DOI: [10.1002/2015GL066003](https://doi.org/10.1002/2015GL066003)).\n\n<img src=\"assets/pico_2014a.jpg\" width=\"40%\" /><img src=\"assets/pico_2014b.jpg\" width=\"40%\" />\n\n[](https://colab.research.google.com/drive/1d9RcqBmWIKQDEwJYo8Dh6M4tMjJtvseC?usp=sharing) **La Cumbre Volcano Eruption Interferogram (2020).** The results compare with the report from Instituto Geof\u00edsico, Escuela Polit\u00e9cnica Nacional (IG-EPN) (InSAR software unspecified).\n\n<img src=\"assets/la_cumbre_2020a.jpg\" width=\"40%\" /><img src=\"assets/la_cumbre_2020b.jpg\" width=\"40%\" />\n\n[](https://colab.research.google.com/drive/1shNGvUlUiXeyV7IcTmDbWaEM6XrB0014?usp=sharing) **Iran\u2013Iraq Earthquake Co-Seismic Interferogram (2017).** The event has been well investigated, and the results compared to outputs from GMTSAR, SNAP, and GAMMA software.\n\n<img src=\"assets/iran_iraq_2017a.jpg\" width=\"40%\" /><img src=\"assets/iran_iraq_2017b.jpg\" width=\"40%\" />\n\n[](https://colab.research.google.com/drive/1h4XxJZwFfm7EC8NUzl34cCkOVUG2uJr4?usp=sharing) **Imperial Valley SBAS Analysis (2015).** This example is provided in the [GMTSAR project](https://topex.ucsd.edu/gmtsar/downloads/) in the archive file [S1A_Stack_CPGF_T173.tar.gz](http://topex.ucsd.edu/gmtsar/tar/S1A_Stack_CPGF_T173.tar.gz), titled 'Sentinel-1 TOPS Time Series'.\n\nThe resulting InSAR velocity map is available as a self-contained web page at: [Imperial_Valley_2015.html](https://insar.dev/ui/Imperial_Valley_2015.html)\n\n<img src=\"assets/imperial_valley_2015a.jpg\" width=\"40%\" /> <img src=\"assets/imperial_valley_2015b.jpg\" width=\"40%\" />\n\n[](https://colab.research.google.com/drive/1aqAr9KWKzGx9XpVie1M000C3vUxzNDxu?usp=sharing) **Flooding [Correlation] Map: Kalkarindji, NT Australia (2024).** Correlation loss serves to identify flooded areas.\n\n<img src=\"assets/kalkarindji_2024.jpg\" width=\"80%\" />\n\n[](https://colab.research.google.com/drive/1ipiQGbvUF8duzjZER8v-_R48DSpSmgvQ?usp=sharing) **PyGMTSAR SBAS & PSI: Golden Valley, CA (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](https://blog.descarteslabs.com/using-global-insar-at-scale) and [Sentinel-1 Technical Series Part 5 Targeted Analysis](https://blog.descarteslabs.com/sentinel-1-targeted-analysis) with a significant subsidence rate 'exceeding 5cm/year in places'.\n\n<img src=\"assets/golden_valley_2021.jpg\" width=\"80%\" />\n\n[](https://colab.research.google.com/drive/1O3aZtZsTrQIldvCqlVRel13wJRLhmTJt?usp=sharing) **PyGMTSAR SBAS & PSI: 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](https://www.google.com/url?q=https%3A%2F%2Fwww.researchgate.net%2Fpublication%2F378176884_Integration_of_satellite_SAR_and_optical_acquisitions_for_the_characterization_of_the_Lake_Sarez_landslides_in_Tajikistan).\n\n<img src=\"assets/lake_sarez_2017.jpg\" width=\"80%\" />\n\n[](https://colab.research.google.com/drive/19PLuebOZ4gaYX5ym1H7SwUbJKfl23qPr?usp=sharing) **PyGMTSAR Elevation Map: Erzincan, T\u00fcrkiye (2019).** This example reproduces 29-page ESA document [DEM generation with Sentinel-1 IW](https://step.esa.int/docs/tutorials/S1TBX%20DEM%20generation%20with%20Sentinel-1%20IW%20Tutorial.pdf).\n\n<img src=\"assets/erzincan_2019.jpg\" width=\"80%\" />\n\n## More PyGMTSAR Live Examples on Google Colab\n\n[](https://colab.research.google.com/drive/1yuuA1ES2ly4QG3hyPg8YYT0nnpGDiQDw?usp=sharing) **Mexico City Interferogram (2016).** This example replicates the 29-page ESA manual [TRAINING KIT \u2013 HAZA03. LAND SUBSIDENCE WITH SENTINEL-1 using SNAP](https://eo4society.esa.int/wp-content/uploads/2022/01/HAZA03_Land-Subsidence_Mexico-city.pdf).\n\n## PyGMTSAR Live Examples on Google Colab Pro\n\nI share additional InSAR projects on Google Colab Pro through my [Patreon page](https://www.patreon.com/pechnikov). 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.\n\n## Projects and Publications Using PyGMTSAR\n\nSee the [Projects and Publications](/pubs/README.md) page for real-world projects and academic research applying PyGMTSAR. This is not an exhaustive list\u2014contact me if you\u2019d like your project or publication included.\n\n## Resources\n\n**PyGMTSAR projects and e-books**\nAvailable on [Patreon](https://www.patreon.com/c/pechnikov/shop). Preview versions can be found in this GitHub repo:\n\n- [PyGMTSAR Introduction Preview](https://github.com/AlexeyPechnikov/pygmtsar/blob/pygmtsar2/book/PyGMTSAR_preview.pdf) \n- [PyGMTSAR Gaussian Filtering Preview](https://github.com/AlexeyPechnikov/pygmtsar/blob/pygmtsar2/book/Gaussian_preview.pdf)\n\n<img src=\"assets/listing.jpg\" width=\"40%\" />\n\n**Video Lessons and Notebooks**\nFind PyGMTSAR (Python InSAR) video lessons and educational notebooks on [Patreon](https://www.patreon.com/collection/12458) and [YouTube](https://www.youtube.com/channel/UCSEeXKAn9f_bDiTjT6l87Lg).\n\n**PyGMTSAR AI Assistant**\nThe [PyGMTSAR AI Assistant](https://insar.dev/ai), powered by OpenAI ChatGPT, can explain InSAR theory, guide you through examples, help build an InSAR processing pipeline, and troubleshoot.\n\n<img width=\"40%\" alt=\"PyGMTSAR AI Assistant\" src=\"assets/ai.jpg\" />\n\n**PyGMTSAR on DockerHub**\nRun InSAR processing on macOS, Linux, or Windows via [Docker images](https://hub.docker.com/r/pechnikov/pygmtsar).\n\n**PyGMTSAR on PyPI**\nInstall the library from [PyPI](https://pypi.python.org/pypi/pygmtsar).\n\n**PyGMTSAR Previous Versions**\n2023 releases are still on GitHub, PyPI, DockerHub, and Google Colab. Compare PyGMTSAR InSAR with other software by checking out the [PyGMTSAR 2023 Repository](https://github.com/AlexeyPechnikov/pygmtsar/tree/pygmtsar).\n\n\u00a9 Alexey Pechnikov, 2025\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "PyGMTSAR (Python GMTSAR): Powerful and Accessible Satellite Interferometry",
"version": "2025.2.4",
"project_urls": {
"Homepage": "https://github.com/AlexeyPechnikov/pygmtsar"
},
"split_keywords": [
"satellite interferometry",
" insar",
" remote sensing",
" geospatial analysis",
" sentinel-1",
" sbas",
" psi"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "776abdef0fa37f5c56c84286b7303be91b5f11feb296a0c9ec8ea521fd313f3a",
"md5": "9f9d5c4270b1fe4cfd24a792b99a0c7f",
"sha256": "3e6d079c5119d9899b6ad1f243dbd019a81a3c7d64d5b3b0eac7ca0dfa623f66"
},
"downloads": -1,
"filename": "pygmtsar-2025.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9f9d5c4270b1fe4cfd24a792b99a0c7f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 10814972,
"upload_time": "2025-02-04T10:29:24",
"upload_time_iso_8601": "2025-02-04T10:29:24.404812Z",
"url": "https://files.pythonhosted.org/packages/77/6a/bdef0fa37f5c56c84286b7303be91b5f11feb296a0c9ec8ea521fd313f3a/pygmtsar-2025.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9aff79478f2a33faabf9d3ad48e8b9c94da2af6eeabed4eedf651094527584b0",
"md5": "520b123d279d99e8208934dd8a608e44",
"sha256": "a631aff6f7596a04b439af3b6ab8c9325d0b8b93fb0035eaee1d07ab0ce6b0c3"
},
"downloads": -1,
"filename": "pygmtsar-2025.2.4.tar.gz",
"has_sig": false,
"md5_digest": "520b123d279d99e8208934dd8a608e44",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 10798935,
"upload_time": "2025-02-04T10:29:31",
"upload_time_iso_8601": "2025-02-04T10:29:31.271792Z",
"url": "https://files.pythonhosted.org/packages/9a/ff/79478f2a33faabf9d3ad48e8b9c94da2af6eeabed4eedf651094527584b0/pygmtsar-2025.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-04 10:29:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AlexeyPechnikov",
"github_project": "pygmtsar",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pygmtsar"
}
JSON
