110. Smart Replay settings and checks configuration

Smart Replay settings control how scenarios are re-executed and modified during the Smart Replay process in Foretify. You can use these settings to fine-tune the system’s behavior when replaying specific scenario snippets from real-world or simulated driving logs.

Smart Replay checks are user-configurable controls within the Foretify Smart Replay process that monitor the realism and plausibility of replayed scenarios. You can enable or disable these checks to determine how strictly the system enforces constraints.

All Smart Replay configuration is defined using extend smart_replay_config in the OSC file.

110.1 Smart Replay settings

110.1.1 Scenario Path

Description: This is the auto-generated full path of the Smart Replay scenario that is being run.

110.1.2 Trajectory

Description: This is the auto-generated name of the file containing Smart Replay trajectories.

110.1.3 Usable Area Threshold Addition

Description: Adds a threshold to the original region of interest (ROI) in the usable map.

Default Value: 250m

To set the usable area threshold addition, add the following configuration in the OSC scenario:

extend smart_replay_config:
    set usable_area_threshold_addition = <value>m

Example

extend smart_replay_config:
    set usable_area_threshold_addition = 250m

110.1.4 Fail on ingested map validation errors

Description: If set to true, the run will fail on map validation errors. This affects only Smart Replay scenarios extracted from Evaluation Pipeline ingested runs.

Default Value: false

To enable the fail on map validation errors, add the following configuration in the OSC scenario:

extend smart_replay_config:
    set fail_on_ingested_map_validation_errors = true

110.1.5 Maximum vehicles speed

Description: Sets the maximum speed allowed for vehicles in the scenario. This is used to calculate the maximum possible distance a vehicle can move in a single time step.

Default Value: 150kph

To set the maximum vehicle speed, add the following configuration in the OSC scenario:

extend smart_replay_config:
    set max_vehicles_speed = <value>kpm

Example

extend smart_replay_config:
    set enable_max_speed = 120kpm

110.1.6 Ingested post-collosion behavior

Description: If set to true, the vehicle will stop after a collision.

Default Value: false

To enable the post-collision behavior, add the following configuration in the OSC scenario:

extend smart_replay_config:
    set enable_ingested_post_collision_behavior = true

110.2 Smart Replay checks

110.2.1 Ingested Off-Road Check

Description: If set to true, Foretify will check for off-road driving. This affects only Smart Replay scenarios extracted from Evaluation Pipeline ingested runs.

Default Value: false

To enable the ingested off-road check, add the following configuration in the OSC scenario:

extend smart_replay_config:
    set enable_ingested_off_road_check = true

110.2.2 Ingested Collision Check

Description: If set to true, Foretify will check for collisions. This affects only Smart Replay scenarios extracted from Evaluation Pipeline ingested runs.

Default Value: false

To enable the ingested collision check, add the following configuration in the OSC scenario:

extend smart_replay_config:
    set enable_ingested_collision_check = true

110.2.3 Ingested Improbable Move Check

Description: If set to true, Foretify will check for an improbable move — actor behavior that is highly unlikely under typical real-world driving conditions, based on established traffic patterns, human driving behavior, vehicle dynamics, or recorded data. This affects only Smart Replay scenarios extracted from Evaluation Pipeline ingested runs.

Default Value: false

To enable the ingested improbable move check, add the following configuration in the OSC scenario:

extend smart_replay_config:
    set enable_ingested_improbable_check = true