2024.8.0

cubo v2024.8.0 🛰️ 🧊

• Fix: Avoid Google Earth Engine initialization within cubo.

2024.6.0

cubo v2024.6.0 🛰️ 🧊

• Pinned: numpy<2.0.0 as stackstac breaks with numpy>=2.0.0.

2024.1.1

cubo v2024.1.1 🛰️ 🧊

Now supporting different units for edge_size! 🥳

• Added the units argument to cubo.create().
• Added support for scipy.constants units.

2024.1.0

cubo v2024.1.0 🛰️ 🧊

Now supporting Google Earth Engine! 🥳

• Added support for Google Earth Engine.
• Added the gee argument to cubo.create().
• Added support for stackstac keyword arguments.
• Added the stackstac_kw argument to cubo.create().

2023.12.0

cubo v2023.12.0 🛰️ 🧊

• This version enables preservation via Zenodo.

2023.7.2

cubo v2023.7.2 🛰️ 🧊

• Added cubo:distance_from_center coordinate.

2023.7.1

cubo v2023.7.1 🛰️ 🧊

• Replaced get_all_items by item_collection.

2023.7.0

cubo v2023.7.0 🛰️ 🧊

• Fixed the required datatype of the EPSG code for stackstac (#4).
• Pinned latest versions: dask>=2023.7.0, pandas>=2.0.3, planetary_computer>=1.0.0, pystac_client>=0.7.2, stackstac>=0.4.4, and xarray>=2023.6.0.

0.1.0

cubo v0.1.0 🛰️ 🧊 (First Release!) 🚀

Easily create EO mini cubes from STAC in Python

Features

Main function: create()

cubo is pretty straightforward, everything you need is in the create() function:

da = cubo.create(
    lat=4.31,
    lon=-76.2,
    collection="sentinel-2-l2a",
    bands=["B02","B03","B04"],
    start_date="2021-06-01",
    end_date="2021-06-10",
    edge_size=64,
    resolution=10,
)

Using another endpoint

By default, cubo uses Planetary Computer. But you can use another STAC provider endpoint if you want:

da = cubo.create(
    lat=4.31,
    lon=-76.2,
    collection="sentinel-s2-l2a-cogs",
    bands=["B05","B06","B07"],
    start_date="2020-01-01",
    end_date="2020-06-01",
    edge_size=128,
    resolution=20,
    stac="https://earth-search.aws.element84.com/v0"
)

Keywords for searching data

You can pass kwargs to pystac_client.Client.search() if required:

da = cubo.create(
    lat=4.31,
    lon=-76.2,
    collection="sentinel-2-l2a",
    bands=["B02","B03","B04"],
    start_date="2021-01-01",
    end_date="2021-06-10",
    edge_size=64,
    resolution=10,
    query={"eo:cloud_cover": {"lt": 10}} # kwarg to pass
)