Scene Metadata

class py123d.datatypes.SceneMetadata

Metadata for a scene extracted from a log.

Public Data Attributes:

target_iteration_stride	Number of raw sync-table frames per logical iteration.
end_idx	Index of the end frame of the scene (exclusive), accounting for stride.
total_iterations	Total number of iterations including history, current frame, and future.
dataset	Name of the dataset the scene belongs to.
split	Name of the split the scene belongs to.
initial_uuid	UUID of the scene, i.e., the UUID of the starting frame of the scene.
initial_idx	Index of the starting frame of the scene in the log.
num_future_iterations	Number of future iterations in the scene (excludes the current frame).
num_history_iterations	Number of history iterations in the scene (excludes the current frame).
future_duration_s	Forward reach of the scene from the current frame in seconds.
history_duration_s	Backward reach of history before the current frame in seconds.
iteration_duration_s	Approximate duration of each iteration in seconds (inferred from sync table timestamps).

---

dataset: str

Name of the dataset the scene belongs to.

split: str

Name of the split the scene belongs to.

initial_uuid: str

UUID of the scene, i.e., the UUID of the starting frame of the scene.

initial_idx: int

Index of the starting frame of the scene in the log.

num_future_iterations: int

Number of future iterations in the scene (excludes the current frame).

num_history_iterations: int

Number of history iterations in the scene (excludes the current frame).

future_duration_s: float

Forward reach of the scene from the current frame in seconds.

history_duration_s: float

Backward reach of history before the current frame in seconds.

iteration_duration_s: float

Approximate duration of each iteration in seconds (inferred from sync table timestamps). When target_iteration_stride > 1, this reflects the effective strided duration (raw_duration * stride).

target_iteration_stride: int = 1

Number of raw sync-table frames per logical iteration. 1 (default) uses the native log frequency.

property end_idx: int

Index of the end frame of the scene (exclusive), accounting for stride.

property total_iterations: int

Total number of iterations including history, current frame, and future.