cubo v2024.1.1 :artificial_satellite: :ice_cube:

Now supporting different units for edge_size! :partying_face:

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

cubo v2024.1.0 :artificial_satellite: :ice_cube:

Now supporting Google Earth Engine! :partying_face:

• 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().

cubo v2023.12.0 :artificial_satellite: :ice_cube:

• This version enables preservation via Zenodo.

cubo v2023.7.2 :artificial_satellite: :ice_cube:

• Added cubo:distance_from_center coordinate.

cubo v2023.7.1 :artificial_satellite: :ice_cube:

• Replaced get_all_items by item_collection.

cubo v2023.7.0 :artificial_satellite: :ice_cube:

• Fixed the required datatype of the EPSG code for stackstac (https://github.com/ESDS-Leipzig/cubo/issues/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.

cubo v0.1.0 :artificial_satellite: :ice_cube: (First Release!) :rocket:

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
)