PyGeoFetch 2.6.2.9__tar.gz → 2.6.4.0__tar.gz

{pygeofetch-2.6.2.9 → pygeofetch-2.6.4.0}/CHANGELOG.md

@@ -20,7 +20,7 @@ date, and marked accordingly rather than filled in with invented
 bullet points.
 ```
 
-## [Unreleased] — v2.6.2.9.4
+## [Unreleased] — v2.6.4.0.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.9.4] — 2026-08-25 (latest)
+## [2.6.4.0.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.9] — 2026-08-24
+## [2.6.4.0] — 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.9.4 — 2026-07-12"** describing 22+ providers, Sentinel-1C/1D
+**"2.6.4.0.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.9.4 was
+management, 17 spectral indices, and various bug fixes. **2.6.4.0.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.9.4`**, dated
-   2026-07-29 and 2026-07-12. **2.6.2.9.4 was only ever released once**,
+1. **Two different entries were both labeled `2.6.4.0.4`**, dated
+   2026-07-29 and 2026-07-12. **2.6.4.0.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.9/pygeofetch.egg-info → pygeofetch-2.6.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pygeofetch
-Version: 2.6.2.9
+Version: 2.6.4.0
 Summary: Universal satellite data pipeline + geospatial processing platform
 Author-email: Samuel Appiah Kubi <appiahkubis14@gmail.com>
 License: MIT License
@@ -43,6 +43,8 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic
+Requires-Dist: rich
 Requires-Dist: click>=8.1
 Requires-Dist: pydantic>=2.5
 Requires-Dist: pydantic-settings>=2.1
@@ -369,7 +371,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.9.1},
+  version      = {2.6.4.0.1},
   doi          = {10.5281/zenodo.22087230},
   url          = {https://doi.org/10.5281/zenodo.22087230}
 }

{pygeofetch-2.6.2.9 → pygeofetch-2.6.4.0}/README.md

@@ -229,7 +229,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.9.1},
+  version      = {2.6.4.0.1},
   doi          = {10.5281/zenodo.22087230},
   url          = {https://doi.org/10.5281/zenodo.22087230}
 }
@@ -263,4 +263,4 @@ pip install -e ".[test]" && pytest tests/ -v
 
 ## License
 
-MIT — see [LICENSE](LICENSE). © 2026 Samuel Appiah Kubi.
+MIT — see [LICENSE](LICENSE). © 2026 Samuel Appiah Kubi.

{pygeofetch-2.6.2.9 → pygeofetch-2.6.4.0}/pygeofetch/__init__.py

