read
read(
self ,
resource ,
snap: bool | str | collections.abc.Collection[bool, str, collections.abc.Collection[str], None] = None,
samples: bool = False,
source_patch_key: str | collections.abc.Iterable[str, collections.abc.Iterable[str]] = ““,
**select ,
)-> ‘dc.Spool’
Read patches by selecting metadata and loading the resulting array windows.
Coordinate queries are resolved on the original sample grid without recording a processing operation. source_patch_key selects logical patches, and matching attribute queries filter metadata before data are read. snap names the dimensions whose stored labels come back on a grid: None (the default) the format’s own names, True every one-dimensional numeric or time-like dimension, False none, or a name or tuple of names, each of which must be such a dimension. The deprecated snap_dims spelling still works, with a warning, and an explicit snap wins. samples=True interprets coordinate selections as sample indices. source_patch_key accepts one logical key or an iterable of keys.