Skip to content

Trajectory ​

One recorded episode trajectory.

The surface deliberately shared by mrkwatkins.oakemu_rl.gymnasium.TrajectoryFile.TrajectoryFile (a wrapper over the pythonnet TrajectoryFile object) and mrkwatkins.oakemu_rl.gymnasium.TrajectoryData.TrajectoryData (parsed from the raw interop wire bytes). Consumers should depend on this protocol rather than either implementation.

Source

Properties ​

action_map ​

python
action_map: tuple[str, ...]

The action names stored in the trajectory map.

Source

actions ​

python
actions: bytes

The action indices up to the last interesting marker.

Source

captured_expression_labels ​

python
captured_expression_labels: tuple[str, ...]

The captured value labels, in marker value order.

Source

emulator_type ​

python
emulator_type: int

The OakEmu emulator type.

Source

end_state ​

python
end_state: bytes | None

The snapshot at the last interesting marker, if present.

Source

end_values ​

python
end_values: dict[str, int]

The values captured at the last interesting marker.

Source

episode_actions ​

python
episode_actions: bytes

The full episode action indices.

Source

episode_end_state ​

python
episode_end_state: bytes

The snapshot at the end marker.

Source

episode_end_values ​

python
episode_end_values: dict[str, int]

The values captured at the end marker.

Source

frame_skip ​

python
frame_skip: int

The frame-skip value stored in the trajectory.

Source

has_end_state ​

python
has_end_state: bool

Whether the episode contains at least one interesting marker.

Source

initial_state ​

python
initial_state: bytes

The serialised emulator state at the start of the episode.

Source

interesting_markers ​

python
interesting_markers: tuple[TrajectoryMarker, ...]

Only the interesting-point markers.

Source

markers ​

python
markers: tuple[TrajectoryMarker, ...]

The ordered markers emitted for the episode.

Source

screen_type ​

python
screen_type: int

The OakEmu screen type.

Source

start_values ​

python
start_values: dict[str, int]

The values captured at the start marker.

Source

trigger_definitions ​

python
trigger_definitions: tuple[TrajectoryTriggerDefinition, ...]

The trigger definitions stored in the episode block.

Source

Methods ​

interesting_segments ​

python
interesting_segments() -> tuple[TrajectorySegment, ...]

Split the full episode into boundary-to-boundary segments ending at interesting or final markers.

Returns:

  • tuple[TrajectorySegment, ...] – The derived interesting segments in episode order.

Source