Skip to content

166. Lead Vehicle With Traffic On Side

In the lead_vehicle_with_traffic_on_side evaluation scenario, the vehicle_actor drives ahead of the Ego in the same lane, and the Ego follows it while there is traffic on both sides of the Ego.

Scenario location: $FTX/logiq/scenario_library_post_match/lead_vehicle/lead_vehicle_with_traffic_on_side

166.1 Actors

The actors associated with this scenario are as follows:

Actor Description Type Depiction
ego Vehicle under test vehicle
vehicle_actor Lead vehicle vehicle
Figure 1: Lead vehicle with traffic on side

166.2 Scenario phases

The phase descriptions are as follows:

166.2.1 sut_blocked

Ego: The Ego drives in one lane. There is traffic on both sides of the Ego with a maximal headway of time_ahead_sut_where_lane_occupied ahead of the Ego and time_behind_sut_where_lane_occupied behind the Ego.

vehicle_actor: The vehicle_actor drives ahead of the Ego in the same lane and remains close to the Ego at a distance range between min_distance_from_sut_in_time_units and max_distance_from_sut_in_time_units.

166.3 Configuration parameters

Use these parameters to constrain the scenario. If you do not set a specific value, the default value will be used.

Parameter Type Unit Description Default value
time_ahead_sut_where_lane_occupied time s Headway maximum distance between the Ego to any vehicle on the side ahead of the Ego 1s
time_behind_sut_where_lane_occupied time s Headway maximum distance between the Ego to any vehicle on the side behind the Ego 1s
[Click] The input items inherited from the sut.logiq_base_lane_following_scenario scenario are as follows:
Parameter Type Unit Description Default value
min_distance_from_sut_in_time_units time s Minimum headway distance between the Ego and the vehicle actor 0s
max_distance_from_sut_in_time_units time s Maximum headway distance between the Ego and the vehicle actor 5s
[Click] The input items inherited from the sut.logiq_base_vehicle_scenario scenario are as follows:
Parameter Type Unit Description Default value
kinds list of evaluation_object_kind Possible kinds of vehicle_actor in the scenario

166.4 Metrics

166.4.1 Coverage

Item Description Values Unit/Type
lead_speed_at_end Lead vehicle speed at the end of the scenario [0..150), every: 10.0 kph
right_lead_vehicle_speed_at_end Right lead vehicle speed at the end of the scenario [0..150), every: 10.0 kph
left_lead_vehicle_speed_at_end Left lead vehicle speed at the end of the scenario [0..150), every: 10.0 kph
[Click] The coverage items inherited from the sut.logiq_base_lane_following_scenario scenario are as follows:
Item Description Values Unit/Type
ego_min_distance_to_vehicle Minimum distance gap throughout the scenario [0..200), every: 20.0 m
[Click] The coverage items inherited from the sut.logiq_base_vehicle_scenario scenario are as follows:
Item Description Values Unit/Type
vehicle_speed_at_start Agent speed at start of the scenario [0..150), every: 10.0 mph
[Click] The coverage items inherited from the sut.logiq_base_scenario scenario are as follows:
Item Description Values Unit/Type
ego_speed_at_start Ego longitudinal speed at the start of the scenario [0..160), every: 10.0 mph

166.4.2 KPI

[Click] The KPIs inherited from the sut.logiq_base_vehicle_scenario scenario are as follows:
Item Description Values Unit/Type
vehicle_object_kind Object kind as derived from Foretify object, person, cyclist, vehicle, truck, trailer, fod, animal, sign, bus, motorcycle, emergency_vehicle, stationary_vehicle evaluation_object_kind
vehicle_tracking_id Tracking id of the agent as described in the object list data. If the data comes from a generative run, the UID will be used string
vehicle_avg_speed Agent average longitudinal speed throughout the scenario mph
vehicle_max_speed Agent maximum speed throughout the scenario mph
vehicle_min_speed Agent minimum speed throughout the scenario mph
vehicle_max_lon_acceleration Agent maximum longitudinal acceleration throughout the scenario mpsps
vehicle_min_lon_acceleration Agent minimum longitudinal acceleration throughout the scenario mpsps
ego_min_ttc_to_vehicle Minimum time to collision with the reference vehicle throughout the scenario s
ego_min_mttc_to_vehicle Minimum modified time to collision with the reference vehicle throughout the scenario s
[Click] The KPIs inherited from the sut.logiq_base_scenario scenario are as follows:
Item Description Values Unit/Type
ego_max_lon_acceleration Ego maximum acceleration throughout the scenario mpsps
ego_min_lon_acceleration Ego minimum acceleration throughout the scenario mpsps
ego_min_speed Ego minimum longitudinal speed throughout the scenario mph
ego_avg_speed Ego average longitudinal speed throughout the scenario mph
ego_max_speed Ego maximum longitudinal speed throughout the scenario mph
ego_distance_traveled_during_interval Total distance traveled by the Ego during the interval m
interval_duration Interval duration of the scenario s

166.5 Log and Error Messages

No scenario-specific log messages.

166.6 Usage

Import the post-match scenario top file and register the matcher in a match: block, overriding only the parameters you need. Any omitted parameters use the defaults listed in Configuration parameters.

The matcher is also available through the shared post-match import bundle:

  • $FTX/logiq/customers/base/osc/post_match_scenarios.osc
  • $FTX/evaluate/library/scenarios/scenario_library_post_match.osc (evaluation builds).
OSC2 code: lead_vehicle_with_traffic_on_side post-match scenario usage
import "$FTX/logiq/scenario_library_post_match/lead_vehicle/lead_vehicle_with_traffic_on_side/lead_vehicle_with_traffic_on_side_top.osc"

# The following example imports the top file and overrides five parameters:

match:
    lead_vehicle_with_traffic_on_side: sut.lead_vehicle_with_traffic_on_side(time_ahead_sut_where_lane_occupied: 1s,
                                                                             time_behind_sut_where_lane_occupied: 1s,
                                                                             min_distance_from_sut_in_time_units: 0s,
                                                                             max_distance_from_sut_in_time_units: 5s,
                                                                             kinds: [vehicle, cyclist, truck, emergency_vehicle, bus, motorcycle])