Ursa¶
Database / data-access layer for Constellation’s research stack.
Ursa is Constellation’s data-access layer for multimodal recordings: EEG, video, eye tracking, biometrics, questionnaires, keyboard/mouse/screen captures, and more.
The data model is intentionally minimal: Participant → Recording (recording_hash) → Modality + Events + flexible metadata. No sessions, no trials, no stimuli.
The current implementation is a raw catalog and byte-access layer: a Lance metadata catalog plus ursa.DataInterface.query(), .get(), and .download() for raw modalities. Processed arrays, temporal slicing, streaming windows, vector search, lifecycle GC, and Polaris cache sync are roadmap work.
Contents
- Setup
- Quickstart
- Architecture
- Concepts
- Tutorials
- Runbooks
- API Reference
- API Reference
ursaursa.data_interfaceursa._query_typesursa.catalogursa.catalog.catalogursa.catalog.exceptionsursa.catalog.schemasursa.layoutursa.rawursa.registerursa.register.orchestratorursa.register.payloadursa.storeursa.store.baseursa.store.configursa.store.factoryursa.store.uriursa.temporalursa.time
Where this fits¶
Ursa is one of three packages in Constellation’s research stack:
Ursa (this site) — database / data layer
Virgo — DAG-based preprocessing
Orion — research / training / benchmarking
Full architecture: Research Stack Architecture (Notion).
Status¶
Current shipped scope is raw catalog + raw byte access only. Implementation is tracked in the Linear Ursa project.