mava_exchange.tracks.AnnotationListSeries

class mava_exchange.tracks.AnnotationListSeries(name: str, description: str)

Sparse interval annotations with multiple labels per segment.

Use for multi-label scene tags, keywords, or any annotation where multiple values apply simultaneously to a time segment.

Each row in the Parquet file needs: start_seconds, end_seconds, annotations (as Python lists).

Example:

scene_tags = AnnotationListSeries(
    name="scene_tags",
    description="Scene classification (indoor/outdoor + natural/man-made)"
)

df = pd.DataFrame({
    "start_seconds": [0.0, 45.2, 78.5],
    "end_seconds": [45.2, 78.5, 120.0],
    "annotations": [
        ["outdoor", "natural"],
        ["indoor"],
        ["outdoor", "man-made"]
    ]
})
__init__(name: str, description: str) None

Methods

__init__(name, description)

to_dict()

Converts to dictionary for manifest.json.

Attributes

columns

Returns column names.

type

name

Track name (must be unique within package).

description

Human-readable description of what this track contains.

name: str

Track name (must be unique within package).

description: str

Human-readable description of what this track contains.

type: Literal['mava:AnnotationListSeries'] = 'mava:AnnotationListSeries'
property columns: list[str]

Returns column names.

to_dict() dict

Converts to dictionary for manifest.json.