STAC Items

class ceda_datapoint.core.item.DataPointItem(item_stac: object, meta: dict = None, mapper: DataPointMapper = None)[source]

Class to represent a self-describing Item object from the STAC collection.

property cloud_assets: list[str]: Lazily identify cloud assets

help() → None[source]: Help method for this class

info() → None[source]: Information about this item.

get_cloud_product(id: int = 0, priority: list = None, show_unreachable: bool = False, asset_mappings: dict = None) → DataPointCloudProduct[source]

Returns a cloud product represented by this item from its cluster. The nth cloud product is returned given the id parameter. Typically items should have only 1-2 cloud products attached.

Parameters:

id – (str) The ID or index of the dataset in the resulting cluster.
priority – (list) Order by which to open a set of datasets.

open_dataset(id: int = 0, priority: list = None, mappings: dict = None, **kwargs) → Dataset[source]

Open a specific dataset, skip retrieving the cloud product

Parameters:

id – (str) The ID or index of the dataset.
priority – (list) Order by which to open a set of datasets.

collect_cloud_assets(priority: list = None, show_unreachable: bool = False, asset_mappings: dict = None) → DataPointCluster[source]

Returns a cluster of DataPointCloudProduct objects representing the cloud assets as requested.

Parameters:

priority – (list) Order by which to open a set of datasets.
show_unreachable – (bool) Show the hidden assets that DataPoint has determined are currently unreachable.

get_assets() → dict[source]: Get the set of assets (in dict form) for this item.

list_cloud_formats() → list[str][source]: Return the list of cloud formats identified from the set of cloud assets.

display_cloud_formats() → None[source]: Display the list of cloud formats based on the cloud assets.