Planning Validator

The autoware_planning_validator is a module that checks the validity of a trajectory before it is published. The status of the validation can be viewed in the /diagnostics and /validation_status topics. When an invalid trajectory is detected, the autoware_planning_validator will process the trajectory following the selected option: “0. publish the trajectory as it is”, “1. stop publishing the trajectory”, “2. publish the last validated trajectory”.

Supported features

The following features are supported for trajectory validation and can have thresholds set by parameters:

• Invalid field : e.g. Inf, Nan
• Trajectory points interval : invalid if any of the distance of trajectory points is too large
• Curvature : invalid if the trajectory has too sharp turns that is not feasible for the given vehicle kinematics
• Relative angle : invalid if the yaw angle changes too fast in the sequence of trajectory points
• Lateral acceleration : invalid if the expected lateral acceleration/deceleration is too large
• Longitudinal acceleration/deceleration : invalid if the acceleration/deceleration in the trajectory point is too large
• Steering angle : invalid if the expected steering value is too large estimated from trajectory curvature
• Steering angle rate : invalid if the expected steering rate value is too large
• Velocity deviation : invalid if the planning velocity is too far from the ego velocity
• Distance deviation : invalid if the ego is too far from the trajectory
• Longitudinal distance deviation : invalid if the trajectory is too far from ego in longitudinal direction
• Forward trajectory length : invalid if the trajectory length is not enough to stop within a given deceleration
• Yaw difference : invalid if the difference between the ego yaw and closest trajectory yaw is too large

The following features are to be implemented.

• (TODO) TTC calculation : invalid if the expected time-to-collision is too short on the trajectory

Inputs/Outputs

Inputs

The autoware_planning_validator takes in the following inputs:

Outputs

It outputs the following:

Parameters

The following parameters can be set for the autoware_planning_validator:

System parameters

Algorithm parameters

Thresholds

The input trajectory is detected as invalid if the index exceeds the following thresholds.

Parameters

For parameters used e.g. to calculate threshold.

Changelog for package autoware_planning_validator

0.43.0 (2025-03-21)

