Track Types

Track definitions for annotation data.

A track describes one Parquet file in a .mediapkg archive.

Three types:

  • ObservationSeries - Dense time-series (emotion scores, audio volume)

  • AnnotationSeries - Sparse intervals with single labels (transcripts, shots)

  • AnnotationListSeries - Sparse intervals with multiple labels (scene tags)

Example:

from mava_exchange import ObservationSeries, DimensionSpec

emotions = ObservationSeries(
    name="emotions",
    description="Face emotion scores",
    sampling_interval=0.5,
    dimensions=[
        DimensionSpec("happy", "Happiness", "[0,1]"),
        DimensionSpec("sad", "Sadness", "[0,1]")
    ]
)

Choosing a Track Type