iter_datapoints | tilebox.datasets

python

def iter_datapoints(
    data: xarray.Dataset,
    *,
    dimension: str = "time",
) -> Iterator[xarray.Dataset]

Iterate over individual datapoints in an xarray query result. Each datapoint is selected by position along dimension, removing that dimension and preserving its coordinate as a scalar.

This iterates over an existing result; it does not make requests or stream query pages.

Parameters

data xarray.Dataset

The result of a dataset or collection query.

dimension str

The datapoint dimension to iterate over. Defaults to "time".

Yields

One xarray.Dataset per datapoint, in result order. Empty query results yield no datapoints.

Raises

ValueError when iteration starts if the dataset contains variables but does not have the requested dimension.

Usage example

Query Sentinel-2 scenes and resolve each scene’s red-band asset separately.

python

from shapely import box
from tilebox.datasets import Client, iter_datapoints
from tilebox.datasets.assets import AssetCollection

collection = Client().dataset("open_data.aws_earth.sentinel2").collection("L2A")
data = collection.query(
    temporal_extent=("2026-07-20", "2026-07-28"),
    spatial_extent=box(16.25, 48.15, 16.35, 48.22),
)

for datapoint in iter_datapoints(data):
    assets = AssetCollection.from_datapoint(datapoint)
    print(datapoint.id.item(), assets["red"].primary.href)

AssetCollection.from_datapoint accepts one scalar datapoint, not the full query result.