ursa.raw

M2 raw-modality payload (ENG-890).

class:

RawBytes is a thin carrier surfaced on :class:ursa.Data under data.modalities[name] for modalities with ingestion_status="raw". No time domain, no parsing — :func:ursa.get reads the segment files at ModalityRow.raw_storage_uri and packages them as (key, bytes) tuples in store-listing order.

ENG-1093 replaces this with array-bearing temporaldata subclasses once Virgo’s ingestion node populates the processed store; this module goes away then.

Module Contents

Classes

RawBytes

List-of-segments raw-modality payload.

Data

__all__

API

ursa.raw.__all__

[‘RawBytes’]

class ursa.raw.RawBytes[source]

List-of-segments raw-modality payload.

segments holds (object_key, bytes) tuples in sorted-key order (the get-path applies sorted(..., key=meta.key) so callers don’t have to). metadata is the same :class:ModalityRow the catalog returned via :class:QueryResult.

A list of segments — rather than one concatenated blob — preserves framed formats (video, parquet, lance) faithfully. Callers that want one byte string can do b"".join(b for _, b in rb.segments) for formats where naïve concat is meaningful (CSV / JSONL / raw binary).

segments: tuple[tuple[str, bytes], ...]

None

metadata: ursa.catalog.schemas.ModalityRow

None