• Merge remote-tracking branch 'origin/main' into chore/bump-version-0.43
• chore: rename from [autoware.universe]{.title-ref} to [autoware_universe]{.title-ref} (#10306)
• feat: adaption to ROS nodes guidelines about directory structure (#10268)
• feat(planning_validator): add yaw deviation metric (#10258)
• feat(planning_validator): add diag to check planning component latency (#10241)
  • feat(planning_validator): add diag to check planning component latency
  • fix: relax threshold
  • fix: lacking param
  • fix: relax threshold
  • fix: relax threshold

  * fix: add time stamp ---------

• Contributors: Hayato Mizushima, Maxime CLEMENT, NorahXiong, Satoshi OTA, Yutaka Kondo

0.42.0 (2025-03-03)

• Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
• feat(autoware_utils): replace autoware_universe_utils with autoware_utils (#10191)
• feat(planning_test_manager): abstract message-specific functions (#9882)
  • abstract message-specific functions
  • include necessary header
  • adapt velocity_smoother to new test manager
  • adapt behavior_velocity_planner to new test manager
  • adapt path_optimizer to new test manager
  • fix output subscription
  • adapt behavior_path_planner to new test manager
  • adapt scenario_selector to new test manager
  • adapt freespace_planner to new test manager
  • adapt planning_validator to new test manager
  • adapt obstacle_stop_planner to new test manager
  • adapt obstacle_cruise_planner to new test manager
  • disable test for freespace_planner
  • adapt behavior_velocity_crosswalk_module to new test manager
  • adapt behavior_path_lane_change_module to new test manager
  • adapt behavior_path_avoidance_by_lane_change_module to new test manager
  • adapt behavior_path_dynamic_obstacle_avoidance_module to new test manager
  • adapt behavior_path_external_request_lane_change_module to new test manager
  • adapt behavior_path_side_shift_module to new test manager
  • adapt behavior_path_static_obstacle_avoidance_module to new test manager
  • adapt path_smoother to new test manager
  • adapt behavior_velocity_blind_spot_module to new test manager
  • adapt behavior_velocity_detection_area_module to new test manager
  • adapt behavior_velocity_intersection_module to new test manager
  • adapt behavior_velocity_no_stopping_area_module to new test manager
  • adapt behavior_velocity_run_out_module to new test manager
  • adapt behavior_velocity_stop_line_module to new test manager
  • adapt behavior_velocity_traffic_light_module to new test manager
  • adapt behavior_velocity_virtual_traffic_light_module to new test manager
  • adapt behavior_velocity_walkway_module to new test manager
  • adapt motion_velocity_planner_node_universe to new test manager
  • include necessary headers

  * Odometries -> Odometry ---------Co-authored-by: Takayuki Murooka <<takayuki5168@gmail.com>>

• Contributors: Fumiya Watanabe, Mitsuhiro Sakamoto, 心刚

0.41.2 (2025-02-19)

• chore: bump version to 0.41.1 (#10088)
• Contributors: Ryohsuke Mitsudome

0.41.1 (2025-02-10)

0.41.0 (2025-01-29)

• Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
• feat(autoware_planning_validator)!: tier4_debug_msgs changed to autoware_internal_debug_msgs in autoware_planning_validator (#9911) feat: tier4_debug_msgs changed to autoware_internal_debug_msgs in files planning/autoware_planning_validator
• Contributors: Fumiya Watanabe, Vishal Chauhan

0.40.0 (2024-12-12)

• Merge branch 'main' into release-0.40.0
• Revert "chore(package.xml): bump version to 0.39.0 (#9587)" This reverts commit c9f0f2688c57b0f657f5c1f28f036a970682e7f5.
• fix: fix ticket links in CHANGELOG.rst (#9588)
• chore(package.xml): bump version to 0.39.0 (#9587)
  • chore(package.xml): bump version to 0.39.0
  • fix: fix ticket links in CHANGELOG.rst

  * fix: remove unnecessary diff ---------Co-authored-by: Yutaka Kondo <<yutaka.kondo@youtalk.jp>>

• fix: fix ticket links in CHANGELOG.rst (#9588)
• fix(cpplint): include what you use - planning (#9570)
• 0.39.0
• update changelog
• fix: fix ticket links to point to https://github.com/autowarefoundation/autoware_universe (#9304)
• fix: fix ticket links to point to https://github.com/autowarefoundation/autoware_universe (#9304)
• chore(package.xml): bump version to 0.38.0 (#9266) (#9284)
  • unify package.xml version to 0.37.0
  • remove system_monitor/CHANGELOG.rst
  • add changelog

  * 0.38.0

• Contributors: Esteve Fernandez, Fumiya Watanabe, M. Fatih Cırıt, Ryohsuke Mitsudome, Yutaka Kondo

0.39.0 (2024-11-25)

• fix: fix ticket links to point to https://github.com/autowarefoundation/autoware_universe (#9304)
• fix: fix ticket links to point to https://github.com/autowarefoundation/autoware_universe (#9304)
• chore(package.xml): bump version to 0.38.0 (#9266) (#9284)
  • unify package.xml version to 0.37.0
  • remove system_monitor/CHANGELOG.rst
  • add changelog

  * 0.38.0

• Contributors: Esteve Fernandez, Yutaka Kondo

0.38.0 (2024-11-08)

• unify package.xml version to 0.37.0
• fix(autoware_planning_validator): fix unusedFunction (#8646) fix:unusedFunction
• fix(autoware_planning_validator): fix knownConditionTrueFalse (#7817)
• refactor(universe_utils/motion_utils)!: add autoware namespace (#7594)
• refactor(motion_utils)!: add autoware prefix and include dir (#7539) refactor(motion_utils): add autoware prefix and include dir
• feat(autoware_universe_utils)!: rename from tier4_autoware_utils (#7538) Co-authored-by: kosuke55 <<kosuke.tnp@gmail.com>>
• feat(planning_validator): rename to include/autoware/{package_name} (#7514)
  • feat(planning_validator): rename to include/autoware/{package_name}

  * fix

• refactor(test_utils): move to common folder (#7158)
  • Move autoware planning test manager to autoware namespace
  • fix package share directory for behavior path planner
  • renaming files and directory
  • rename variables that has planning_test_utils in its name.
  • use autoware namespace for test utils
  • move folder to common
  • update .pages file
  • fix test error
  • removed obstacle velocity limiter test artifact

  * remove namespace from planning validator, it has using keyword ---------

• refactor(planning_validator)!: rename directory name (#7411) change directory name
• Contributors: Kosuke Takeuchi, Kyoichi Sugahara, Ryuta Kambe, Takayuki Murooka, Yutaka Kondo, Zulfaqar Azmi, kobayu858

0.26.0 (2024-04-03)