Merge pull request #10 from ESDS-Leipzig/stackstac_kw

Add Stackstac kwargs

cubo/cubo.py

@@ -22,6 +22,7 @@ def create(
     resolution: Union[float, int] = 10.0,
     stac: str = "https://planetarycomputer.microsoft.com/api/stac/v1",
     gee: bool = False,
+    stackstac_kw: Optional[dict] = None,
     **kwargs,
 ) -> xr.DataArray:
     """Creates a data cube from a STAC Catalogue as a :code:`xr.DataArray` object.
@@ -58,6 +59,11 @@ def create(
 
         .. versionadded:: 2024.1.0
 
+    stackstac_kw : dict, default = None
+        Keyword arguments for :code:`stackstac` as a dictionary.
+
+        .. versionadded:: 2024.1.0
+
     kwargs :
         Additional keyword arguments passed to :code:`pystac_client.Client.search()`.
 
@@ -189,13 +195,18 @@ def create(
         if not isinstance(bands, list) and bands is not None:
             bands = [bands]
 
+        # Add stackstac arguments
+        if stackstac_kw is None:
+            stackstac_kw = dict()
+
         # Create the cube
         cube = stackstac.stack(
             items,
             assets=bands,
             resolution=resolution,
             bounds=bbox_utm,
             epsg=epsg,
+            **stackstac_kw,
         )
 
         # Delete attributes

docs/changelog.rst

@@ -6,6 +6,8 @@ v2024.1.0
 
 - Added support for Google Earth Engine.
 - Added the :code:`gee` argument to :code:`cubo.create()`.
+- Added support for :code:`stackstac` keyword arguments.
+- Added the :code:`stackstac_kw` argument to :code:`cubo.create()`.
 
 v2023.12.0
 ---------

docs/tutorials.rst

@@ -8,4 +8,5 @@ Tutorials
     tutorials/cube_visualization.ipynb
     tutorials/using_collections.ipynb
     tutorials/visualization_lexcube.ipynb
-    tutorials/using_gee.ipynb
+    tutorials/using_gee.ipynb
+    tutorials/stackstac.ipynb