PyGeoFetch 2.6.2.4__tar.gz → 2.6.2.5__tar.gz

{pygeofetch-2.6.2.4 → pygeofetch-2.6.2.5}/CHANGELOG.md

@@ -20,7 +20,7 @@ date, and marked accordingly rather than filled in with invented
 bullet points.
 ```
 
-## [Unreleased] — v2.6.2.4.4
+## [Unreleased] — v2.6.2.5.4
 
 ```{note}
 Not yet published to PyPI. This entry documents work completed and
@@ -130,7 +130,7 @@ audit and remain open for a follow-up pass.
 
 ---
 
-## [2.6.2.4.4] — 2026-08-25 (latest)
+## [2.6.2.5.4] — 2026-08-25 (latest)
 
 Confirmed via direct fetch of the current PyPI listing.
 
@@ -149,7 +149,7 @@ Confirmed via direct fetch of the current PyPI listing.
 - `SearchQuery.sort_ascending: bool` — earlier examples showed a `sort_order: "asc"/"desc"` string field that doesn't exist on the model (the CLI's `--sort-order` flag does convert to this internally, so CLI docs were unaffected)
 - `DownloadOptions.post_process` requires a list of `PostProcessAction` objects — passing plain strings raises a real `pydantic.ValidationError`
 
-## [2.6.2.4] — 2026-08-24
+## [2.6.2.5] — 2026-08-24
 Real, verified release. Detailed notes not independently recovered from PyPI's release-history page (no distinct per-version notes exposed for this release specifically).
 
 ## [2.6.1] — 2026-08-22
