diplomat.utils.extract_frames.unpack_frame_string

diplomat.utils.extract_frames.unpack_frame_string(frame_string: bytes, frames_per_iter: int = 0) → Union[TrackingData, Generator[TrackingData, None, None]]

Unpack a frame store string into a tracking data object for access to the original probability frame data.

Parameters

• frame_string – A bytes object containing the base64 encoded frame store file.

• frames_per_iter – Number of frames to return in each TrackingData object generated. If this value is set to 0 or less, this function returns a single TrackingData object storing all frames instead of returning a generator.

Returns

A single TrackingData object if frames_per_iter <= 0, a Generator of TrackingData objects if frames_per_iter > 0.