easy-eo 0.3.0__tar.gz → 0.4.0__tar.gz

{easy_eo-0.3.0 → easy_eo-0.4.0}/.gitignore

@@ -21,6 +21,12 @@ others/
 # Docs
 docs/build/
 
+# Generated by the dependency-audit, release, and linkcheck workflows
+# (and by running any of them locally)
+requirements-audit.txt
+.smoke-venv/
+.linkcheck/
+
 # Tests
 .pytest_cache/
 .ruff_cache/

{easy_eo-0.3.0 → easy_eo-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: easy-eo
-Version: 0.3.0
+Version: 0.4.0
 Summary: A lightweight Earth Observation utilities library for chainable raster operations
 Project-URL: Homepage, https://github.com/tommy-burns/easy-eo
 Project-URL: Repository, https://github.com/tommy-burns/easy-eo
@@ -40,6 +40,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: geopandas<2,>=1.1
 Requires-Dist: matplotlib>=3.8
@@ -65,13 +66,40 @@ Description-Content-Type: text/markdown
   <img src="https://raw.githubusercontent.com/Tommy-Burns/easy-eo/main/.github/assets/eeo_logo.png" alt="Easy-EO logo" width="200">
 </p>
 
-[![CI](https://github.com/Tommy-Burns/easy-eo/actions/workflows/ci.yml/badge.svg)](https://github.com/Tommy-Burns/easy-eo/actions/workflows/ci.yml)
-[![codecov](https://codecov.io/gh/Tommy-Burns/easy-eo/branch/main/graph/badge.svg)](https://codecov.io/gh/Tommy-Burns/easy-eo)
-[![PyPI](https://img.shields.io/pypi/v/easy-eo.svg)](https://pypi.org/project/easy-eo/)
-[![conda-forge](https://img.shields.io/conda/vn/conda-forge/easy-eo.svg)](https://anaconda.org/conda-forge/easy-eo)
-[![Python versions](https://img.shields.io/pypi/pyversions/easy-eo.svg)](https://pypi.org/project/easy-eo/)
-[![Documentation Status](https://readthedocs.org/projects/easy-eo/badge/?version=latest)](https://easy-eo.readthedocs.io/en/latest/?badge=latest)
-[![License: MIT](https://img.shields.io/github/license/Tommy-Burns/easy-eo)](https://github.com/Tommy-Burns/easy-eo/blob/main/LICENSE)
+|  |  |
+| :-- | :-- |
+| **Install** | [![PyPI][pypi-badge]][pypi] [![conda-forge][conda-badge]][conda] [![Python versions][pyversions-badge]][pypi] [![Platforms][platforms-badge]][ci] |
+| **Build & quality** | [![CI][ci-badge]][ci] [![Latest deps][latest-deps-badge]][latest-deps] [![Coverage][codecov-badge]][codecov] [![Ruff][ruff-badge]][ruff] [![Checked with mypy][mypy-badge]][mypy] |
+| **Security** | [![CodeQL][codeql-badge]][codeql] [![OpenSSF Scorecard][scorecard-badge]][scorecard] |
+| **Project** | [![Documentation][docs-badge]][docs] [![License: MIT][license-badge]][license] [![DOI][doi-badge]][doi] |
+
+[pypi]: https://pypi.org/project/easy-eo/
+[pypi-badge]: https://img.shields.io/pypi/v/easy-eo.svg
+[conda]: https://anaconda.org/conda-forge/easy-eo
+[conda-badge]: https://img.shields.io/conda/vn/conda-forge/easy-eo.svg
+[pyversions-badge]: https://img.shields.io/pypi/pyversions/easy-eo.svg
+[platforms-badge]: https://img.shields.io/badge/platform-linux%20%7C%20macOS%20%7C%20windows-lightgrey.svg
+[ci]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/ci.yml
+[ci-badge]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/ci.yml/badge.svg
+[latest-deps]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/latest-deps.yml
+[latest-deps-badge]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/latest-deps.yml/badge.svg
+[codecov]: https://codecov.io/gh/Tommy-Burns/easy-eo
+[codecov-badge]: https://codecov.io/gh/Tommy-Burns/easy-eo/branch/main/graph/badge.svg
+[ruff]: https://github.com/astral-sh/ruff
+[ruff-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
+[mypy]: https://mypy-lang.org/
+[mypy-badge]: https://img.shields.io/badge/mypy-checked-2a6db2.svg
+[codeql]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/codeql.yml
+[codeql-badge]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/codeql.yml/badge.svg
+[scorecard]: https://scorecard.dev/viewer/?uri=github.com/Tommy-Burns/easy-eo
+[scorecard-badge]: https://api.scorecard.dev/projects/github.com/Tommy-Burns/easy-eo/badge
+[docs]: https://easy-eo.readthedocs.io/en/latest/?badge=latest
+[docs-badge]: https://readthedocs.org/projects/easy-eo/badge/?version=latest
+[license]: https://github.com/Tommy-Burns/easy-eo/blob/main/LICENSE
+[license-badge]: https://img.shields.io/github/license/Tommy-Burns/easy-eo
+[doi]: https://doi.org/10.5281/zenodo.21967655
+[doi-badge]: https://zenodo.org/badge/DOI/10.5281/zenodo.21967655.svg
+
 
 Easy-EO is a lightweight, extensible Python library for raster-based Earth
 Observation (EO) analysis: chainable raster processing, band algebra, spectral indices, 

{easy_eo-0.3.0 → easy_eo-0.4.0}/README.md

@@ -4,13 +4,40 @@
   <img src="https://raw.githubusercontent.com/Tommy-Burns/easy-eo/main/.github/assets/eeo_logo.png" alt="Easy-EO logo" width="200">
 </p>
 
-[![CI](https://github.com/Tommy-Burns/easy-eo/actions/workflows/ci.yml/badge.svg)](https://github.com/Tommy-Burns/easy-eo/actions/workflows/ci.yml)
-[![codecov](https://codecov.io/gh/Tommy-Burns/easy-eo/branch/main/graph/badge.svg)](https://codecov.io/gh/Tommy-Burns/easy-eo)
-[![PyPI](https://img.shields.io/pypi/v/easy-eo.svg)](https://pypi.org/project/easy-eo/)
-[![conda-forge](https://img.shields.io/conda/vn/conda-forge/easy-eo.svg)](https://anaconda.org/conda-forge/easy-eo)
-[![Python versions](https://img.shields.io/pypi/pyversions/easy-eo.svg)](https://pypi.org/project/easy-eo/)
-[![Documentation Status](https://readthedocs.org/projects/easy-eo/badge/?version=latest)](https://easy-eo.readthedocs.io/en/latest/?badge=latest)
-[![License: MIT](https://img.shields.io/github/license/Tommy-Burns/easy-eo)](https://github.com/Tommy-Burns/easy-eo/blob/main/LICENSE)
+|  |  |
+| :-- | :-- |
+| **Install** | [![PyPI][pypi-badge]][pypi] [![conda-forge][conda-badge]][conda] [![Python versions][pyversions-badge]][pypi] [![Platforms][platforms-badge]][ci] |
+| **Build & quality** | [![CI][ci-badge]][ci] [![Latest deps][latest-deps-badge]][latest-deps] [![Coverage][codecov-badge]][codecov] [![Ruff][ruff-badge]][ruff] [![Checked with mypy][mypy-badge]][mypy] |
+| **Security** | [![CodeQL][codeql-badge]][codeql] [![OpenSSF Scorecard][scorecard-badge]][scorecard] |
+| **Project** | [![Documentation][docs-badge]][docs] [![License: MIT][license-badge]][license] [![DOI][doi-badge]][doi] |
+
+[pypi]: https://pypi.org/project/easy-eo/
+[pypi-badge]: https://img.shields.io/pypi/v/easy-eo.svg
+[conda]: https://anaconda.org/conda-forge/easy-eo
+[conda-badge]: https://img.shields.io/conda/vn/conda-forge/easy-eo.svg
+[pyversions-badge]: https://img.shields.io/pypi/pyversions/easy-eo.svg
+[platforms-badge]: https://img.shields.io/badge/platform-linux%20%7C%20macOS%20%7C%20windows-lightgrey.svg
+[ci]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/ci.yml
+[ci-badge]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/ci.yml/badge.svg
+[latest-deps]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/latest-deps.yml
+[latest-deps-badge]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/latest-deps.yml/badge.svg
+[codecov]: https://codecov.io/gh/Tommy-Burns/easy-eo
+[codecov-badge]: https://codecov.io/gh/Tommy-Burns/easy-eo/branch/main/graph/badge.svg
+[ruff]: https://github.com/astral-sh/ruff
+[ruff-badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
+[mypy]: https://mypy-lang.org/
+[mypy-badge]: https://img.shields.io/badge/mypy-checked-2a6db2.svg
+[codeql]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/codeql.yml
+[codeql-badge]: https://github.com/Tommy-Burns/easy-eo/actions/workflows/codeql.yml/badge.svg
+[scorecard]: https://scorecard.dev/viewer/?uri=github.com/Tommy-Burns/easy-eo
+[scorecard-badge]: https://api.scorecard.dev/projects/github.com/Tommy-Burns/easy-eo/badge
+[docs]: https://easy-eo.readthedocs.io/en/latest/?badge=latest
+[docs-badge]: https://readthedocs.org/projects/easy-eo/badge/?version=latest
+[license]: https://github.com/Tommy-Burns/easy-eo/blob/main/LICENSE
+[license-badge]: https://img.shields.io/github/license/Tommy-Burns/easy-eo
+[doi]: https://doi.org/10.5281/zenodo.21967655
+[doi-badge]: https://zenodo.org/badge/DOI/10.5281/zenodo.21967655.svg
+
 
 Easy-EO is a lightweight, extensible Python library for raster-based Earth
 Observation (EO) analysis: chainable raster processing, band algebra, spectral indices, 

{easy_eo-0.3.0 → easy_eo-0.4.0}/eeo/__init__.py

@@ -18,7 +18,7 @@ from .core import (
     load_raster,
 )
 from .core.adapters import *
-from .io import from_xarray, stac_search
+from .io import from_xarray, load_landsat, load_sentinel2, stac_search
 from .ops import *
 from .preprocessing import *
 from .viz import *
@@ -28,6 +28,8 @@ __all__ = [
     "load_raster",
     "load_array",
     "stac_search",
+    "load_landsat",
+    "load_sentinel2",
     "from_xarray",
     "show_versions",
     "EEOError",
@@ -38,4 +40,4 @@ __all__ = [
     "MissingDependencyError",
 ]
 
-__version__ = "0.3.0"
+__version__ = "0.4.0"

{easy_eo-0.3.0 → easy_eo-0.4.0}/eeo/core/core.pyi

@@ -227,6 +227,7 @@ class EEORasterDataset:
         colorbar_label: str | None = ...,
         title: str | None = ...,
         save_path: StrPath | None = ...,
+        dpi: int = ...,
         **imshow_kwargs,
     ) -> None: ...
     def plot_composite(
@@ -239,6 +240,7 @@ class EEORasterDataset:
         pmax: float = ...,
         title: str | None = ...,
         save_path: StrPath | None = ...,
+        dpi: int = ...,
     ) -> None: ...
     def plot_histogram(
         self,
@@ -251,6 +253,7 @@ class EEORasterDataset:
         log: bool = ...,
         title: str | None = ...,
         save_path: StrPath | None = ...,
+        dpi: int = ...,
         **hist_kwargs,
     ) -> None: ...
     def plot_raster(
@@ -268,6 +271,7 @@ class EEORasterDataset:
         colorbar_label: str | None = ...,
         title: str | None = ...,
         save_path: StrPath | None = ...,
+        dpi: int = ...,
         **show_kwargs,
     ) -> None: ...
     def plot_raster_with_histogram(
@@ -283,6 +287,7 @@ class EEORasterDataset:
         colorbar: bool = ...,
         colorbar_label: str | None = ...,
         save_path: StrPath | None = ...,
+        dpi: int = ...,
         title: str | None = ...,
     ) -> None: ...
     def power(self, exponent: int | float) -> EEORasterDataset: ...

{easy_eo-0.3.0 → easy_eo-0.4.0}/eeo/datasets/_registry.py

@@ -77,9 +77,8 @@ class SampleFile:
 #: The curated samples, keyed by the attribute name they are exposed under on
 #: :class:`eeo.datasets.SampleDataset`. Band files use the library's colour band
 #: names. This is the single source of truth for both the download machinery and
-#: the namespace attributes. Per-band Cloud-Optimized GeoTIFFs are intentionally
-#: absent: only the stacked COG has a checksum pinned today, and fabricating one
-#: would defeat the download verification.
+#: the namespace attributes. Every raster published on the release has both a
+#: plain and a Cloud-Optimized variant here, the latter suffixed ``_cog``.
 SAMPLE_FILES: dict[str, SampleFile] = {
     "sentinel2_stacked": SampleFile(
         Asset(
@@ -111,6 +110,16 @@ SAMPLE_FILES: dict[str, SampleFile] = {
         "Sentinel-2 L2A band B02 (blue), 1024x1024 @ 10 m, EPSG:32633.",
         _S2_ATTRIBUTION,
     ),
+    "sentinel2_blue_cog": SampleFile(
+        Asset(
+            "B02_COG.tif",
+            "555f6fb67522148c05d7bb9a4f49d157cde2d9da00d1304ed953bfd383c9ead1",
+            2293197,
+        ),
+        "raster",
+        "Cloud-Optimized GeoTIFF variant of the blue band (B02).",
+        _S2_ATTRIBUTION,
+    ),
     "sentinel2_green": SampleFile(
         Asset(
             "B03.tif",
@@ -121,6 +130,16 @@ SAMPLE_FILES: dict[str, SampleFile] = {
         "Sentinel-2 L2A band B03 (green), 1024x1024 @ 10 m, EPSG:32633.",
         _S2_ATTRIBUTION,
     ),
+    "sentinel2_green_cog": SampleFile(
+        Asset(
+            "B03_COG.tif",
+            "0f0e6cd16141725fe4dfd749a911f3846429b0cd7c222d543d90848ac1f95833",
+            2404804,
+        ),
+        "raster",
+        "Cloud-Optimized GeoTIFF variant of the green band (B03).",
+        _S2_ATTRIBUTION,
+    ),
     "sentinel2_red": SampleFile(
         Asset(
             "B04.tif",
@@ -131,6 +150,16 @@ SAMPLE_FILES: dict[str, SampleFile] = {
         "Sentinel-2 L2A band B04 (red), 1024x1024 @ 10 m, EPSG:32633.",
         _S2_ATTRIBUTION,
     ),
+    "sentinel2_red_cog": SampleFile(
+        Asset(
+            "B04_COG.tif",
+            "5781624003c04ae978196df98dd54e742fe38d1bd5b56237ffc4162209eafc28",
+            2436025,
+        ),
+        "raster",
+        "Cloud-Optimized GeoTIFF variant of the red band (B04).",
+        _S2_ATTRIBUTION,
+    ),
     "sentinel2_nir": SampleFile(
         Asset(
             "B08.tif",
@@ -141,6 +170,16 @@ SAMPLE_FILES: dict[str, SampleFile] = {
         "Sentinel-2 L2A band B08 (nir), 1024x1024 @ 10 m, EPSG:32633.",
         _S2_ATTRIBUTION,
     ),
+    "sentinel2_nir_cog": SampleFile(
+        Asset(
+            "B08_COG.tif",
+            "1488f68cad9f37a90ffef9eb62716e2cab77bd7c22954a08e2f2a5d06ce4014d",
+            2504710,
+        ),
+        "raster",
+        "Cloud-Optimized GeoTIFF variant of the nir band (B08).",
+        _S2_ATTRIBUTION,
+    ),
     "copernicus_dem": SampleFile(
         Asset(
             "DEM.tif",

{easy_eo-0.3.0 → easy_eo-0.4.0}/eeo/datasets/_samples.py

@@ -144,6 +144,8 @@ class SampleDataset:
         Cloud-Optimized GeoTIFF variant of ``sentinel2_stacked``.
     sentinel2_blue, sentinel2_green, sentinel2_red, sentinel2_nir : SamplePath
         The four Sentinel-2 bands as separate single-band GeoTIFFs.
+    sentinel2_blue_cog, sentinel2_green_cog, sentinel2_red_cog, sentinel2_nir_cog : SamplePath
+        Cloud-Optimized GeoTIFF variants of the four single-band files.
     copernicus_dem : SamplePath
         Copernicus GLO-30 DEM warped onto the Sentinel-2 grid (float32 metres).
     copernicus_dem_cog : SamplePath
@@ -156,9 +158,13 @@ class SampleDataset:
     sentinel2_stacked: SamplePath
     sentinel2_cog_stacked: SamplePath
     sentinel2_blue: SamplePath
+    sentinel2_blue_cog: SamplePath
     sentinel2_green: SamplePath
+    sentinel2_green_cog: SamplePath
     sentinel2_red: SamplePath
+    sentinel2_red_cog: SamplePath
     sentinel2_nir: SamplePath
+    sentinel2_nir_cog: SamplePath
     copernicus_dem: SamplePath
     copernicus_dem_cog: SamplePath
     boundary: SamplePath

{easy_eo-0.3.0 → easy_eo-0.4.0}/eeo/io/__init__.py

@@ -1,15 +1,19 @@
 """Data access and exchange beyond the local filesystem.
 
-Holds STAC catalog access (:mod:`eeo.io.stac`, the ``stac`` extra) and xarray
-interop (:mod:`eeo.io.xarray`, the ``xarray`` extra). Importing this package
+Holds STAC catalog access (:mod:`eeo.io.stac`, the ``stac`` extra), loaders for
+products downloaded to disk (:mod:`eeo.io.products`), and xarray interop
+(:mod:`eeo.io.xarray`, the ``xarray`` extra). Importing this package
 pulls in no optional dependency; an extra is only required when one of its
 features actually runs.
 """
 
+from .products import load_landsat, load_sentinel2
 from .stac import PLANETARY_COMPUTER_STAC_URL, STACItem, STACSearchResult, stac_search
 from .xarray import from_xarray
 
 __all__ = [
+    "load_landsat",
+    "load_sentinel2",
     "stac_search",
     "STACItem",
     "STACSearchResult",