caterva2.Dataset

class caterva2.Dataset(name, root, urlbase, auth_cookie=None)

A dataset is a Blosc2 container in a file.

This is not intended to be instantiated directly, but accessed via a Root instance instead.

Parameters:

• name (str) – The name of the dataset.

• root (str) – The name of the root.

• urlbase (str) – The base of URLs (slash-terminated) of the subscriber to query.

• auth_cookie (str) – An optional cookie to authorize requests via HTTP.

Examples

>>> root = cat2.Root('foo')
>>> ds = root['ds-1d.b2nd']
>>> ds.name
'ds-1d.b2nd'
>>> ds[1:10]
array([1, 2, 3, 4, 5, 6, 7, 8, 9])

Attributes:

vlmeta

A mapping of metalayer names to their respective values.

Used to access variable-length metalayers (i.e. user attributes) for a file.

>>> root = cat2.Root('foo')
>>> file = root['ds-sc-attr.b2nd']
>>> file.vlmeta
{'a': 1, 'b': 'foo', 'c': 123.456}

Methods

download()	Download a file to storage.
fetch([slice_])	Fetch a slice of a dataset.
get_download_url()	Get the download URL for a file.

__init__(name, root, urlbase, auth_cookie=None)

Methods

__init__(name, root, urlbase[, auth_cookie])
download()	Download a file to storage.
fetch([slice_])	Fetch a slice of a dataset.
get_download_url()	Get the download URL for a file.

Attributes

vlmeta

A mapping of metalayer names to their respective values.