# InSARLite
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/mbadarmunir/InSARLite/releases)
[](https://insarlite.readthedocs.io/)
**InSARLite** is a comprehensive GUI application for Interferometric Synthetic Aperture Radar (InSAR) processing using the GMTSAR workflow. It provides an intuitive interface for processing Sentinel-1 SAR data to generate interferograms and perform time series analysis.
## 🌟 Key Features
- **🛰️ Automated Data Management**: Seamless Sentinel-1 data search, download, and organization
- **🎯 Interactive Baseline Planning**: Visual baseline network design with matplotlib-based plotting
- **⚡ Complete GMTSAR Integration**: Full workflow from raw data to unwrapped interferograms
- **📊 Advanced Visualization**: Professional plotting tools and time series analysis
- **🔧 User-Friendly Interface**: Intuitive step-by-step workflow with progress tracking
- **🖥️ Platform Support**: Optimized for Ubuntu Linux with WSL2 support for Windows
- **🚀 Enhanced Performance**: Automatic GNU Parallel and SBAS Parallel installation
- **🔄 WSL Auto-Configuration**: Automatic display configuration for all WSL versions
## 🚀 Quick Start
### Platform Compatibility
- **✅ Ubuntu Linux** (Primary platform - fully tested)
- **⚠️ Windows** (Use WSL2 with Ubuntu for best results)
- **⚠️ macOS** (Experimental support)
- **⚠️ Other Linux** (May require manual configuration)
### Installation
Install InSARLite using pip:
```bash
pip install insarlite
```
**For Windows users**: Install WSL2 first, then install InSARLite inside Ubuntu:
```powershell
# In PowerShell as Administrator
wsl --install -d Ubuntu-20.04
```
### Launch the Application
```bash
InSARLiteApp
```
That's it! The InSARLite GUI will open and guide you through your first InSAR project.
## 📖 Documentation
Comprehensive documentation is available at [insarlite.readthedocs.io](https://insarlite.readthedocs.io/) including:
- **[Installation Guide](https://insarlite.readthedocs.io/en/latest/installation.html)** - Detailed installation instructions
- **[Quick Start Tutorial](https://insarlite.readthedocs.io/en/latest/quickstart.html)** - Get up and running in minutes
- **[User Guide](https://insarlite.readthedocs.io/en/latest/user-guide/)** - Complete usage documentation
- **[API Reference](https://insarlite.readthedocs.io/en/latest/api/)** - Detailed API documentation
- **[Developer Guide](https://insarlite.readthedocs.io/en/latest/developer-guide/)** - For contributors and developers
## 🛠️ What is InSAR?
Interferometric Synthetic Aperture Radar (InSAR) is a radar technique used to generate maps of surface deformation or digital elevation models using differences in the phase of radar waves returning to the satellite. InSARLite makes this powerful technique accessible through:
- **Automated workflows** for complex processing chains
- **Interactive tools** for network design and parameter selection
- **Professional visualization** for scientific analysis and publication
## 🔧 Requirements
- **Python**: 3.8 or higher
- **Operating System**: Linux, macOS, or Windows
- **Memory**: 4 GB RAM minimum (8 GB recommended)
- **Storage**: 2 GB free space (more for data processing)
- **Network**: Internet connection for data downloads
## 📊 Processing Workflow
InSARLite implements a complete 7-step InSAR processing pipeline:
1. **Project Setup** - Define study area, time period, and download data
2. **Data Preparation** - Organize and validate Sentinel-1 acquisitions
3. **Baseline Planning** - Design interferometric network and select master scene
4. **Orbit Processing** - Download and apply precise orbit corrections
5. **Interferometry** - Generate interferograms and coherence maps
6. **Phase Unwrapping** - Convert wrapped phase to displacement measurements
7. **Time Series Analysis** - SBAS processing for deformation time series
## 🎯 Use Cases
InSARLite is perfect for:
- **Research**: Academic studies in geodesy, geophysics, and remote sensing
- **Education**: Teaching InSAR principles and processing techniques
- **Monitoring**: Operational monitoring of volcanoes, earthquakes, and subsidence
- **Analysis**: Scientific analysis of surface deformation processes
## 📈 Example Applications
### Earthquake Studies
Monitor co-seismic and post-seismic deformation with millimeter precision.
### Volcano Monitoring
Track volcanic inflation and deflation patterns over time.
### Urban Subsidence
Measure land subsidence in urban areas and correlate with infrastructure.
### Natural Hazards
Assess landslides, floods, and other geohazards using InSAR techniques.
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on:
- How to report bugs and request features
- Development setup and workflow
- Code style and testing requirements
- Community guidelines
## 📄 License
InSARLite is released under the [MIT License](LICENSE). This allows free use, modification, and distribution for both academic and commercial purposes.
## 🙏 Acknowledgments
- **GMTSAR Team** - For the powerful InSAR processing engine
- **NASA/ESA** - For providing open access to Sentinel-1 data
- **Python Community** - For the excellent scientific computing ecosystem
- **Contributors** - For bug reports, features, and improvements
## 📧 Support
- **Documentation**: [insarlite.readthedocs.io](https://insarlite.readthedocs.io/)
- **Issues**: [GitHub Issues](https://github.com/mbadarmunir/InSARLite/issues)
- **Discussions**: [GitHub Discussions](https://github.com/mbadarmunir/InSARLite/discussions)
- **Email**: mbadarmunir@gmail.com
## 📊 Citation
If you use InSARLite in your research, please cite:
```bibtex
@software{insarlite2025,
title={InSARLite: A GUI Application for GMTSAR-based InSAR Processing},
author={Muhammad Badar Munir},
year={2025},
version={1.1.0},
url={https://github.com/mbadarmunir/InSARLite},
license={MIT}
}
```
---
**InSARLite - Making InSAR accessible to everyone** 🛰️📊
Raw data
{
"_id": null,
"home_page": null,
"name": "insarlite",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Muhammad Badar Munir <mbadarmunir@gmail.com>",
"keywords": "InSAR, SAR, interferometry, GMTSAR, Sentinel-1, remote sensing, geodesy",
"author": null,
"author_email": "Muhammad Badar Munir <mbadarmunir@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/3a/52/56ff8dae74123d77a2b8094bd97b0261f058f674122b6ab67458ec28c7a6/insarlite-1.2.1.tar.gz",
"platform": null,
"description": "# InSARLite\n\n[](https://www.python.org/downloads/)\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/mbadarmunir/InSARLite/releases)\n[](https://insarlite.readthedocs.io/)\n\n**InSARLite** is a comprehensive GUI application for Interferometric Synthetic Aperture Radar (InSAR) processing using the GMTSAR workflow. It provides an intuitive interface for processing Sentinel-1 SAR data to generate interferograms and perform time series analysis.\n\n## \ud83c\udf1f Key Features\n\n- **\ud83d\udef0\ufe0f Automated Data Management**: Seamless Sentinel-1 data search, download, and organization\n- **\ud83c\udfaf Interactive Baseline Planning**: Visual baseline network design with matplotlib-based plotting\n- **\u26a1 Complete GMTSAR Integration**: Full workflow from raw data to unwrapped interferograms\n- **\ud83d\udcca Advanced Visualization**: Professional plotting tools and time series analysis\n- **\ud83d\udd27 User-Friendly Interface**: Intuitive step-by-step workflow with progress tracking\n- **\ud83d\udda5\ufe0f Platform Support**: Optimized for Ubuntu Linux with WSL2 support for Windows\n- **\ud83d\ude80 Enhanced Performance**: Automatic GNU Parallel and SBAS Parallel installation\n- **\ud83d\udd04 WSL Auto-Configuration**: Automatic display configuration for all WSL versions\n\n## \ud83d\ude80 Quick Start\n\n### Platform Compatibility\n\n- **\u2705 Ubuntu Linux** (Primary platform - fully tested)\n- **\u26a0\ufe0f Windows** (Use WSL2 with Ubuntu for best results) \n- **\u26a0\ufe0f macOS** (Experimental support)\n- **\u26a0\ufe0f Other Linux** (May require manual configuration)\n\n### Installation\n\nInstall InSARLite using pip:\n\n```bash\npip install insarlite\n```\n\n**For Windows users**: Install WSL2 first, then install InSARLite inside Ubuntu:\n```powershell\n# In PowerShell as Administrator\nwsl --install -d Ubuntu-20.04\n```\n\n### Launch the Application\n\n```bash\nInSARLiteApp\n```\n\nThat's it! The InSARLite GUI will open and guide you through your first InSAR project.\n\n## \ud83d\udcd6 Documentation\n\nComprehensive documentation is available at [insarlite.readthedocs.io](https://insarlite.readthedocs.io/) including:\n\n- **[Installation Guide](https://insarlite.readthedocs.io/en/latest/installation.html)** - Detailed installation instructions\n- **[Quick Start Tutorial](https://insarlite.readthedocs.io/en/latest/quickstart.html)** - Get up and running in minutes\n- **[User Guide](https://insarlite.readthedocs.io/en/latest/user-guide/)** - Complete usage documentation\n- **[API Reference](https://insarlite.readthedocs.io/en/latest/api/)** - Detailed API documentation\n- **[Developer Guide](https://insarlite.readthedocs.io/en/latest/developer-guide/)** - For contributors and developers\n\n## \ud83d\udee0\ufe0f What is InSAR?\n\nInterferometric Synthetic Aperture Radar (InSAR) is a radar technique used to generate maps of surface deformation or digital elevation models using differences in the phase of radar waves returning to the satellite. InSARLite makes this powerful technique accessible through:\n\n- **Automated workflows** for complex processing chains\n- **Interactive tools** for network design and parameter selection\n- **Professional visualization** for scientific analysis and publication\n\n## \ud83d\udd27 Requirements\n\n- **Python**: 3.8 or higher\n- **Operating System**: Linux, macOS, or Windows\n- **Memory**: 4 GB RAM minimum (8 GB recommended)\n- **Storage**: 2 GB free space (more for data processing)\n- **Network**: Internet connection for data downloads\n\n## \ud83d\udcca Processing Workflow\n\nInSARLite implements a complete 7-step InSAR processing pipeline:\n\n1. **Project Setup** - Define study area, time period, and download data\n2. **Data Preparation** - Organize and validate Sentinel-1 acquisitions\n3. **Baseline Planning** - Design interferometric network and select master scene\n4. **Orbit Processing** - Download and apply precise orbit corrections\n5. **Interferometry** - Generate interferograms and coherence maps\n6. **Phase Unwrapping** - Convert wrapped phase to displacement measurements\n7. **Time Series Analysis** - SBAS processing for deformation time series\n\n## \ud83c\udfaf Use Cases\n\nInSARLite is perfect for:\n\n- **Research**: Academic studies in geodesy, geophysics, and remote sensing\n- **Education**: Teaching InSAR principles and processing techniques\n- **Monitoring**: Operational monitoring of volcanoes, earthquakes, and subsidence\n- **Analysis**: Scientific analysis of surface deformation processes\n\n## \ud83d\udcc8 Example Applications\n\n### Earthquake Studies\nMonitor co-seismic and post-seismic deformation with millimeter precision.\n\n### Volcano Monitoring\nTrack volcanic inflation and deflation patterns over time.\n\n### Urban Subsidence\nMeasure land subsidence in urban areas and correlate with infrastructure.\n\n### Natural Hazards\nAssess landslides, floods, and other geohazards using InSAR techniques.\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on:\n\n- How to report bugs and request features\n- Development setup and workflow\n- Code style and testing requirements\n- Community guidelines\n\n## \ud83d\udcc4 License\n\nInSARLite is released under the [MIT License](LICENSE). This allows free use, modification, and distribution for both academic and commercial purposes.\n\n## \ud83d\ude4f Acknowledgments\n\n- **GMTSAR Team** - For the powerful InSAR processing engine\n- **NASA/ESA** - For providing open access to Sentinel-1 data\n- **Python Community** - For the excellent scientific computing ecosystem\n- **Contributors** - For bug reports, features, and improvements\n\n## \ud83d\udce7 Support\n\n- **Documentation**: [insarlite.readthedocs.io](https://insarlite.readthedocs.io/)\n- **Issues**: [GitHub Issues](https://github.com/mbadarmunir/InSARLite/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/mbadarmunir/InSARLite/discussions)\n- **Email**: mbadarmunir@gmail.com\n\n## \ud83d\udcca Citation\n\nIf you use InSARLite in your research, please cite:\n\n```bibtex\n@software{insarlite2025,\n title={InSARLite: A GUI Application for GMTSAR-based InSAR Processing},\n author={Muhammad Badar Munir},\n year={2025},\n version={1.1.0},\n url={https://github.com/mbadarmunir/InSARLite},\n license={MIT}\n}\n```\n\n---\n\n**InSARLite - Making InSAR accessible to everyone** \ud83d\udef0\ufe0f\ud83d\udcca\n",
"bugtrack_url": null,
"license": null,
"summary": "A comprehensive GUI application for GMTSAR-based InSAR processing",
"version": "1.2.1",
"project_urls": {
"Bug Tracker": "https://github.com/mbadarmunir/InSARLite/issues",
"Changelog": "https://github.com/mbadarmunir/InSARLite/blob/main/CHANGELOG.md",
"Documentation": "https://insarlite.readthedocs.io/",
"Homepage": "https://github.com/mbadarmunir/InSARLite",
"Repository": "https://github.com/mbadarmunir/InSARLite"
},
"split_keywords": [
"insar",
" sar",
" interferometry",
" gmtsar",
" sentinel-1",
" remote sensing",
" geodesy"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b7ded794f62d661e57417cccb212f45396c06016b365cdfbaef9290babb657da",
"md5": "bc86bdd0f0a2abbb9a3e3fe676703e51",
"sha256": "55ae5fac3c727d641de8a6d9d0763a5ed307c0772c3c6df1ec45b6bdc2663710"
},
"downloads": -1,
"filename": "insarlite-1.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bc86bdd0f0a2abbb9a3e3fe676703e51",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 164275,
"upload_time": "2025-10-30T07:31:45",
"upload_time_iso_8601": "2025-10-30T07:31:45.568088Z",
"url": "https://files.pythonhosted.org/packages/b7/de/d794f62d661e57417cccb212f45396c06016b365cdfbaef9290babb657da/insarlite-1.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3a5256ff8dae74123d77a2b8094bd97b0261f058f674122b6ab67458ec28c7a6",
"md5": "4ef947afdb6f29e2b0d210c8b5fdcb16",
"sha256": "dbff0e5f5b97562ac65d312628f585931e271496c816f47d2547a900b92ac991"
},
"downloads": -1,
"filename": "insarlite-1.2.1.tar.gz",
"has_sig": false,
"md5_digest": "4ef947afdb6f29e2b0d210c8b5fdcb16",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 150985,
"upload_time": "2025-10-30T07:31:47",
"upload_time_iso_8601": "2025-10-30T07:31:47.543573Z",
"url": "https://files.pythonhosted.org/packages/3a/52/56ff8dae74123d77a2b8094bd97b0261f058f674122b6ab67458ec28c7a6/insarlite-1.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-30 07:31:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mbadarmunir",
"github_project": "InSARLite",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "insarlite"
}
JSON
