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 (Callable[[Dataset], bool] | None) – an optional predicate to filter datasets

  • like (GeoBox | Dataset | DataArray | None) –

    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 | Iterable[str | Geometry] | Not) – see datacube.api.query.Query

Return type:

list[Dataset]

Returns:

list of datasets

See also

group_datasets() load_data() find_datasets_lazy()