eodal.metadata.stac.client module

Querying datasets from a Spatio-Temporal Asset Catalog (STAC).

eodal.metadata.stac.client.landsat(metadata_filters: List[Filter], **kwargs) → GeoDataFrame[source]

Landsat specific STAC query function to retrieve mapper from MSPC.

Parameters:

  • metadata_filters – custom filters for filtering scenes in catalog by some metadata attributes

  • kwargs –

    param kwargs:

    keyword arguments to pass to query_stac function

Returns:

dataframe with references to found Landsat scenes

eodal.metadata.stac.client.query_stac(time_start: datetime, time_end: datetime, collection: str, bounding_box: Polygon) → List[Dict[str, Any]][source]

Queries a STAC (Spatio-Temporal Asset Catalog) by bounding box and time period to get items from a user-defined collection.

This is a sensor-agnostic function called by sensor-specific ones.

Parameters:

  • time_start – start of the time period

  • time_end – end of the time period

  • collection – name of the collection (e.g., sentinel-2-l2a for Sentinel-2 L2A data)

  • bounding_box – bounding box either as extended well-known text in geographic coordinates or as shapely Polygon in geographic coordinates (WGS84)

Returns:

list of dictionary items returned from the STAC query

eodal.metadata.stac.client.sentinel1(metadata_filters: List[Filter], **kwargs) → GeoDataFrame[source]

Sentinel-1 specific STAC query function to retrieve mapper from MSPC.

Important

Returns the RTC product by default if not stated otherwise (using EOdal.mapper.filter on product_type

Parameters:

  • metadata_filters – custom filters for filtering scenes in catalog by some metadata attributes

  • kwargs –

    param kwargs:

    keyword arguments to pass to query_stac function

Returns:

dataframe with references to found Sentinel-1 scenes

eodal.metadata.stac.client.sentinel2(metadata_filters: List[Filter], **kwargs) → GeoDataFrame[source]

Sentinel-2 specific STAC query allows filtering by scene-wide cloudy pixel percentage.

Parameters:

  • metadata_filters – custom filters for filtering scenes in catalog by some metadata attributes

  • kwargs – keyword arguments to pass to query_stac function

Returns:

dataframe with references to found Sentinel-2 scenes