@@ -30,13 +30,16 @@ CLI::
     pygeofetch doctor
 """
 
-__version__ = "2.6.2.9.4"
+__version__ = "2.6.4.0.4"
 __author__ = "PyGeoFetch Contributors"
 __license__ = "MIT"
 
 from pygeofetch.core.engine import PyGeoFetch  # noqa: F401
+from pygeofetch.core.logging import (
+    quiet_logs,  # noqa: F401  (notebook-friendly logging)
+)
 
-__all__ = ["PyGeoFetch", "__version__"]
+__all__ = ["PyGeoFetch", "quiet_logs", "__version__"]
 
 
 # Optional modules — lazy imported to avoid hard dependency errors

pygeofetch-2.6.4.0/pygeofetch/cli/classify_commands.py

@@ -0,0 +1,174 @@
+"""CLI commands for pixel classification."""
+
+from __future__ import annotations
+
+import sys
+
+import click
+from rich.console import Console
+
+# from pygeofetch.cli.index_commands import clip_options, _parse_bbox
+
+console = Console()
+
+
+def _engine():
+    from pygeofetch.core.engine import PyGeoFetch
+
+    return PyGeoFetch(log_level="WARNING")
+
+
+def _pr(result, name):
+    if result.success:
+        size_mb = (
+            result.output_path.stat().st_size / (1024 * 1024)
+            if result.output_path and result.output_path.exists()
+            else 0
+        )
+        console.print(
+            f"[green]✓[/] {name} → {result.output_path}"
+            f" ({size_mb:.1f} MB, {result.duration_seconds:.2f}s)"
+        )
+        meta = result.metadata or {}
+        for k, v in meta.items():
+            if k != "classification_report":
+                console.print(f"  {k}: {v}")
+    else:
+        console.print(f"[red]✗[/] {name} failed: {result.error}")
+        sys.exit(1)
+
+
+@click.group()
+def classify() -> None:
+    """Pixel classification — unsupervised K-means and supervised Random Forest/SVM."""
+
+
+@classify.command("kmeans")
+@click.argument("inputs", nargs=-1, type=click.Path(exists=True))
+@click.option(
+    "--clusters",
+    "-k",
+    default=5,
+    show_default=True,
+    type=int,
+    help="Number of clusters.",
+)
+@click.option("--output", "-o", default=None)
+@click.option("--random-state", default=42, show_default=True, type=int)
+# @clip_options
+def kmeans_cmd(inputs, clusters, output, random_state, bbox, geometry, geometry_crs):
+    """Unsupervised K-means clustering. No training data needed.
+
+    Example: pygeofetch classify kmeans B02.tif B03.tif B04.tif B08.tif -k 5
+    """
+    if len(inputs) < 1:
+        console.print("[red]Provide at least 1 input band raster[/]")
+        sys.exit(1)
+    e = _engine()
+    r = e.classify.kmeans(
+        inputs=list(inputs),
+        n_clusters=clusters,
+        output=output,
+        random_state=random_state,
+        bbox=bbox,
+        geometry=geometry,
+        geometry_crs=geometry_crs,
+    )
+    _pr(r, f"K-means ({clusters} clusters)")
+
+
+@classify.command("train")
+@click.argument("inputs", nargs=-1, type=click.Path(exists=True))
+@click.option(
+    "--training-data",
+    required=True,
+    type=click.Path(exists=True),
+    help="Vector file (GeoJSON/Shapefile) with labeled training geometries.",
+)
+@click.option(
+    "--class-field",
+    required=True,
+    help="Attribute column holding the real class label.",
+)
+@click.option(
+    "--output-model", "-o", required=True, help="Where to save the trained model."
+)
+@click.option(
+    "--model-type",
+    default="random_forest",
+    type=click.Choice(["random_forest", "svm"]),
+    show_default=True,
+)
+@click.option(
+    "--n-estimators",
+    default=100,
+    show_default=True,
+    type=int,
+    help="Random Forest tree count.",
+)
+@click.option(
+    "--test-size",
+    default=0.2,
+    show_default=True,
+    type=float,
+    help="Fraction of samples held out for real accuracy reporting.",
+)
+def train_cmd(
+    inputs,
+    training_data,
+    class_field,
+    output_model,
+    model_type,
+    n_estimators,
+    test_size,
+):
+    """Train a supervised classifier from labeled vector training samples.
+
+    Example: pygeofetch classify train B02.tif B03.tif B04.tif B08.tif
+              --training-data samples.geojson --class-field land_cover -o model.joblib
+    """
+    if len(inputs) < 1:
+        console.print("[red]Provide at least 1 input band raster[/]")
+        sys.exit(1)
+    e = _engine()
+    r = e.classify.train(
+        inputs=list(inputs),
+        training_data=training_data,
+        class_field=class_field,
+        output_model=output_model,
+        model_type=model_type,
+        n_estimators=n_estimators,
+        test_size=test_size,
+    )
+    _pr(r, f"train ({model_type})")
+
+
+@classify.command("predict")
+@click.argument("inputs", nargs=-1, type=click.Path(exists=True))
+@click.option(
+    "--model",
+    "-m",
+    required=True,
+    type=click.Path(exists=True),
+    help="A model trained via 'classify train'.",
+)
+@click.option("--output", "-o", default=None)
+# @clip_options
+def predict_cmd(inputs, model, output, bbox, geometry, geometry_crs):
+    """Apply a trained model to a real raster stack, producing a classification map.
+
+    Example: pygeofetch classify predict B02.tif B03.tif B04.tif B08.tif -m model.joblib
+    """
+    if len(inputs) < 1:
+        console.print("[red]Provide at least 1 input band raster[/]")
+        sys.exit(1)
+    e = _engine()
+    r = e.classify.predict(
+        inputs=list(inputs),
+        model=model,
+        output=output,
+        bbox=bbox,
+        geometry=geometry,
+        geometry_crs=geometry_crs,
+    )
+    _pr(r, "predict")