Dataset.find

# search all collections in the dataset
datapoint = dataset.find("0186d6b6-66cc-fcfd-91df-bbbff72499c3")

# search specific collections only
datapoint = dataset.find(
    "0186d6b6-66cc-fcfd-91df-bbbff72499c3",
    collections=["S2A_S2MSI2A", "S2B_S2MSI2A"],
)

# check if a datapoint exists
from tilebox.datasets.sync.dataset import NotFoundError

try:
    dataset.find(
        "0186d6b6-66cc-fcfd-91df-bbbff72499c3",
        collections=["S2A_S2MSI2A"],
        skip_data=True,
    )
    exists = True
except NotFoundError:
    exists = False

# search all collections in the dataset
datapoint = dataset.find("0186d6b6-66cc-fcfd-91df-bbbff72499c3")

# search specific collections only
datapoint = dataset.find(
    "0186d6b6-66cc-fcfd-91df-bbbff72499c3",
    collections=["S2A_S2MSI2A", "S2B_S2MSI2A"],
)

# check if a datapoint exists
from tilebox.datasets.sync.dataset import NotFoundError

try:
    dataset.find(
        "0186d6b6-66cc-fcfd-91df-bbbff72499c3",
        collections=["S2A_S2MSI2A"],
        skip_data=True,
    )
    exists = True
except NotFoundError:
    exists = False

def Dataset.find(
    datapoint_id: str | UUID,
    collections: list[str] | list[UUID] | list[Collection] | list[CollectionInfo] | list[CollectionClient] | None = None,
    skip_data: bool = False,
) -> xarray.Dataset

Find a specific datapoint by ID across one or more collections in this dataset. If collections is not provided, all collections in the dataset are searched.

Parameters

str | UUID

The ID of the datapoint to find.

Optional collection scope for the lookup.Supported values include collection names, collection IDs, and collection objects. If omitted or set to None, all collections in the dataset are searched.

bool

If True, only required datapoint fields are returned (time, id, ingestion_time). Defaults to False.

Returns

An xarray.Dataset containing the requested datapoint. Since it returns only a single datapoint, the output dataset does not include a time dimension.

Errors

Invalid datapoint id: <id> is not a valid UUID

Raised when datapoint_id is not a valid UUID.

Collection <name> not found in dataset <dataset>

Raised when one or more collection names do not exist in the dataset.

Collection <id> is not part of the dataset <dataset>

Raised when one or more provided collection IDs/objects are not part of the dataset.

No such datapoint <id>

Raised when the datapoint cannot be found in the selected collections.

# search all collections in the dataset
datapoint = dataset.find("0186d6b6-66cc-fcfd-91df-bbbff72499c3")

# search specific collections only
datapoint = dataset.find(
    "0186d6b6-66cc-fcfd-91df-bbbff72499c3",
    collections=["S2A_S2MSI2A", "S2B_S2MSI2A"],
)

# check if a datapoint exists
from tilebox.datasets.sync.dataset import NotFoundError

try:
    dataset.find(
        "0186d6b6-66cc-fcfd-91df-bbbff72499c3",
        collections=["S2A_S2MSI2A"],
        skip_data=True,
    )
    exists = True
except NotFoundError:
    exists = False

Python

Go

Parameters

Returns

Errors

​Parameters

​Returns

​Errors

Parameters

Returns

Errors