InSARLite
Getting Started
Project Overview
What is InSAR?
Interferometric Synthetic Aperture Radar Basics
Key InSAR Concepts
Applications of InSAR
InSARLite Architecture
Design Philosophy
Conceptual Structure
Project Configuration
Step 1: Baseline Network Selection (Base2Net)
Step 2: Alignment and Interferogram Generation
Step 3: Phase Unwrapping
Step 4: SBAS Inversion and Time Series
Processing Workflow
Complete Processing Pipeline
Project Configuration (Step 0)
Step 1: Baseline Network Selection (01_Base2Net)
Step 2: Alignment and Interferogram Generation (02_Align_Generate)
Step 3: Phase Unwrapping (03_Unwrap)
Step 4: SBAS Inversion and Visualization (04_SBAS)
Data Flow Summary
Key Features
🎯
Interactive Baseline Planning
🛰️
Automated Data Management
⚙️
Professional Processing
📊
Advanced Visualization
🔧
User-Friendly Interface
Technical Specifications
Supported Data Types
Output Formats
Performance Characteristics
Best Practices
Project Planning
Data Quality
Processing Efficiency
Next Steps
Installation Guide
Platform Compatibility
✅ Tested and Supported
⚠️ Not Tested (Use at Your Own Risk)
❌ Not Supported
System Requirements
Minimum Requirements
Recommended Requirements
Dependencies
Python Dependencies (Automatic Installation)
Core Dependencies
InSAR-Specific Dependencies
Geospatial Dependencies
Optional Dependencies
System Dependencies (Automatic Management)
GMTSAR (Automatic Installation)
Installation Methods
Method 1: Using pip (Recommended)
Method 2: Using conda
Method 3: Development Installation
Platform-Specific Instructions
Linux (Ubuntu/Debian) - Recommended Platform
Linux (CentOS/RHEL/Fedora) - Experimental Support
macOS - Experimental Support
Windows Subsystem for Linux (WSL2) - For Windows Users Only
Virtual Environment Setup (Recommended)
Using venv (Python 3.3+)
Using conda
Verification
GMTSAR Automatic Installation Workflow
Step 1: First Launch - GMTSAR Not Found
Step 2: Select Installation Mode
Full Installation (Recommended)
Minimal Installation
Step 3: Orbit Files (Optional)
Step 4: Sudo Authentication
Step 5: Confirm Installation
Step 6: Installation Process
Step 7: Installation Complete
Step 8: Relaunch InSARLite
Verification
Manual GMTSAR Installation (Advanced Users)
Restricted Environment Setup
Troubleshooting
Windows and WSL Issues
“Platform Not Supported” Error on Windows
GUI Not Appearing in WSL
WSL Performance Issues
“Cannot connect to X server” Error
InSARLite Issues
ImportError: No module named ‘tkinter’
ModuleNotFoundError: No module named ‘cartopy’
GMTSAR Installation Issues
Permission denied during installation
Compilation errors
“Command not found” after installation
Missing orbit files
General Issues
Memory errors during processing
Display issues on remote systems
Getting Help
Next Steps
Updating InSARLite
Quick Start Guide
Prerequisites
Launch InSARLite
Learn InSARLite: Turkey Landslide Tutorial
🏔️ Turkey Landslide Case Study →
Quick Workflow Overview
Adapting the Tutorial to Your Study Area
Spatial Parameters
Temporal Parameters
Network Parameters
Processing Parameters
Getting Help
Next Steps
Turkey Landslide Tutorial
Tutorial: Güngören Landslide Analysis - Complete Workflow
Warning:
Introduction
Study Area Background
Tutorial Objectives
Dataset Information
Prerequisites
Time and Storage Requirements
Part 1: Installation and First Launch
Step 1.1: First Launch - GMTSAR Not Found
Step 1.2: Installation Mode Selection
Step 1.3: Optional Orbit Files
Step 1.4: Authentication
Step 1.5: Installation Confirmation
Step 1.6: Installation Complete
Step 1.7: Verification
Part 2: Project Configuration
Step 2.1: Define Data Folder
Step 2.2: Define Area of Interest (AOI)
Step 2.3: Define Temporal Range
Step 2.4: Query Available Data
Step 2.5: Download Sentinel-1 Data
Step 2.6: Extract Sentinel-1 Data
Step 2.7: Validate Data
Step 2.8: Download DEM
Step 2.9: Define Output Configuration
Part 3: Baseline Network Design (Step 1)
Step 3.1: Download Precise Orbit Files
Step 3.2: Open Baseline Calculator (Base2Net)
Step 3.3: Plot Baselines
Step 3.4: Calculate Master Table
Step 3.5: Select Master Image
Step 3.6: Define Baseline Constraints
Step 3.7: Export Network Configuration
Part 4: Interferogram Generation (Step 2)
Step 4.1: Configure IFG Parameters
Step 4.2: Confirm Execution
Step 4.3: Monitor Processing Progress
Part 5: Phase Unwrapping (Step 3)
Phase 1: Mask Definition
Phase 2: First Unwrapping
Phase 3: Reference Point Selection
Phase 4: Unwrapping Completion
Part 6: SBAS Inversion and Visualization (Step 4)
Step 6.1: Configure SBAS Parameters
Step 6.2: Confirm Existing Displacement Files
Step 6.3: Execute SBAS Inversion
Step 6.4: Launch Surface Deformation Visualizer
Step 6.5: Polygon Mode Analysis
Part 7: Results and Scientific Interpretation
Step 7.1: Example Time Series Result
Step 7.2: Deformation Analysis
Step 7.3: Scientific Significance
Part 8: Output Files and Data Products
Step 8.1: Project Directory Structure
Step 8.2: Key Output Files
Step 8.3: Export Formats
Part 9: Summary and Next Steps
What You’ve Accomplished
Key Findings
Processing Time Summary
Best Practices Learned
Further Exploration
Troubleshooting
Resources
Citation
Acknowledgments
Conclusion
Tutorial Overview
What You’ll Learn
Dataset Details
Time and Storage Requirements
Prerequisites
Getting Help
User Guide
User Guide
Available Documentation
Project Overview
What is InSAR?
InSARLite Architecture
Processing Workflow
Key Features
Technical Specifications
Best Practices
Next Steps
User Interface Guide
Complete InSAR Processing Workflow
Data Management Guide
Case Studies
Interactive Visualizer
Learn by Doing
🏔️ Turkey Landslide Case Study Tutorial
Reference Documentation
Overview
Future Documentation
Getting Help
Developer Guide
Developer Guide
Project Overview
Architecture Principles
🏗️
Modular Design
🔄
Event-Driven Architecture
📊
Data Flow Management
Code Organization
Directory Structure
Module Responsibilities
main.py
- Application Orchestrator
gmtsar_gui/
- Processing Modules
utils/
- Supporting Infrastructure
Design Patterns
🎯
Model-View-Controller (MVC)
🏭
Factory Pattern
📋
Observer Pattern
🔧
Command Pattern
Key Components
🖥️
Main Application (
InSARLiteApp
)
🛰️
Data Management System
📊
Interactive Baseline Plotter
⚙️
Processing Pipeline
Threading and Concurrency
🧵
Threading Strategy
🔄
Event Loop Integration
Error Handling Strategy
🚨
Comprehensive Error Management
📝
Logging Configuration
Performance Optimization
💾
Memory Management
⚡
Performance Optimization
Testing Framework
🧪
Testing Strategy
🎯
Continuous Integration
Development Workflow
🔄
Git Workflow
📦
Package Management
Extending InSARLite
🔌
Adding New Processing Modules
🎨
Customizing the UI
📊
Adding Visualization Features
Best Practices
🎯
Code Quality
🔒
Security
📚
Documentation
Release Process
🚀
Version Management
📦
Release Steps
Community and Support
💬
Communication Channels
🤝
Contributing
📋
Issue Management
Next Steps
About
About InSARLite
Project Mission
Development History
Genesis (2024)
Evolution (2024-2025)
Current Status (2025)
Technical Foundation
Core Technologies
Architecture Principles
Project Team
Lead Developer
Contributors
Development
Potential Applications
Future Development
Open Source Commitment
Contact and Support
Contributing
Acknowledgments
License
Contributing to InSARLite
Ways to Contribute
🐛
Bug Reports
💡
Feature Requests
📚
Documentation
💻
Code Contributions
🧪
Testing
💬
Community Support
Getting Started
Development Environment Setup
Development Workflow
Coding Standards
Python Style Guide
Documentation Standards
GUI Development Guidelines
Testing Guidelines
Test Organization
Writing Tests
Test Data and Fixtures
Pull Request Process
Before Submitting
Pull Request Template
Review Process
Community Guidelines
Code of Conduct
Communication
Recognition
Getting Help
For Contributors
For Maintainers
Resources
Development Tools
Learning Resources
Changelog
[1.3.0] - 2024-12-10 - “Visualization Revolution + Optimizations”
📚
Added - Documentation
Master Selection Methodology
⚡
Optimized - GMTSAR Installation
Streamlined Installation Check
GUI-Only Installation Mode
🛠️
Changed - Configuration Flow
Main Application Startup
🔧
Technical Details
Performance Metrics
Code Quality
[1.3.0] - 2025-11-25 - “Visualization Revolution”
🎨
Enhanced - Interactive Visualization
Interactive Time Series Visualizer
True Vector Output
Polygon Multi-Pixel Analysis
Context Maps
🔧
Technical Improvements
Enhanced Validation
Coordinate Transformation
Memory Management
🐛
Bug Fixes
🗑️
Removed
[1.2.6] - 2025-11-20
🐛
Bug Fixes
Critical Data Structure Fix
[1.2.5] - 2025-11-18
🔧
Technical Improvements
Comprehensive Debugging System
Code Cleanup
[1.2.4] - 2025-11-15
🐛
Bug Fixes
Progress Window Advancement
Automatic Completion Detection
[1.2.3] - 2025-11-12
🔧
Technical Improvements
Subswath Detection
Network-Aware Progress
Enhanced Messaging
Validation and Safety
[1.2.2] - 2025-11-10
🛡️
Security & Data Safety
Critical Data Protection
Dangerous Function Removal
Backup System Redesign
User Control
Safety Guarantees
[1.2.1] - 2025-11-08
🐛
Bug Fixes
Data Loss Prevention
Network Connectivity Validation
Benefits
[1.2.0] - 2025-11-05
✨
Added
Enhanced Logging System
Configuration Management
File Pattern Detection
Alignment Status Analysis
Data Validation
🔧
Technical Improvements
Intelligent Alignment
Backward Compatibility
[1.0.0] - 2025-10-27
🎉
First Major Release
✨
Added
Core Features
Data Processing
User Interface
Visualization
Advanced Features
🔧
Technical Infrastructure
Architecture
Dependencies
Performance
📚
Documentation
Comprehensive Documentation
Educational Content
🛡️
Quality Assurance
Testing
Code Quality
🌟
Key Improvements Since Beta
User Experience
Processing Enhancements
Bug Fixes
🔄
Migration from Beta
🎯
Future Roadmap
Version 1.1 (Planned)
Version 1.2 (Planned)
🙏
Acknowledgments
Contributors
Dependencies
Support
📈
Statistics
Previous Versions
[0.0.3] - 2024-12-XX (Beta)
[0.0.2] - 2024-11-XX (Alpha)
[0.0.1] - 2024-10-XX (Development)
Version Numbering
Release Types
License
MIT License
What This Means
✅
Permitted Uses
📋
Requirements
❌
Limitations
Third-Party Licenses
Core Dependencies
Scientific Computing
Geospatial Libraries
InSAR-Specific
GUI and Utilities
License Compatibility
Data and Content Licenses
Satellite Data
Documentation
Contributing and License
Contributor License Agreement
Commercial Use
Academic Use
Suggested Citation
Warranty Disclaimer
No Warranty of Functionality
No Liability for Damages
User Responsibility
License Updates
Current License Version
License Stability
Notification of Changes
Getting Help with Licensing
Legal Questions
Usage Questions
Commercial Licensing
InSARLite
Index
Index