PyGeoFetch 1.1.0__tar.gz → 1.3.0__tar.gz

{pygeofetch-1.1.0 → pygeofetch-1.3.0}/CHANGELOG.md

@@ -1,9 +1,9 @@
 # Changelog
 
 All notable changes to PyGeoFetch are documented here.
-Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.3.0/).
 
-## [1.1.0] — 2026-07-12
+## [1.3.0] — 2026-07-12
 
 ### Added
 - Federated search across 22+ satellite data providers

{pygeofetch-1.1.0/pygeofetch.egg-info → pygeofetch-1.3.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: pygeofetch
-Version: 1.1.0
-Summary: Universal satellite data pipeline — unified access to 22+ providers
-Author: PyGeoFetch Contributors
+Version: 1.3.0
+Summary: Universal satellite data pipeline + geospatial processing platform
+Author-email: pygeofetch Contributors <pygeofetch@example.com>
 License: MIT License
         
         Copyright (c) 2024 SatelliteBridge Contributors
@@ -25,11 +25,11 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
-Project-URL: Homepage, https://github.com/appiahkubis14/pygeofetch
+Project-URL: Homepage, https://github.com/pygeofetch/pygeofetch
 Project-URL: Documentation, https://pygeofetch.readthedocs.io
-Project-URL: Repository, https://github.com/appiahkubis14/pygeofetch
-Project-URL: Bug Tracker, https://github.com/appiahkubis14/pygeofetch/issues
-Keywords: satellite,remote-sensing,GIS,earth-observation,geospatial
+Project-URL: Repository, https://github.com/pygeofetch/pygeofetch
+Project-URL: Bug Tracker, https://github.com/pygeofetch/pygeofetch/issues
+Keywords: satellite,remote-sensing,GIS,earth-observation,geospatial,SAR,Sentinel,Landsat
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
@@ -46,41 +46,91 @@ Requires-Dist: httpx>=0.27
 Requires-Dist: click>=8.1
 Requires-Dist: pydantic>=2.5
 Requires-Dist: pydantic-settings>=2.1
-Requires-Dist: rich>=13.7
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: cryptography>=42.0
 Requires-Dist: keyring>=24.3
-Requires-Dist: aiofiles>=23.2
 Requires-Dist: tenacity>=8.2
 Requires-Dist: python-dateutil>=2.9
-Requires-Dist: tqdm>=4.66
 Requires-Dist: requests>=2.31
 Requires-Dist: anyio>=4.2
-Requires-Dist: boto3>=1.34
-Requires-Dist: click-completion>=0.5
+Requires-Dist: numpy>=1.26
+Requires-Dist: tqdm>=4.66
 Provides-Extra: geo
 Requires-Dist: rasterio>=1.3; extra == "geo"
 Requires-Dist: geopandas>=0.14; extra == "geo"
 Requires-Dist: pyarrow>=15.0; extra == "geo"
 Requires-Dist: shapely>=2.0; extra == "geo"
 Requires-Dist: pyproj>=3.6; extra == "geo"
+Provides-Extra: processor
+Requires-Dist: rasterio>=1.3; extra == "processor"
+Requires-Dist: rioxarray>=0.15; extra == "processor"
+Requires-Dist: xarray>=2024.1; extra == "processor"
+Requires-Dist: eoreader>=0.24; extra == "processor"
+Requires-Dist: spyndex>=0.5; extra == "processor"
+Requires-Dist: scipy>=1.12; extra == "processor"
+Requires-Dist: scikit-image>=0.23; extra == "processor"
+Requires-Dist: geopandas>=0.14; extra == "processor"
+Provides-Extra: providers
+Requires-Dist: eodag>=3.0; extra == "providers"
+Provides-Extra: sar
+Requires-Dist: sarxarray>=0.1; extra == "sar"
+Requires-Dist: scipy>=1.12; extra == "sar"
+Provides-Extra: ost
+Requires-Dist: opensartoolkit>=3.0; extra == "ost"
+Provides-Extra: viz
+Requires-Dist: leafmap>=0.30; extra == "viz"
+Requires-Dist: folium>=0.16; extra == "viz"
+Requires-Dist: matplotlib>=3.7; extra == "viz"
+Requires-Dist: localtileserver>=1.0.0; extra == "viz"
+Requires-Dist: ipysheet>=0.6.0; extra == "viz"
+Requires-Dist: ipyleaflet>=0.17.0; extra == "viz"
+Requires-Dist: ipywidgets>=8.0.0; extra == "viz"
+Requires-Dist: ipyevents>=2.0.0; extra == "viz"
+Requires-Dist: ipyfilechooser>=0.6.0; extra == "viz"
+Requires-Dist: sidecar>=0.6.0; extra == "viz"
+Requires-Dist: bokeh>=3.0.0; extra == "viz"
+Requires-Dist: seaborn>=0.12.0; extra == "viz"
+Requires-Dist: plotly>=5.14.0; extra == "viz"
+Requires-Dist: whitebox>=2.3.0; extra == "viz"
+Requires-Dist: whiteboxgui>=2.3.0; extra == "viz"
+Requires-Dist: geemap>=0.28.0; extra == "viz"
+Requires-Dist: osmnx>=1.7.0; extra == "viz"
+Requires-Dist: contextily>=1.5.0; extra == "viz"
+Requires-Dist: xyzservices>=2023.10.0; extra == "viz"
+Requires-Dist: mapclassify>=2.5.0; extra == "viz"
+Requires-Dist: geoplot>=0.5.0; extra == "viz"
+Requires-Dist: mplleaflet>=0.0.5; extra == "viz"
+Requires-Dist: branca>=0.6.0; extra == "viz"
+Requires-Dist: plotly-geo>=1.0.0; extra == "viz"
+Requires-Dist: keplergl>=0.3.0; extra == "viz"
+Requires-Dist: streamlit>=1.28.0; extra == "viz"
 Provides-Extra: cloud
 Requires-Dist: boto3>=1.34; extra == "cloud"
 Requires-Dist: pystac>=1.9; extra == "cloud"
+Requires-Dist: planetary-computer>=1.0; extra == "cloud"
+Provides-Extra: notebook
+Requires-Dist: ipython>=8.0; extra == "notebook"
+Requires-Dist: ipywidgets>=8.0; extra == "notebook"
+Requires-Dist: jupyter>=1.0; extra == "notebook"
 Provides-Extra: schedule
 Requires-Dist: croniter>=2.0; extra == "schedule"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.1; extra == "dev"
 Requires-Dist: pytest-mock>=3.12; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
-Requires-Dist: vcrpy>=6.0; extra == "dev"
-Requires-Dist: black>=24.0; extra == "dev"
 Requires-Dist: ruff>=0.3; extra == "dev"
 Requires-Dist: mypy>=1.8; extra == "dev"
-Requires-Dist: bump2version>=1.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Provides-Extra: insar-full
+Requires-Dist: snaphu>=0.1; extra == "insar-full"
+Requires-Dist: scipy>=1.12; extra == "insar-full"
+Requires-Dist: mintpy>=1.5; extra == "insar-full"
+Requires-Dist: pyaps3>=0.3; extra == "insar-full"
+Provides-Extra: full
+Requires-Dist: pygeofetch[cloud,geo,notebook,processor,providers,sar,schedule,viz]; extra == "full"
 Provides-Extra: all
-Requires-Dist: pygeofetch[cloud,dev,geo,schedule]; extra == "all"
+Requires-Dist: pygeofetch[full]; extra == "all"
 Dynamic: license-file
 
 <div align="center">
@@ -136,7 +186,7 @@ Existing tools address parts of this problem: EODAG supports several providers b
 
 ---
 
-
+## 🚀 Key Features
 
 ### 🛰️ 22+ Satellite Providers
 
@@ -301,11 +351,11 @@ pygeofetch download run \
 
 ```python
 from pathlib import Path
-from pygeofetch import PyGeoFetch
+from pygeofetch import pygeofetch
 from pygeofetch.models.search_query import SearchQuery, BoundingBox
 from pygeofetch.models.download_task import DownloadOptions
 
-client = PyGeoFetch()
+client = pygeofetch()
 
 # Credentials
 client.add_credentials("usgs",       username="user", password="pass")
@@ -534,36 +584,6 @@ COMPLETION
   pygeofetch --install-completion bash|zsh|fish
 ```
 
----
-
-## 🗂️ Project Structure
-
-```
-pygeofetch/
-├── pygeofetch/
-│   ├── core/                engine, authenticator, searcher, downloader, scheduler, cache
-│   ├── cli/                 11 CLI command modules
-│   ├── processing/          ← geospatial processing engine
-│   │   ├── preprocessor.py  atmospheric, cloud, geometric, resampling, compositing
-│   │   ├── indices.py       17 spectral indices + transformations
-│   │   ├── postprocessor.py vectorize, smooth, zonal stats, COG, compress
-│   │   ├── sar.py           despeckle, calibrate, flood map, coherence
-│   │   ├── pipeline.py      chainable builder + YAML loader + 6 templates
-│   │   └── batch.py         parallel batch processing
-│   ├── models/              Pydantic models (search, download, auth, satellite)
-│   ├── providers/           22 provider implementations
-│   ├── utils/               logging, retry, geo, file, validators
-│   └── config/              settings, defaults.yaml
-├── notebooks/               9 Jupyter notebooks (01–09)
-├── tests/                   60 unit + integration tests
-├── docs/assets/
-├── pyproject.toml
-├── Dockerfile · Makefile · .gitignore
-└── .github/workflows/tests.yml
-```
-
----
-
 ## 📚 Notebooks
 
 | Notebook | Topics |
@@ -585,6 +605,25 @@ jupyter lab
 
 ---
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EOCoreINT/pygeofetch/refs/heads/main/docs/images/trend_map.png?token=GHSAT0AAAAAAD4555HVK7XABUW65FV6B3N22S7TNMA" width="48%" />
+  <img src="https://raw.githubusercontent.com/EOCoreINT/pygeofetch/refs/heads/main/docs/images/trend_classification.png?token=GHSAT0AAAAAAD4555HVX7RLHLSCQSBSGCIY2S7TMFQ" width="48%" />
+</p>
+<p align="center"><em>NDVI trend (2018–2024) and severity classification for the Obuasi Municipal District, computed end-to-end with PyGeoFetch — real USGS Landsat data, boundary-clipped before processing.</em></p>
+
+32.0% of the Obuasi Municipal District shows measurable vegetation decline over 2018–2024 (9.2% strong decline + 22.8% moderate decline), against 57.5% stable and 10.5% showing an increasing trend.
+
+That headline number matters less than where it's concentrated. The decline isn't scattered randomly across the district — it forms a clear, spatially coherent cluster in the western portion of the AOI (roughly west of -1.70° longitude), visible as a dense, contiguous red-and-orange zone in both the trend map and the classification map. Real land degradation signals tend to look like this — clustered along mining concessions, roads, or river corridors — whereas sensor noise or processing artifacts tend to scatter more randomly across the whole scene. The fact that this pattern holds together spatially is a reasonable indicator that it reflects something real on the ground, not just pixel-level noise.
+
+That said, an NDVI trend map on its own can't distinguish why vegetation declined — illegal small-scale mining (galamsey), selective logging, agricultural land clearing, and urban expansion can all produce a similar signature. Given Obuasi's well-documented galamsey activity specifically concentrated in this district, the spatial pattern here is consistent with mining-driven clearance — but confirming that specific cause would need either higher-resolution imagery, ground verification, or cross-referencing against known concession boundaries, not this analysis alone.
+
+Two things worth flagging honestly rather than glossing over:
+
+The scattered dark-blue linear and blob features running through the map (most visibly the river-like feature crossing the upper-central area) are very likely water bodies, not vegetation gain. NDVI trend over open water isn't a meaningful signal — surface reflectance there is driven by turbidity and water level, not plant health — so those features should be excluded from the "increasing" interpretation, not read as reforestation.
+The small white gaps scattered through the trend map (several distinct circular patches) are nodata — pixels that didn't have enough valid, cloud-free observations across all six dates to fit a reliable trend. Worth being upfront that the 32%/57.5%/10.5% breakdown is computed over the valid pixels only, not the full district area including these gaps.
+
+The eastern two-thirds of the district, by contrast, is overwhelmingly stable (dominant green in the classification map), which is itself a useful negative result — it suggests the decline is genuinely localized to a specific area rather than reflecting a district-wide drought or seasonal artifact that would show up everywhere.
+
 ## 📋 Documentation
 
 Full documentation: **https://appiahkubis14.github.io/pygeofetch-docs/**
@@ -612,4 +651,4 @@ pytest tests/unit/ -v
 
 pygeofetch is free and open source software, licensed under the [MIT License](LICENSE).
 
-© 2025 pygeofetch Contributors. Part of the **PyGeoVision** platform — [pygeofetch](https://github.com/appiahkubis14/pygeofetch) (data + processing) + [GeoAI](https://opengeoai.org) (AI) = complete Earth observation pipeline.
+© 2026 pygeofetch Contributors. Part of the **PyGeoVision** platform — [pygeofetch](https://github.com/appiahkubis14/pygeofetch) (data + processing) + [GeoAI](https://opengeoai.org) (AI) = complete Earth observation pipeline.

{pygeofetch-1.1.0 → pygeofetch-1.3.0}/README.md

@@ -51,7 +51,7 @@ Existing tools address parts of this problem: EODAG supports several providers b
 
 ---
 
-
+## 🚀 Key Features
 
 ### 🛰️ 22+ Satellite Providers
 
@@ -216,11 +216,11 @@ pygeofetch download run \
 
 ```python
 from pathlib import Path
-from pygeofetch import PyGeoFetch
+from pygeofetch import pygeofetch
 from pygeofetch.models.search_query import SearchQuery, BoundingBox
 from pygeofetch.models.download_task import DownloadOptions
 
-client = PyGeoFetch()
+client = pygeofetch()
 
 # Credentials
 client.add_credentials("usgs",       username="user", password="pass")
@@ -449,36 +449,6 @@ COMPLETION
   pygeofetch --install-completion bash|zsh|fish
 ```
 
----
-
-## 🗂️ Project Structure
-
-```
-pygeofetch/
-├── pygeofetch/
-│   ├── core/                engine, authenticator, searcher, downloader, scheduler, cache
-│   ├── cli/                 11 CLI command modules
-│   ├── processing/          ← geospatial processing engine
-│   │   ├── preprocessor.py  atmospheric, cloud, geometric, resampling, compositing
-│   │   ├── indices.py       17 spectral indices + transformations
-│   │   ├── postprocessor.py vectorize, smooth, zonal stats, COG, compress
-│   │   ├── sar.py           despeckle, calibrate, flood map, coherence
-│   │   ├── pipeline.py      chainable builder + YAML loader + 6 templates
-│   │   └── batch.py         parallel batch processing
-│   ├── models/              Pydantic models (search, download, auth, satellite)
-│   ├── providers/           22 provider implementations
-│   ├── utils/               logging, retry, geo, file, validators
-│   └── config/              settings, defaults.yaml
-├── notebooks/               9 Jupyter notebooks (01–09)
-├── tests/                   60 unit + integration tests
-├── docs/assets/
-├── pyproject.toml
-├── Dockerfile · Makefile · .gitignore
-└── .github/workflows/tests.yml
-```
-
----
-
 ## 📚 Notebooks
 
 | Notebook | Topics |
@@ -500,6 +470,25 @@ jupyter lab
 
 ---
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/EOCoreINT/pygeofetch/refs/heads/main/docs/images/trend_map.png?token=GHSAT0AAAAAAD4555HVK7XABUW65FV6B3N22S7TNMA" width="48%" />
+  <img src="https://raw.githubusercontent.com/EOCoreINT/pygeofetch/refs/heads/main/docs/images/trend_classification.png?token=GHSAT0AAAAAAD4555HVX7RLHLSCQSBSGCIY2S7TMFQ" width="48%" />
+</p>
+<p align="center"><em>NDVI trend (2018–2024) and severity classification for the Obuasi Municipal District, computed end-to-end with PyGeoFetch — real USGS Landsat data, boundary-clipped before processing.</em></p>
+
+32.0% of the Obuasi Municipal District shows measurable vegetation decline over 2018–2024 (9.2% strong decline + 22.8% moderate decline), against 57.5% stable and 10.5% showing an increasing trend.
+
+That headline number matters less than where it's concentrated. The decline isn't scattered randomly across the district — it forms a clear, spatially coherent cluster in the western portion of the AOI (roughly west of -1.70° longitude), visible as a dense, contiguous red-and-orange zone in both the trend map and the classification map. Real land degradation signals tend to look like this — clustered along mining concessions, roads, or river corridors — whereas sensor noise or processing artifacts tend to scatter more randomly across the whole scene. The fact that this pattern holds together spatially is a reasonable indicator that it reflects something real on the ground, not just pixel-level noise.
+
+That said, an NDVI trend map on its own can't distinguish why vegetation declined — illegal small-scale mining (galamsey), selective logging, agricultural land clearing, and urban expansion can all produce a similar signature. Given Obuasi's well-documented galamsey activity specifically concentrated in this district, the spatial pattern here is consistent with mining-driven clearance — but confirming that specific cause would need either higher-resolution imagery, ground verification, or cross-referencing against known concession boundaries, not this analysis alone.
+
+Two things worth flagging honestly rather than glossing over:
+
+The scattered dark-blue linear and blob features running through the map (most visibly the river-like feature crossing the upper-central area) are very likely water bodies, not vegetation gain. NDVI trend over open water isn't a meaningful signal — surface reflectance there is driven by turbidity and water level, not plant health — so those features should be excluded from the "increasing" interpretation, not read as reforestation.
+The small white gaps scattered through the trend map (several distinct circular patches) are nodata — pixels that didn't have enough valid, cloud-free observations across all six dates to fit a reliable trend. Worth being upfront that the 32%/57.5%/10.5% breakdown is computed over the valid pixels only, not the full district area including these gaps.
+
+The eastern two-thirds of the district, by contrast, is overwhelmingly stable (dominant green in the classification map), which is itself a useful negative result — it suggests the decline is genuinely localized to a specific area rather than reflecting a district-wide drought or seasonal artifact that would show up everywhere.
+
 ## 📋 Documentation
 
 Full documentation: **https://appiahkubis14.github.io/pygeofetch-docs/**
@@ -527,4 +516,4 @@ pytest tests/unit/ -v
 
 pygeofetch is free and open source software, licensed under the [MIT License](LICENSE).
 
-© 2025 pygeofetch Contributors. Part of the **PyGeoVision** platform — [pygeofetch](https://github.com/appiahkubis14/pygeofetch) (data + processing) + [GeoAI](https://opengeoai.org) (AI) = complete Earth observation pipeline.
+© 2026 pygeofetch Contributors. Part of the **PyGeoVision** platform — [pygeofetch](https://github.com/appiahkubis14/pygeofetch) (data + processing) + [GeoAI](https://opengeoai.org) (AI) = complete Earth observation pipeline.

{pygeofetch-1.1.0 → pygeofetch-1.3.0}/pygeofetch/__init__.py

@@ -1,5 +1,5 @@
 """
-PyGeoFetch v1.1.0 — Universal Satellite Data Pipeline.
+PyGeoFetch v1.0.0 — Universal Satellite Data Pipeline.
 
 Unified access to 22+ satellite data providers with a consistent
 Python API and CLI. Supports authentication management, federated search,
@@ -30,10 +30,40 @@ CLI::
     pygeofetch doctor
 """
 
-__version__ = "1.1.0"
+__version__ = "1.3.0"
 __author__ = "PyGeoFetch Contributors"
 __license__ = "MIT"
 
 from pygeofetch.core.engine import PyGeoFetch  # noqa: F401
 
 __all__ = ["PyGeoFetch", "__version__"]
+
+
+# Optional modules — lazy imported to avoid hard dependency errors
+def _lazy(module_path: str, name: str):
+    """Return a lazy accessor that imports on first use."""
+
+    def _get():
+        import importlib
+
+        mod = importlib.import_module(module_path)
+        return getattr(mod, name)
+
+    return _get
+
+
+# Convenience accessors (fail gracefully if optional deps not installed)
+try:
+    from pygeofetch.processor import BandStacker, DataLoader, SpectralIndex
+except ImportError:
+    DataLoader = SpectralIndex = BandStacker = None  # type: ignore[assignment,misc]
+
+try:
+    from pygeofetch.sar import SARProcessor as AdvancedSARProcessor
+except ImportError:
+    AdvancedSARProcessor = None  # type: ignore[assignment,misc]
+
+try:
+    from pygeofetch.viz import MapViewer, Plotter
+except ImportError:
+    MapViewer = Plotter = None  # type: ignore[assignment,misc]

{pygeofetch-1.1.0 → pygeofetch-1.3.0}/pygeofetch/cli/auth_commands.py

@@ -36,7 +36,9 @@ def auth() -> None:
 @click.argument("provider")
 @click.option("--username", "-u", default=None, help="Username or email.")
 @click.option("--password", "-p", default=None, help="Password (prompted if omitted).")
-@click.option("--api-key", "-k", default=None, help="API key (alternative to username/password).")
+@click.option(
+    "--api-key", "-k", default=None, help="API key (alternative to username/password)."
+)
 @click.option("--client-id", default=None, help="OAuth2 client ID.")
 @click.option("--client-secret", default=None, help="OAuth2 client secret.")
 @click.option("--token", default=None, help="Bearer token.")
@@ -121,9 +123,9 @@ def auth_login(provider: str) -> None:
     # Determine what to prompt based on auth type
     auth_type = caps.auth_type if hasattr(caps, "auth_type") else "username_password"
 
-    if auth_type in ("api_key",):
+    if auth_type == "api_key":
         creds["api_key"] = click.prompt("API Key", hide_input=True)
-    elif auth_type in ("oauth2_client",):
+    elif auth_type == "oauth2_client":
         creds["client_id"] = click.prompt("Client ID")
         creds["client_secret"] = click.prompt("Client Secret", hide_input=True)
     else:
@@ -139,7 +141,9 @@ def auth_login(provider: str) -> None:
     if click.confirm("Verify credentials now?", default=True):
         try:
             session = mgr.authenticate(provider)
-            console.print(f"[green]Authentication successful![/] Session expires: {session.expires_at}")
+            console.print(
+                f"[green]Authentication successful![/] Session expires: {session.expires_at}"
+            )
         except Exception as exc:
             console.print(f"[red]Authentication failed: {exc}[/]")
 
@@ -222,7 +226,9 @@ def auth_remove(provider: str, yes: bool) -> None:
 
 
 @auth.command(name="export")
-@click.option("--provider", default=None, help="Export only this provider (default: all).")
+@click.option(
+    "--provider", default=None, help="Export only this provider (default: all)."
+)
 @click.option(
     "--output",
     "-o",

{pygeofetch-1.1.0 → pygeofetch-1.3.0}/pygeofetch/cli/config_commands.py

@@ -30,6 +30,7 @@ def config() -> None:
 def config_show(as_json: bool) -> None:
     """Show the effective configuration (all layers merged)."""
     import json
+
     from pygeofetch.config.settings import get_settings
 
     settings = get_settings()
@@ -40,6 +41,7 @@ def config_show(as_json: bool) -> None:
         return
 
     import yaml
+
     rendered = yaml.dump(data, default_flow_style=False, sort_keys=True)
     console.print(Syntax(rendered, "yaml", theme="monokai"))
 
@@ -85,7 +87,7 @@ def config_set(key: str, value: str) -> None:
       pygeofetch config set download.parallel 4
       pygeofetch config set cache.ttl_seconds 7200
     """
-    from pygeofetch.config.settings import get_settings, save_user_config
+    from pygeofetch.config.settings import save_user_config
 
     # Try to coerce to typed value
     typed_value: object = value