mapchete-eo 2026.1.0__tar.gz → 2026.2.0__tar.gz

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/.gitignore

@@ -3,6 +3,7 @@ build/
 .coverage
 .coverage.*
 dist/
+docs/build/html
 *.egg-info
 .eggs
 examples/sentinel-2*/
@@ -14,3 +15,4 @@ __pycache__
 .pytest*
 .ruff_cache
 .vscode/
+.venv

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mapchete-eo
-Version: 2026.1.0
+Version: 2026.2.0
 Summary: mapchete EO data reader
 Project-URL: Homepage, https://gitlab.eox.at/maps/mapchete_eo
 Author-email: Joachim Ungar <joachim.ungar@eox.at>, Petr Sevcik <petr.sevcik@eox.at>
@@ -14,6 +14,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.10
 Requires-Dist: click
 Requires-Dist: croniter
 Requires-Dist: lxml
@@ -30,8 +31,9 @@ Requires-Dist: scipy
 Requires-Dist: tqdm
 Requires-Dist: xarray
 Provides-Extra: docs
-Requires-Dist: sphinx; extra == 'docs'
-Requires-Dist: sphinx-rtd-theme; extra == 'docs'
+Requires-Dist: myst-parser; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=3.0.2; extra == 'docs'
+Requires-Dist: sphinx>=8.0; extra == 'docs'
 Provides-Extra: test
 Requires-Dist: pytest; extra == 'test'
 Requires-Dist: pytest-coverage; extra == 'test'
@@ -80,10 +82,10 @@ You must have ``mapchete`` with ``s3`` installed, so let's grab the ``complete``
 
 .. code-block:: bash
 
-    pip install mapchete[complete]
+    uv pip install mapchete[complete]
 
 Then install mapchete-eo:
 
 .. code-block:: bash
 
-    pip install mapchete-eo
+    uv pip install mapchete-eo

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/README.rst

@@ -40,10 +40,10 @@ You must have ``mapchete`` with ``s3`` installed, so let's grab the ``complete``
 
 .. code-block:: bash
 
-    pip install mapchete[complete]
+    uv pip install mapchete[complete]
 
 Then install mapchete-eo:
 
 .. code-block:: bash
 
-    pip install mapchete-eo
+    uv pip install mapchete-eo

mapchete_eo-2026.2.0/mapchete_eo/__init__.py

@@ -0,0 +1 @@
+__version__ = "2026.2.0"

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/base.py

@@ -44,6 +44,10 @@ logger = logging.getLogger(__name__)
 
 
 class BaseDriverConfig(BaseModel):
+    """
+    Configuration for mapchete-eo drivers.
+    """
+
     format: str
     source: Sequence[Source]
     time: Optional[Union[TimeRange, List[TimeRange]]] = None
@@ -114,6 +118,9 @@ class EODataCube(base.InputTile):
 
     @cached_property
     def products(self) -> IndexedFeatures[EOProductProtocol]:
+        """
+        Indexed products.
+        """
         # during task graph processing, the products have to be fetched as preprocessing task results
         if self._products is None:  # pragma: no cover
             return IndexedFeatures(
@@ -158,11 +165,7 @@ class EODataCube(base.InputTile):
         **kwargs,
     ) -> xr.Dataset:
         """
-        Read reprojected & resampled input data.
-
-        Returns
-        -------
-        data : xarray.Dataset
+        Read input data into an xarray.Dataset.
         """
         return products_to_xarray(
             products=self.filter_products(
@@ -201,6 +204,9 @@ class EODataCube(base.InputTile):
         raise_empty: bool = True,
         **kwargs,
     ) -> ma.MaskedArray:
+        """
+        Read input data as a MaskedArray.
+        """
         return products_to_np_array(
             products=self.filter_products(
                 start_time=start_time,
@@ -286,6 +292,27 @@ class EODataCube(base.InputTile):
         raise_empty: bool = True,
         **kwargs,
     ) -> ma.MaskedArray:
+        """
+        Read levelled data (cubes with depth) as a MaskedArray.
+
+        Args:
+            target_height: Target stack height.
+            assets: List of asset names.
+            eo_bands: List of EO bands.
+            start_time: Start time.
+            end_time: End time.
+            timestamps: List of timestamps.
+            time_pattern: Time pattern.
+            resampling: Resampling method.
+            nodatavals: Nodata values.
+            merge_products_by: Property to merge by.
+            merge_method: Merge method.
+            sort: Sorting configuration.
+            raise_empty: Raise error if no data found.
+
+        Returns:
+            ma.MaskedArray: Output data array.
+        """
         return read_levelled_cube_to_np_array(
             products=self.filter_products(
                 start_time=start_time,
@@ -317,6 +344,19 @@ class EODataCube(base.InputTile):
         nodatavals: NodataVals = None,
         **kwargs,
     ):
+        """
+        Read product masks.
+
+        Args:
+            start_time: Start time.
+            end_time: End time.
+            timestamps: List of timestamps.
+            time_pattern: Time pattern.
+            nodatavals: Nodata values.
+
+        Returns:
+            ma.MaskedArray: Mask data.
+        """
         from mapchete_eo.platforms.sentinel2.masks import read_masks
 
         return read_masks(
@@ -423,6 +463,10 @@ class EODataCube(base.InputTile):
 
 
 class InputData(base.InputData):
+    """
+    Main driver class used by mapchete to handle input data discovery and indexing.
+    """
+
     default_preprocessing_task: Callable = staticmethod(EOProduct.from_stac_item)
     driver_config_model: Type[BaseDriverConfig] = BaseDriverConfig
     params: BaseDriverConfig

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/image_operations/compositing.py

@@ -153,6 +153,18 @@ METHODS = {
 def composite(
     method: str, bg: np.ndarray, fg: np.ndarray, opacity: float = 1
 ) -> ma.MaskedArray:
+    """
+    Composite two image arrays using a named blending method.
+
+    Args:
+        method: Blending method name (e.g., 'multiply', 'screen').
+        bg: Background image array (channels-first).
+        fg: Foreground image array (channels-first).
+        opacity: Opacity of the foreground layer (0-1).
+
+    Returns:
+        ma.MaskedArray: Blended RGBA result.
+    """
     return METHODS[method](bg, fg, opacity)
 
 

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/platforms/sentinel2/driver.py

@@ -17,6 +17,10 @@ METADATA: dict = {
 
 
 class Sentinel2Cube(base.EODataCube):
+    """
+    Sentinel-2 data cube for Mapchete.
+    """
+
     # Sentinel-2 driver specific default values:
     default_read_merge_method: MergeMethod = MergeMethod.average
     default_read_merge_products_by: Optional[str] = "s2:datastrip_id"
@@ -29,7 +33,7 @@ Sentinel2CubeGroup = List[Tuple[str, Sentinel2Cube]]
 
 class InputData(base.InputData):
     """
-    Main driver class used by mapchete.
+    Sentinel-2 driver for Mapchete.
     """
 
     # Sentinel-2 driver specific parameters:

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/platforms/sentinel2/masks.py

@@ -61,7 +61,9 @@ def masks_to_xarray(
     raise_empty: bool = True,
     product_read_kwargs: dict = {},
 ) -> xr.Dataset:
-    """Read grid window of EOProducts and merge into a 4D xarray."""
+    """
+    Read masks of products and merge into an xarray.Dataset.
+    """
     data_vars = [
         s
         for s in generate_slice_masks_dataarrays(
@@ -307,7 +309,9 @@ def product_masks_to_slices(
     group_by_property: Optional[str] = None,
     sort: Optional[SortMethodConfig] = None,
 ) -> List[Slice]:
-    """Group products per given property into Slice objects and optionally sort slices."""
+    """
+    Group products by a property into Slices and optionally sort.
+    """
     if group_by_property:
         grouped = defaultdict(list)
         for product in products:

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/platforms/sentinel2/preprocessing_tasks.py

@@ -19,7 +19,10 @@ def parse_s2_product(
     cache_config: Optional[CacheConfig] = None,
     cache_all: bool = False,
 ) -> Union[S2Product, CorruptedProductMetadata]:
-    # use mapper from source if applickable
+    """
+    Parse a Sentinel-2 STAC Item into an S2Product.
+    """
+    # use mapper from source if applicable
     source: Union[Sentinel2Source, None] = item.properties.pop(
         "mapchete_eo:source", None
     )

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/platforms/sentinel2/product.py

@@ -143,6 +143,10 @@ class Cache:
 
 
 class S2Product(EOProduct, EOProductProtocol):
+    """
+    Sentinel-2 specific EOProduct implementation.
+    """
+
     _item_dict: Optional[dict] = None
     cache: Optional[Cache] = None
     _scl_cache: Dict[GridProtocol, np.ndarray]
@@ -245,6 +249,9 @@ class S2Product(EOProduct, EOProductProtocol):
         read_mask: Optional[np.ndarray] = None,
         **kwargs,
     ) -> ma.MaskedArray:
+        """
+        Read Sentinel-2 assets into a MaskedArray with masks and BRDF.
+        """
         assets = assets or []
         eo_bands = eo_bands or []
         apply_offset = apply_offset and not self.metadata.boa_offset_applied
@@ -451,7 +458,9 @@ class S2Product(EOProduct, EOProductProtocol):
         grid: Union[GridProtocol, Resolution] = Resolution["20m"],
         cached_read: bool = False,
     ) -> ReferencedRaster:
-        """Return SCL mask."""
+        """
+        Read Scene Classification Layer mask.
+        """
         grid = (
             self.metadata.grid(grid)
             if isinstance(grid, Resolution)
@@ -519,7 +528,9 @@ class S2Product(EOProduct, EOProductProtocol):
         mask_config: MaskConfig = MaskConfig(),
         target_mask: Optional[np.ndarray] = None,
     ) -> ReferencedRaster:
-        """Merge masks into one 2D array."""
+        """
+        Merge all configured masks into one.
+        """
         grid = (
             self.metadata.grid(grid)
             if isinstance(grid, Resolution)
@@ -619,6 +630,8 @@ class S2Product(EOProduct, EOProductProtocol):
             logger.debug(
                 "mask for product %s already full, skip reading other masks", self.id
             )
+        except FileNotFoundError as exc:  # pragma: no cover
+            raise CorruptedProduct from exc
 
         # ATTENTION: target_mask and out have to be combined *after* mask was buffered!
         # use 'logical or' not '+' !!!

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/product.py

@@ -26,7 +26,9 @@ logger = logging.getLogger(__name__)
 
 
 class EOProduct(EOProductProtocol):
-    """Wrapper class around a Item which provides read functions."""
+    """
+    Wrapper class around a STAC Item which provides data reading capabilities.
+    """
 
     id: str
     default_dtype: DTypeLike = np.uint16
@@ -70,7 +72,22 @@ class EOProduct(EOProductProtocol):
         raise_empty: bool = True,
         **kwargs,
     ) -> xr.Dataset:
-        """Read bands and assets into xarray."""
+        """
+        Read bands and assets into an xarray.Dataset.
+
+        Args:
+            assets: List of asset names.
+            eo_bands: List of EO band names.
+            grid: Target grid protocol.
+            resampling: Resampling algorithm.
+            nodatavals: Custom nodata values.
+            x_axis_name: Name of X axis in output.
+            y_axis_name: Name of Y axis in output.
+            raise_empty: Raise exception if no data is found.
+
+        Returns:
+            xr.Dataset: Dataset with assets as data variables.
+        """
         # developer info: all fancy stuff for special platforms like Sentinel-2
         # should be implemented in the respective read_np_array() methods which get
         # called by this method. No need to apply masks etc. here too.
@@ -121,6 +138,21 @@ class EOProduct(EOProductProtocol):
         apply_offset: bool = True,
         **kwargs,
     ) -> ma.MaskedArray:
+        """
+        Read assets or EO bands into a MaskedArray.
+
+        Args:
+            assets: List of asset names.
+            eo_bands: List of EO band names.
+            grid: Target grid.
+            resampling: Resampling method.
+            nodatavals: Nodata values.
+            raise_empty: Raise if empty.
+            apply_offset: Apply offset/scale metadata if present.
+
+        Returns:
+            ma.MaskedArray: Output array.
+        """
         assets = assets or []
         eo_bands = eo_bands or []
         bands = assets or eo_bands
@@ -182,7 +214,15 @@ def eo_bands_to_band_locations(
     role: Literal["data", "reflectance", "visual"] = "data",
 ) -> List[BandLocation]:
     """
-    Find out location (asset and band index) of EO band.
+    Map EO band names to asset locations.
+
+    Args:
+        item: STAC Item.
+        eo_bands: List of common band names.
+        role: Functional role of the assets.
+
+    Returns:
+        List[BandLocation]: List of location objects.
     """
     return [find_eo_band(item, eo_band, role=role) for eo_band in eo_bands]
 

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/search/base.py

@@ -50,7 +50,7 @@ class FSSpecStacIO(StacApiIO):
 
 class CollectionSearcher(ABC):
     """
-    This class serves as a bridge between an Archive and a catalog implementation.
+    Bridge between a Source and a catalog implementation.
     """
 
     config_cls: Type[BaseModel]
@@ -129,7 +129,29 @@ class StaticCollectionWriterMixin(CollectionSearcher):
         stac_io: DefaultStacIO = FSSpecStacIO(),
         progress_callback: Optional[Callable] = None,
     ) -> MPath:
-        """Dump static version of current items."""
+        """
+        Export a static STAC catalog from the search results.
+
+        Args:
+            output_path: Destination directory for the static catalog.
+            bounds: Spatial filter bounds.
+            area: Spatial filter geometry.
+            time: Temporal filter range.
+            search_kwargs: Additional search arguments.
+            name: Catalog name.
+            description: Catalog description.
+            assets: List of assets to download.
+            assets_dst_resolution: Sub-sampling resolution for assets.
+            assets_convert_profile: Output profile for assets (e.g. for COG conversion).
+            copy_metadata: Whether to copy sidecar metadata files.
+            metadata_parser_classes: Custom parser classes for metadata.
+            overwrite: Overwrite existing files.
+            stac_io: Custom STAC IO implementation.
+            progress_callback: Optional function for progress reporting.
+
+        Returns:
+            MPath: Path to the generated catalog.json.
+        """
         output_path = MPath.from_inp(output_path)
         assets = assets or []
         # initialize catalog

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/search/stac_search.py

@@ -21,6 +21,10 @@ logger = logging.getLogger(__name__)
 
 
 class STACSearchCollection(StaticCollectionWriterMixin, CollectionSearcher):
+    """
+    Search implementation for STAC APIs.
+    """
+
     collection: str
     config_cls = StacSearchConfig
 
@@ -206,6 +210,10 @@ class STACSearchCollection(StaticCollectionWriterMixin, CollectionSearcher):
 
 
 class SpatialSearchChunks:
+    """
+    Split spatial search areas into smaller chunks for large queries.
+    """
+
     bounds: Bounds
     area: BaseGeometry
     search_kw: str

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/search/stac_static.py

@@ -29,6 +29,10 @@ StacIO.set_default(FSSpecStacIO)
 
 
 class STACStaticCollection(StaticCollectionWriterMixin, CollectionSearcher):
+    """
+    Search implementation for static STAC collections.
+    """
+
     config_cls = StacStaticConfig
 
     @cached_property

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/search/utm_search.py

@@ -28,6 +28,10 @@ logger = logging.getLogger(__name__)
 
 
 class UTMSearchCatalog(StaticCollectionWriterMixin, CollectionSearcher):
+    """
+    Search implementation for UTM-grid based catalogs (e.g. Sentinel-2 on AWS).
+    """
+
     config_cls = UTMSearchConfig
 
     @cached_property

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/sort.py

@@ -22,9 +22,7 @@ def sort_objects_by_target_date(
     **kwargs,
 ) -> List[DateTimeProtocol]:
     """
-    Return sorted list of objects according to their distance to the target_date.
-
-    Default for target date is the middle between the objects start date and end date.
+    Sort objects by their distance to a target date.
     """
     if len(objects) == 0:
         return objects

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/source.py

@@ -17,7 +17,9 @@ from mapchete_eo.types import TimeRange
 
 
 class Source(BaseModel):
-    """All information required to consume EO products."""
+    """
+    All information required to consume EO products.
+    """
 
     collection: str
     catalog_crs: Optional[CRSLike] = mapchete_eo_settings.default_catalog_crs

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/time.py

@@ -9,7 +9,9 @@ _time = {"min": datetime.datetime.min.time(), "max": datetime.datetime.max.time(
 
 
 def to_datetime(t: DateTimeLike, append_time="min") -> datetime.datetime:
-    """Convert input into datetime object."""
+    """
+    Convert input into datetime object.
+    """
     if isinstance(t, datetime.datetime):
         return t
     elif isinstance(t, datetime.date):
@@ -22,7 +24,9 @@ def time_ranges_intersect(
     t1: Tuple[DateTimeLike, DateTimeLike],
     t2: Tuple[DateTimeLike, DateTimeLike],
 ) -> bool:
-    """Check if two time ranges intersect."""
+    """
+    Check if two time ranges intersect.
+    """
     t1_start = to_datetime(t1[0], "min").replace(tzinfo=None)
     t1_end = to_datetime(t1[1], "max").replace(tzinfo=None)
     t2_start = to_datetime(t2[0], "min").replace(tzinfo=None)
@@ -31,7 +35,9 @@ def time_ranges_intersect(
 
 
 def timedelta(date: DateTimeLike, target: DateTimeLike, seconds: bool = True):
-    """Return difference between two time stamps."""
+    """
+    Return difference between two time stamps in seconds or days.
+    """
     delta = to_datetime(date) - to_datetime(target)
     if seconds:
         return abs(delta.total_seconds())
@@ -43,6 +49,9 @@ def day_range(
     start_date: Union[datetime.datetime, datetime.date],
     end_date: Union[datetime.datetime, datetime.date],
 ) -> List[datetime.date]:
+    """
+    Return a list of dates between start and end.
+    """
     start_date = (
         start_date.date() if isinstance(start_date, datetime.datetime) else start_date
     )

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/mapchete_eo/types.py

@@ -10,8 +10,9 @@ from pystac import Asset
 
 
 class GeodataType(str, Enum):
-    vector = "vector"
-    raster = "raster"
+    """
+    Type of geodata (vector or raster).
+    """
 
 
 class MergeMethod(str, Enum):
@@ -42,12 +43,14 @@ class BandLocation:
     roles: List[str] = field(default_factory=list)
     eo_band_name: Optional[str] = None
 
-    @staticmethod
     def from_asset(
         asset: Asset,
         name: str,
         band_index: PositiveInt,
     ) -> BandLocation:
+        """
+        Extract band location info from STAC Asset.
+        """
         try:
             bands_info = asset.extra_fields.get(
                 "eo:bands", asset.extra_fields.get("bands", [])

{mapchete_eo-2026.1.0 → mapchete_eo-2026.2.0}/pyproject.toml

@@ -5,6 +5,7 @@ build-backend = "hatchling.build"
 [project]
 name = "mapchete-eo"
 dynamic = ["version"]
+requires-python = ">=3.10"
 description = "mapchete EO data reader"
 readme = "README.rst"
 license = "MIT"
@@ -42,8 +43,9 @@ dependencies = [
 
 [project.optional-dependencies]
 docs = [
-  "sphinx",
-  "sphinx-rtd-theme"
+    "sphinx>=8.0",
+    "sphinx-rtd-theme>=3.0.2",
+    "myst-parser",
 ]
 test = [
     "pytest",
@@ -87,4 +89,9 @@ testpaths = ["tests"]
 markers = [
     "remote: marks tests which require acces to remote resources (deselect with '-m \"not remote\"')",
     "use_cdse_test_env: enables CDSE S3 environment access",
-]
+]
+
+[tool.pyproject2conda]
+channels = ["conda-forge"]
+# Maps PyPI names to Conda-Forge names if they differ
+map_deps = { "opencv-python-headless" = "opencv", "pystac-client" = "python-pystac-client" }

mapchete_eo-2026.1.0/mapchete_eo/__init__.py

@@ -1 +0,0 @@
-__version__ = "2026.1.0"