mava_exchange.reader.MediaPackageReader¶

class mava_exchange.reader.MediaPackageReader(path: str | Path)¶

Read .mediapkg archive files.

Use as a context manager or call open()/close() manually.

Example:

with MediaPackageReader("corpus.mediapkg") as r:
    print(r.video_ids)
    print(r.track_names)
    df = r.read_track("v001", "emotions")

__init__(path: str | Path)¶

Initialize reader.

Methods

`__init__`(path)	Initialize reader.
`close`()	Close the package file.
`open`()	Open the package for reading.
`read_track`(video_id, track_name)	Read a track's data into a DataFrame.
`read_video`(video_id)	Read all tracks for a video.
`track_def`(track_name)	Get track definition object.
`tracks_for_video`(video_id)	List track names available for a video.
`video_meta`(video_id)	Get video metadata.

Attributes

`manifest`	The parsed manifest.json dictionary.
`track_names`	List of all track names across all videos.
`video_ids`	List of video IDs in the package.

property track_names: list[str]¶: List of all track names across all videos.

video_meta(video_id: str) → dict¶

Get video metadata.

Returns src, title, duration etc. (excludes file paths).

Get track definition object.

tracks_for_video(video_id: str) → list[str]¶: List track names available for a video.

read_track(video_id: str, track_name: str) → DataFrame¶

Read a track’s data into a DataFrame.

Parameters:

Returns:

Track data with columns matching the track definition

Return type:

pd.DataFrame

read_video(video_id: str) → dict[str, DataFrame]¶

Read all tracks for a video.