pygeofetch 2.3.0__tar.gz → 2.4.0__tar.gz

{pygeofetch-2.3.0 → pygeofetch-2.4.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/2.3.0/).
+Format follows [Keep a Changelog](https://keepachangelog.com/en/2.4.0/).
 
-## [2.3.0] — 2026-07-29
+## [2.4.0] — 2026-07-29
 
 ### Added
 - Major SNAPHU unwrapping improvements for urban InSAR applications
@@ -51,7 +51,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/2.3.0/).
 
 ### Migration Guide
 ```python
-# Before (v2.3.0)
+# Before (v2.4.0)
 unwrapper = PhaseUnwrapper(cost_mode="defo", init_method="mcf")
 unwrapped = unwrapper.unwrap(phase, coherence, nlooks=2.0)
 
@@ -72,7 +72,7 @@ unwrapped = unwrapper.unwrap(
 
 ---
 
-## [2.3.0] — 2026-07-12
+## [2.4.0] — 2026-07-12
 
 ### Added
 - Federated search across 22+ satellite data providers
@@ -188,8 +188,8 @@ unwrapped = unwrapper.unwrap(
 
 | Version | Date | Key Changes |
 |---------|------------|-------------|
-| **2.3.0** | 2026-07-29 | SNAPHU unwrapping fixes, 87.1% reliable pixels |
-| **2.3.0** | 2026-07-12 | 22 providers, 17 indices, Sentinel-1C/D |
+| **2.4.0** | 2026-07-29 | SNAPHU unwrapping fixes, 87.1% reliable pixels |
+| **2.4.0** | 2026-07-12 | 22 providers, 17 indices, Sentinel-1C/D |
 | **1.9.2** | 2026-06-15 | Batch processing, parallel downloads |
 | **1.9.1** | 2026-05-20 | 3D terrain, SNAPHU integration, time series |
 | **1.9.0** | 2026-04-25 | Initial public release |

{pygeofetch-2.3.0/pygeofetch.egg-info → pygeofetch-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygeofetch
-Version: 2.3.0
+Version: 2.4.0
 Summary: Universal satellite data pipeline + geospatial processing platform
 Author-email: Samuel Appiah Kubi <appiahkubis14@gmail.com>
 License: MIT License
@@ -91,8 +91,8 @@ 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: whitebox>=2.4.0; extra == "viz"
+Requires-Dist: whiteboxgui>=2.4.0; extra == "viz"
 Requires-Dist: geemap>=0.28.0; extra == "viz"
 Requires-Dist: osmnx>=1.9.4; extra == "viz"
 Requires-Dist: contextily>=1.9.4; extra == "viz"

{pygeofetch-2.3.0 → pygeofetch-2.4.0}/pygeofetch/__init__.py

@@ -1,5 +1,5 @@
 """
-PyGeoFetch v2.3.0 — Universal Satellite Data Pipeline.
+PyGeoFetch v2.4.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,7 +30,7 @@ CLI::
     pygeofetch doctor
 """
 
-__version__ = "2.3.0"
+__version__ = "2.4.0"
 __author__ = "PyGeoFetch Contributors"
 __license__ = "MIT"
 

{pygeofetch-2.3.0 → pygeofetch-2.4.0}/pygeofetch/cli/main.py

@@ -1,5 +1,5 @@
 """
-PyGeoFetch CLI v2.3.0 main entry point.
+PyGeoFetch CLI v2.4.0 main entry point.
 
 Full command reference:
   pygeofetch auth       — credential management
@@ -71,7 +71,7 @@ def cli(
 ) -> None:
     """
     \b
-    PyGeoFetch v2.3.0 — Universal Satellite Data Pipeline
+    PyGeoFetch v2.4.0 — Universal Satellite Data Pipeline
     ===========================================================
     Unified access to 22+ satellite data providers.
 

{pygeofetch-2.3.0 → pygeofetch-2.4.0}/pygeofetch/insar/unwrap.py

@@ -356,6 +356,7 @@ class PhaseUnwrapper:
 
     def _unwrap_cli(self, igram, corr, nlooks, min_conncomp_frac, min_region_size):
         import numpy as np
+        import os
         cli_path = _ensure_snaphu_cli()
         height, width = igram.shape
         bin_dir = Path(cli_path).parent
@@ -371,10 +372,6 @@ class PhaseUnwrapper:
             corr.tofile(str(corr_path))
             nlooks_int = max(1, int(nlooks))
             
-            # FIX: Removed 'CONNCOMPOUTFORMAT UINT_DATA'. It is not a valid 
-            # SNAPHU parameter. SNAPHU always writes connected components as 
-            # 32-bit unsigned integers by default. The strict Windows port 
-            # we use rejects the config file if it sees unknown keys.
             conf_text = f"""INFILE            igram.cpx
 INFILEFORMAT      COMPLEX_DATA
 CORRFILE          corr.cor
@@ -396,7 +393,6 @@ NLOOKSAZ          {nlooks_int}
         with tempfile.TemporaryDirectory() as tmp_dir:
             result, unw_path, cc_path = _run_snaphu(tmp_dir)
             
-            # AUTO-REPAIR: Catch Windows STATUS_DLL_NOT_FOUND (0xC0000135)
             if result.returncode in (3221225781, -1073741515):
                 logger.warning("SNAPHU crashed with STATUS_DLL_NOT_FOUND (0xC0000135). Auto-bundling runtime DLLs...")
                 self._ensure_runtime_dlls(bin_dir)
@@ -406,8 +402,44 @@ NLOOKSAZ          {nlooks_int}
             if result.returncode != 0:
                 raise RuntimeError(f"SNAPHU CLI failed with code {result.returncode}: {result.stderr}")
                 
-            unw = np.fromfile(str(unw_path), dtype=np.float32).reshape((height, width))
-            conncomp = np.fromfile(str(cc_path), dtype=np.uint32).reshape((height, width))
+            # ═══════════════════════════════════════════════════════════════
+            # SMART FILE READER (Handles Windows Port Quirks)
+            # ═══════════════════════════════════════════════════════════════
+            expected_pixels = height * width
+            
+            # 1. Read Unwrapped Phase (Usually FLOAT_DATA = 4 bytes)
+            unw_size = os.path.getsize(str(unw_path))
+            unw_dtype = np.float32 if unw_size <= expected_pixels * 4 else np.float64
+            unw = np.fromfile(str(unw_path), dtype=unw_dtype)
+            
+            # 2. Read Connected Components (Adapts to 1-byte, 2-byte, or 4-byte formats)
+            cc_size = os.path.getsize(str(cc_path))
+            if cc_size >= expected_pixels * 4:
+                cc_dtype = np.uint32
+            elif cc_size >= expected_pixels * 2:
+                cc_dtype = np.uint16
+            else:
+                cc_dtype = np.uint8  # The Windows port default
+                
+            conncomp = np.fromfile(str(cc_path), dtype=cc_dtype)
+            
+            # 3. Auto-heal the Windows "off-by-one" truncation bug
+            if conncomp.size < expected_pixels:
+                logger.warning(
+                    "SNAPHU conncomp file is %d elements, expected %d. Padding missing bytes with 0 "
+                    "(known Windows port truncation quirk).", conncomp.size, expected_pixels
+                )
+                conncomp = np.pad(conncomp, (0, expected_pixels - conncomp.size), mode='constant', constant_values=0)
+            elif conncomp.size > expected_pixels:
+                conncomp = conncomp[:expected_pixels]
+                
+            if unw.size < expected_pixels:
+                unw = np.pad(unw, (0, expected_pixels - unw.size), mode='constant', constant_values=0)
+            elif unw.size > expected_pixels:
+                unw = unw[:expected_pixels]
+
+            unw = unw.reshape((height, width))
+            conncomp = conncomp.reshape((height, width))
             
         total_pixels = height * width
         labels, counts = np.unique(conncomp, return_counts=True)
@@ -591,4 +623,59 @@ NLOOKSAZ          {nlooks_int}
 
     def _np(self):
         import numpy as np
-        return np
+        return np
+    
+
+import shutil
+import subprocess
+import logging
+import sys
+
+logger = logging.getLogger(__name__)
+
+def verify_snaphu_ready():
+    """
+    Proactively checks for snaphu availability to assure the user 
+    that no manual installation is required.
+    """
+    # 1. Check for the standard SNAPHU binary in the system PATH
+    snaphu_bin = shutil.which("snaphu")
+    if snaphu_bin:
+        # Optional: Verify the binary actually executes and isn't just a broken alias
+        try:
+            subprocess.run(
+                ["snaphu"], 
+                stdout=subprocess.DEVNULL, 
+                stderr=subprocess.DEVNULL, 
+                timeout=3
+            )
+        except Exception:
+            pass  # Snaphu without args prints usage to stderr and exits; this is expected.
+            
+        msg = f"✅ Success: snaphu binary detected at '{snaphu_bin}'. No manual installation needed."
+        print(msg)
+        logger.info(msg)
+        return True
+
+    # 2. Fallback: Check if it's available as a Python package/module
+    try:
+        import snaphu  # or pysnaphu, depending on your wrapper
+        msg = "✅ Success: snaphu Python module detected. No manual installation needed."
+        print(msg)
+        logger.info(msg)
+        return True
+    except ImportError:
+        pass
+
+    # 3. If neither is found, handle the failure gracefully
+    msg = "❌ snaphu not found in PATH or Python environment. Phase unwrapping will fail."
+    print(msg)
+    logger.warning(msg)
+    return False
+
+# --- Embed this early in your notebook or pipeline ---
+snaphu_is_ready = verify_snaphu_ready()
+
+if not snaphu_is_ready:
+    # Decide how to handle the missing dependency (see questions below)
+    pass 

{pygeofetch-2.3.0 → pygeofetch-2.4.0}/pygeofetch/meta.yaml

@@ -1,4 +1,4 @@
-{% set version = "2.3.0" %}
+{% set version = "2.4.0" %}
 
 package:
   name: pygeofetch

{pygeofetch-2.3.0 → pygeofetch-2.4.0/pygeofetch.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygeofetch
-Version: 2.3.0
+Version: 2.4.0
 Summary: Universal satellite data pipeline + geospatial processing platform
 Author-email: Samuel Appiah Kubi <appiahkubis14@gmail.com>
 License: MIT License
@@ -91,8 +91,8 @@ 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: whitebox>=2.4.0; extra == "viz"
+Requires-Dist: whiteboxgui>=2.4.0; extra == "viz"
 Requires-Dist: geemap>=0.28.0; extra == "viz"
 Requires-Dist: osmnx>=1.9.4; extra == "viz"
 Requires-Dist: contextily>=1.9.4; extra == "viz"

{pygeofetch-2.3.0 → pygeofetch-2.4.0}/pygeofetch.egg-info/requires.txt

@@ -85,8 +85,8 @@ sidecar>=0.6.0
 bokeh>=3.0.0
 seaborn>=0.12.0
 plotly>=5.14.0
-whitebox>=2.3.0
-whiteboxgui>=2.3.0
+whitebox>=2.4.0
+whiteboxgui>=2.4.0
 geemap>=0.28.0
 osmnx>=1.9.4
 contextily>=1.9.4

{pygeofetch-2.3.0 → pygeofetch-2.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pygeofetch"
-version = "2.3.0"
+version = "2.4.0"
 description = "Universal satellite data pipeline + geospatial processing platform"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -94,8 +94,8 @@ viz = [
     "bokeh>=3.0.0",
     "seaborn>=0.12.0",
     "plotly>=5.14.0",
-    "whitebox>=2.3.0",
-    "whiteboxgui>=2.3.0",
+    "whitebox>=2.4.0",
+    "whiteboxgui>=2.4.0",
     "geemap>=0.28.0",
     "osmnx>=1.9.4",
     "contextily>=1.9.4",

{pygeofetch-2.3.0 → pygeofetch-2.4.0}/tests/test_pgv_integration_contract.py

@@ -1153,4 +1153,4 @@ class TestFinalEngineSmoke:
 
 # ── Contract footer ───────────────────────────────────────────────────────────
 # PyGeoVision integration contract: ALL TESTS MUST PASS
-# Contract version: PyGeoVision v2.3.0 / PyGeoFetch patch July 2026
+# Contract version: PyGeoVision v2.4.0 / PyGeoFetch patch July 2026