Repository navigation
PyGeoFetch v2.6.2
PyGeoFetch version 2.6.2 Production Ready Multiple Provider Earth Observation and InSAR Platform
PyGeoFetch version 2.6.2 is a mature open source Python framework that unifies satellite data acquisition, predownload quality control, and advanced geospatial processing. It eliminates the fragmentation of multiple provider satellite APIs while introducing the first pure Python Windows native end to end InSAR processing chain. Designed for reproducibility and accessibility, it empowers researchers, government analysts, and students, particularly in the Global South, to execute complex Earth Observation workflows without relying on expensive commercial software or Linux high performance computing infrastructure.
The Preflight Gate serves as a novel predownload validation engine that evaluates stack viability before acquiring data. It automatically excludes scenes with insufficient area of interest coverage, validates Sentinel 1 TOPS burst synchronization to meet the strict five millisecond requirement, and implements orbit cascading fallbacks from precise to restituted to predicted orbits. This prevents the acquisition of terabytes of unusable data and saves significant bandwidth.
Windows Native InSAR Chain provides zero configuration SNAPHU integration that automatically detects operating system architecture and deploys precompiled binaries. This completely removes the notorious manual compilation barrier that has historically alienated Windows users from advanced InSAR processing.
Unified Multiple Provider API allows a single client search call to query over twenty providers, including Copernicus, USGS, Planetary Computer, AWS Earth, and NASA Earthdata, simultaneously. It returns a deduplicated and standardized SatelliteData object with automatic keyring based authentication.
Advanced InSAR and SAR Processing features a complete processing chain including orbit based geometric coregistration, Enhanced Spectral Diversity refinement, interferogram formation, topographic phase removal, and Goldstein filtering. The native SBAS time series inversion utilizes a Weighted Least Squares solver with native Phase Closure for unwrapping error correction and DEM Error Correction, which eliminates the need for external dependencies like MintPy. PS InSAR Hybrid Densification employs Amplitude Dispersion Index selection refined by temporal coherence, alongside NaN aware Atmospheric Phase Screen estimation. Large Deformation Monitoring utilizes amplitude based offset tracking with sub pixel parabolic refinement and signal to noise ratio based quality control for areas exceeding conventional phase limits, such as active mining sites and landslides. Atmospheric and Ionospheric Correction offers integrated support for ERA5, GACOS, and IONEX corrections.
Optical and Multi Sensor Processing includes a forty one step chainable pipeline for atmospheric correction, cloud masking, seventeen spectral indices, topographic correction, pan sharpening, and multi temporal compositing. Modern Geospatial Input and Output supports native Cloud Optimized GeoTIFF export, lazy loading via xarray and dask integration, and stateful provenance tracking.
Geospatial Analysis and Visualization enables interactive mapping via leafmap and MapViewer integration. It provides publication ready risk mapping with Bayesian uncertainty quantification and automated provenance manifests to ensure completely reproducible research.
Scientific Validation successfully detected Mexico City subsidence at negative thirty five point five centimeters per year, which is directionally consistent with the published benchmark of negative thirty nine point one centimeters per year reported by Cigna and Tapete in 2021, all while using a fraction of the data volume.
Operational Efficiency in benchmark testing reduced average data acquisition time by eighty seven percent and prevented the download of two point four terabytes of decorrelated or orbit deficient data via the Preflight Gate.
Production Scale has successfully processed over four hundred and fifty Sentinel 1 SLC pairs and more than one thousand two hundred optical scenes across diverse applications including mining subsidence in Obuasi Ghana, flood mapping, and urban expansion.
PyGeoFetch is platform independent for Python 3.9 and higher, and it is available via PyPI.
The core package for optical and multiple provider data access is installed via pip install pygeofetch.
Full InSAR capabilities, including native SBAS, PS InSAR, and offset tracking, are installed via pip install pygeofetch complete insar.
Advanced geospatial processing dependencies, such as rasterio and xarray, are installed via pip install pygeofetch geo.
Documentation and Support
This software is distributed under the MIT License, which is designed to maximize reuse, modification, and integration across both academic and operational contexts.