Quickstart

Note

The quickstart will be written once the M2 underbuilt-MVP lands. See ENG-892 for status.

The intended shape:

import ursa

# Common case: kwargs (auto-validated against QuerySpec)
data = ursa.query(
    participants=["p042", "p043"],
    modalities=["eeg", "pupil"],
    time_range=(t_start, t_end),
    metadata={"context": "work_session"},
    pipeline_version="standard_v2026q2",
)

# Single-recording shortcuts
rec    = ursa.get(recording_hash="abc123")
mod    = ursa.get(recording_hash="abc123", modality="eeg")
slice_ = ursa.get(recording_hash="abc123", modality="eeg", time=(100.0, 110.0))

# Streaming for training / long sessions
for window in ursa.stream(spec, window=10.0, stride=1.0, batch_size=8):
    ...