datacube.Datacube.find_datasets#

Datacube.find_datasets(ensure_location=False, dataset_predicate=None, like=None, limit=None, **search_terms)[source]#

Search the index and return all datasets for a product matching the search terms.

Parameters:

  • ensure_location (bool) – only return datasets that have locations

  • dataset_predicate (Optional[Callable[[Dataset], bool]]) – an optional predicate to filter datasets

  • like (xarray.Dataset) –

    Use the output of a previous load() to load data into the same spatial grid and resolution (i.e. odc.geo.geobox.GeoBox or an xarray Dataset or DataArray). E.g.:

    pq = dc.load(product='ls5_pq_albers', like=nbar_dataset)

  • limit (int | None) – if provided, limit the maximum number of datasets returned

  • search_terms (str | float | int | Range | datetime | Not) – see datacube.api.query.Query

Return type:

list[Dataset]

Returns:

list of datasets

See also

group_datasets() load_data() find_datasets_lazy()