@@ -261,9 +261,9 @@ recovered.
 
 ```{note}
 The previous version of this changelog had an entry labeled
-**"2.6.2.4.4 — 2026-07-12"** describing 22+ providers, Sentinel-1C/1D
+**"2.6.2.5.4 — 2026-07-12"** describing 22+ providers, Sentinel-1C/1D
 support, SLC search with provider routing, precise orbit file
-management, 17 spectral indices, and various bug fixes. **2.6.2.4.4 was
+management, 17 spectral indices, and various bug fixes. **2.6.2.5.4 was
 only ever released once, on 2026-08-25** — it was never released on
 2026-07-12. The date matches this real release, **1.0.8**, exactly.
 That content is reproduced below under the version it actually
@@ -406,8 +406,8 @@ The version of this file uploaded for this update had **5 entries
 covering 5 dates**. PyPI's real release history has **54 releases**.
 Specific issues found and fixed:
 
-1. **Two different entries were both labeled `2.6.2.4.4`**, dated
-   2026-07-29 and 2026-07-12. **2.6.2.4.4 was only ever released once**,
+1. **Two different entries were both labeled `2.6.2.5.4`**, dated
+   2026-07-29 and 2026-07-12. **2.6.2.5.4 was only ever released once**,
    on 2026-08-25 (confirmed directly from the live PyPI listing).
 2. **The 2026-07-12 entry's date exactly matches a real release**
    — version **1.0.8** — and its content (22+ providers, Sentinel-1C/D,

{pygeofetch-2.6.2.4/pygeofetch.egg-info → pygeofetch-2.6.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygeofetch
-Version: 2.6.2.4
+Version: 2.6.2.5
 Summary: Universal satellite data pipeline + geospatial processing platform
 Author-email: Samuel Appiah Kubi <appiahkubis14@gmail.com>
 License: MIT License
@@ -71,8 +71,6 @@ 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"
 Provides-Extra: insar
@@ -130,12 +128,12 @@ Requires-Dist: mypy>=1.8; extra == "dev"
 Requires-Dist: build>=1.0; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
 Provides-Extra: test
-Requires-Dist: pygeofetch[dev,geo,insar]; extra == "test"
+Requires-Dist: pygeofetch[cloud,dev,geo,insar]; extra == "test"
 Provides-Extra: insar-full
 Requires-Dist: snaphu>=0.1; extra == "insar-full"
 Requires-Dist: scipy>=1.12; extra == "insar-full"
 Provides-Extra: full
-Requires-Dist: pygeofetch[cloud,geo,insar,notebook,processor,providers,schedule,viz]; extra == "full"
+Requires-Dist: pygeofetch[cloud,geo,insar,notebook,processor,schedule,viz]; extra == "full"
 Provides-Extra: all
 Requires-Dist: pygeofetch[full]; extra == "all"
 Dynamic: license-file
@@ -153,9 +151,6 @@ Dynamic: license-file
 
 [Quick Start](#-quick-start) · [Mexico City Case Study](#-case-study-mapping-mexico-city-land-subsidence-with-insar) · [Case Study Repo ↗](https://github.com/EOCoreINT/mexico-subsidence-project) · [Documentation](https://pygeofetch.readthedocs.io/en/latest/) · [Notebooks](#-notebooks)
 
-<!-- <br>
-<img src="https://raw.githubusercontent.com/EOCoreINT/pygeofetch/refs/heads/main/icon/concept_a.png" alt="PyGeoFetch Logo" width="350">
-<br> -->
 
 </div>
 
@@ -386,7 +381,7 @@ If you use PyGeoFetch in your research or operational work, please cite it using
   title        = {PyGeoFetch: A Unified Python Framework for Multi-Provider Satellite Data Acquisition, Pre-download Quality Control, and Geospatial Processing},
   year         = {2026},
   publisher    = {Zenodo},
-  version      = {2.6.2.4.1},
+  version      = {2.6.2.5.1},
   doi          = {10.5281/zenodo.22087230},
   url          = {https://doi.org/10.5281/zenodo.22087230}
 }

{pygeofetch-2.6.2.4 → pygeofetch-2.6.2.5}/README.md

@@ -11,9 +11,6 @@
 
 [Quick Start](#-quick-start) · [Mexico City Case Study](#-case-study-mapping-mexico-city-land-subsidence-with-insar) · [Case Study Repo ↗](https://github.com/EOCoreINT/mexico-subsidence-project) · [Documentation](https://pygeofetch.readthedocs.io/en/latest/) · [Notebooks](#-notebooks)
 
-<!-- <br>
-<img src="https://raw.githubusercontent.com/EOCoreINT/pygeofetch/refs/heads/main/icon/concept_a.png" alt="PyGeoFetch Logo" width="350">
-<br> -->
 
 </div>
 
@@ -244,7 +241,7 @@ If you use PyGeoFetch in your research or operational work, please cite it using
   title        = {PyGeoFetch: A Unified Python Framework for Multi-Provider Satellite Data Acquisition, Pre-download Quality Control, and Geospatial Processing},
   year         = {2026},
   publisher    = {Zenodo},
-  version      = {2.6.2.4.1},
+  version      = {2.6.2.5.1},
   doi          = {10.5281/zenodo.22087230},
   url          = {https://doi.org/10.5281/zenodo.22087230}
 }

{pygeofetch-2.6.2.4 → pygeofetch-2.6.2.5}/pygeofetch/__init__.py

@@ -30,7 +30,7 @@ CLI::
     pygeofetch doctor
 """
 
-__version__ = "2.6.2.4.4"
+__version__ = "2.6.2.5.4"
 __author__ = "PyGeoFetch Contributors"
 __license__ = "MIT"
 

{pygeofetch-2.6.2.4 → pygeofetch-2.6.2.5}/pygeofetch/cli/main.py

@@ -26,6 +26,7 @@ from pygeofetch.cli.auth_commands import auth
 from pygeofetch.cli.config_commands import config
 from pygeofetch.cli.download_commands import download
 from pygeofetch.cli.index_commands import index
+from pygeofetch.cli.multisensor_commands import multisensor
 from pygeofetch.cli.optical_commands import optical
 from pygeofetch.cli.pipeline_process_commands import proc_pipeline
 from pygeofetch.cli.postprocess_commands import post
@@ -105,6 +106,7 @@ cli.add_command(post)
 cli.add_command(sar)
 cli.add_command(proc_pipeline)
 cli.add_command(optical)
+cli.add_command(multisensor)
 
 
 # ---------------------------------------------------------------------------
@@ -921,4 +923,4 @@ def main() -> None:
 
 
 if __name__ == "__main__":
-    main()
+    main()

pygeofetch-2.6.2.5/pygeofetch/cli/multisensor_commands.py

@@ -0,0 +1,243 @@
+"""CLI access to pygeofetch's 5 real multi-sensor pipelines."""
+
+from __future__ import annotations
+
+import json
+
+import click
+
+
+@click.group()
+def multisensor() -> None:
+    """Multi-sensor fusion pipelines: InSAR+optical, SAR+optical flood
+    mapping, terrain-corrected change, DEM differencing, vegetation
+    disturbance. See docs/processing/multi-sensor-pipelines.md."""
+
+
+def _print_result(result) -> None:
+    if result.success:
+        click.echo(f"✓ Success -> {result.final_output}")
+        if result.metadata:
+            click.echo(
+                json.dumps(
+                    {k: str(v) for k, v in result.metadata.items()},
+                    indent=2,
+                )
+            )
+    else:
+        click.echo(f"✗ Failed: {result.error}", err=True)
+        raise SystemExit(1)
+
+
+@multisensor.command("insar-optical-fusion")
+@click.option("--insar-velocity", required=True, type=click.Path(exists=True))
+@click.option("--insar-coherence", required=True, type=click.Path(exists=True))
+@click.option("--optical-ref", required=True, type=click.Path(exists=True))
+@click.option("--optical-sec", required=True, type=click.Path(exists=True))
+@click.option("--output-dir", required=True, type=click.Path())
+@click.option("--window-size", default=64, show_default=True, type=int)
+@click.option("--step-size", default=16, show_default=True, type=int)
+@click.option("--snr-threshold", default=3.0, show_default=True, type=float)
+@click.option("--coherence-low", default=0.4, show_default=True, type=float)
+@click.option("--coherence-high", default=0.6, show_default=True, type=float)
+@click.option("--cloud-mask", default=None, type=click.Path(exists=True))
+def insar_optical_fusion_cmd(
+    insar_velocity,
+    insar_coherence,
+    optical_ref,
+    optical_sec,
+    output_dir,
+    window_size,
+    step_size,
+    snr_threshold,
+    coherence_low,
+    coherence_high,
+    cloud_mask,
+):
+    """Fuse InSAR displacement with optical pixel offset tracking."""
+    from pygeofetch.multisensor import insar_optical_displacement_pipeline
+
+    result = insar_optical_displacement_pipeline(
+        insar_velocity,
+        insar_coherence,
+        optical_ref,
+        optical_sec,
+        output_dir,
+        cloud_mask_path=cloud_mask,
+        window_size=window_size,
+        step_size=step_size,
+        snr_threshold=snr_threshold,
+        coherence_low=coherence_low,
+        coherence_high=coherence_high,
+    )
+    _print_result(result)
+
+
+@multisensor.command("flood-map")
+@click.option("--sar", "sar_input", required=True, type=click.Path(exists=True))
+@click.option("--optical-green", required=True, type=click.Path(exists=True))
+@click.option("--optical-nir", required=True, type=click.Path(exists=True))
+@click.option("--output-dir", required=True, type=click.Path())
+@click.option("--sar-reference", default=None, type=click.Path(exists=True))
+@click.option("--sar-threshold", default=-15.0, show_default=True, type=float)
+@click.option("--ndwi-threshold", default=0.0, show_default=True, type=float)
+@click.option("--cloud-mask", default=None, type=click.Path(exists=True))
+@click.option(
+    "--fusion-mode",
+    default="cloud_aware",
+    show_default=True,
+    type=click.Choice(["cloud_aware", "union", "intersection"]),
+)
+def flood_map_cmd(
+    sar_input,
+    optical_green,
+    optical_nir,
+    output_dir,
+    sar_reference,
+    sar_threshold,
+    ndwi_threshold,
+    cloud_mask,
+    fusion_mode,
+):
+    """Fuse SAR and optical NDWI for flood/water extent mapping."""
+    from pygeofetch.multisensor import multi_sensor_flood_pipeline
+    from pygeofetch.sar import SARProcessor
+
+    result = multi_sensor_flood_pipeline(
+        SARProcessor(),
+        sar_input,
+        optical_green,
+        optical_nir,
+        output_dir,
+        sar_reference_path=sar_reference,
+        sar_threshold=sar_threshold,
+        optical_ndwi_threshold=ndwi_threshold,
+        cloud_mask_path=cloud_mask,
+        fusion_mode=fusion_mode,
+    )
+    _print_result(result)
+
+
+@multisensor.command("terrain-change")
+@click.option("--pre", "pre_path", required=True, type=click.Path(exists=True))
+@click.option("--post", "post_path", required=True, type=click.Path(exists=True))
+@click.option("--dem", "dem_path", required=True, type=click.Path(exists=True))
+@click.option(
+    "--pre-datetime",
+    required=True,
+    help="Real UTC ISO datetime, e.g. 2024-01-15T10:30:00",
+)
+@click.option("--post-datetime", required=True, help="Real UTC ISO datetime")
+@click.option("--lat", "latitude", required=True, type=float)
+@click.option("--lon", "longitude", required=True, type=float)
+@click.option("--output-dir", required=True, type=click.Path())
+@click.option("--change-threshold", default=0.1, show_default=True, type=float)
+def terrain_change_cmd(
+    pre_path,
+    post_path,
+    dem_path,
+    pre_datetime,
+    post_datetime,
+    latitude,
+    longitude,
+    output_dir,
+    change_threshold,
+):
+    """Terrain-corrected optical change detection (removes real
+    illumination artifacts using each date's own solar position)."""
+    from datetime import datetime, timezone
+
+    from pygeofetch.multisensor import terrain_corrected_change_pipeline
+
+    def _parse(dt_str):
+        dt = datetime.fromisoformat(dt_str)
+        return dt if dt.tzinfo else dt.replace(tzinfo=timezone.utc)
+
+    result = terrain_corrected_change_pipeline(
+        pre_path,
+        post_path,
+        dem_path,
+        _parse(pre_datetime),
+        _parse(post_datetime),
+        latitude,
+        longitude,
+        output_dir,
+        change_threshold=change_threshold,
+    )
+    _print_result(result)
+
+
+@multisensor.command("dem-diff")
+@click.option("--dem-old", required=True, type=click.Path(exists=True))
+@click.option("--dem-new", required=True, type=click.Path(exists=True))
+@click.option("--output-dir", required=True, type=click.Path())
+@click.option(
+    "--old-rmse",
+    default=1.0,
+    show_default=True,
+    type=float,
+    help="Real vertical RMSE of the old DEM, metres.",
+)
+@click.option(
+    "--new-rmse",
+    default=1.0,
+    show_default=True,
+    type=float,
+    help="Real vertical RMSE of the new DEM, metres.",
+)
+@click.option("--confidence-t", default=1.96, show_default=True, type=float)
+def dem_diff_cmd(dem_old, dem_new, output_dir, old_rmse, new_rmse, confidence_t):
+    """DEM-of-Difference volumetric change analysis."""
+    from pygeofetch.multisensor import dem_differencing_pipeline
+
+    result = dem_differencing_pipeline(
+        dem_old,
+        dem_new,
+        output_dir,
+        dem_old_vertical_rmse_m=old_rmse,
+        dem_new_vertical_rmse_m=new_rmse,
+        confidence_t_value=confidence_t,
+    )
+    _print_result(result)
+
+
+@multisensor.command("vegetation-disturbance")
+@click.option("--red-pre", required=True, type=click.Path(exists=True))
+@click.option("--nir-pre", required=True, type=click.Path(exists=True))
+@click.option("--red-post", required=True, type=click.Path(exists=True))
+@click.option("--nir-post", required=True, type=click.Path(exists=True))
+@click.option("--slc-pre", required=True, type=click.Path(exists=True))
+@click.option("--slc-post", required=True, type=click.Path(exists=True))
+@click.option("--output-dir", required=True, type=click.Path())
+@click.option("--ndvi-drop-threshold", default=0.15, show_default=True, type=float)
+@click.option("--coherence-threshold", default=0.3, show_default=True, type=float)
+@click.option("--coherence-window", default=7, show_default=True, type=int)
+def vegetation_disturbance_cmd(
+    red_pre,
+    nir_pre,
+    red_post,
+    nir_post,
+    slc_pre,
+    slc_post,
+    output_dir,
+    ndvi_drop_threshold,
+    coherence_threshold,
+    coherence_window,
+):
+    """Classify visible canopy loss vs. real sub-canopy ground
+    disturbance, from optical NDVI + SAR coherence."""
+    from pygeofetch.multisensor import vegetation_disturbance_pipeline
+
+    result = vegetation_disturbance_pipeline(
+        red_pre,
+        nir_pre,
+        red_post,
+        nir_post,
+        slc_pre,
+        slc_post,
+        output_dir,
+        ndvi_drop_threshold=ndvi_drop_threshold,
+        coherence_threshold=coherence_threshold,
+        coherence_window=coherence_window,
+    )
+    _print_result(result)

{pygeofetch-2.6.2.4 → pygeofetch-2.6.2.5}/pygeofetch/core/engine.py

@@ -348,7 +348,6 @@ class PyGeoFetch:
         "alaska_satellite_facility",
         "asf_vertex",
         "asf",
-        "eodag",
         "copernicus_dataspace",
         "nasa_earthdata",
     }
@@ -724,4 +723,4 @@ class PyGeoFetch:
 
     def __repr__(self) -> str:
         authed = [item["provider"] for item in self.auth.list()]
-        return f"PyGeoFetch(authenticated={authed}, cache_entries={len(self.searcher.cache._cache)})"
+        return f"PyGeoFetch(authenticated={authed}, cache_entries={len(self.searcher.cache._cache)})"