Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_behavior_path_avoidance_by_lane_change_module at Robotics Stack Exchange
Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_behavior_path_avoidance_by_lane_change_module at Robotics Stack Exchange
Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_behavior_path_avoidance_by_lane_change_module at Robotics Stack Exchange
Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_behavior_path_avoidance_by_lane_change_module at Robotics Stack Exchange
Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_behavior_path_avoidance_by_lane_change_module at Robotics Stack Exchange
Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_behavior_path_avoidance_by_lane_change_module at Robotics Stack Exchange
Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_behavior_path_avoidance_by_lane_change_module at Robotics Stack Exchange
Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_behavior_path_avoidance_by_lane_change_module at Robotics Stack Exchange
Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_behavior_path_avoidance_by_lane_change_module at Robotics Stack Exchange
Package Summary
| Version | 0.53.0 |
| License | Apache License 2.0 |
| Build type | AMENT_CMAKE |
| Use | RECOMMENDED |
Repository Summary
| Description | |
| Checkout URI | https://github.com/autowarefoundation/autoware_universe.git |
| VCS Type | git |
| VCS Version | main |
| Last Updated | 2026-10-23 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Zulfaqar Azmi
- Fumiya Watanabe
- Tomoya Kimura
- Shumpei Wakabayashi
- Tomohito Ando
- Maxime CLEMENT
- Alqudah Mohammad
Authors
- Satoshi Ota
Avoidance by lane change design
This is a sub-module to avoid obstacles by lane change maneuver.
Purpose / Role
This module is designed as one of the obstacle avoidance features and generates a lane change path if the following conditions are satisfied.
- Exist lane changeable lanelet.
- Exist avoidance target objects on ego driving lane.
Inner-workings / Algorithms
Basically, this module is implemented by reusing the avoidance target filtering logic of the existing Static Object Avoidance Module and the path generation logic of the Normal Lane Change Module. On the other hand, the conditions under which the module is activated differ from those of a normal avoidance module.
Check that the following conditions are satisfied after the filtering process for the avoidance target.
Number of the avoidance target objects
This module is launched when the number of avoidance target objects on EGO DRIVING LANE is greater than execute_object_num. If there are no avoidance targets in the ego driving lane or their number is less than the parameter, the obstacle is avoided by normal avoidance behavior (if the normal avoidance module is registered).
Lane change end point condition
Unlike the normal avoidance module, which specifies the shift line end point, this module does not specify its end point when generating a lane change path. On the other hand, setting execute_only_when_lane_change_finish_before_object to true will activate this module only if the lane change can be completed before the avoidance target object.
Although setting the parameter to false would increase the scene of avoidance by lane change, it is assumed that sufficient lateral margin may not be ensured in some cases because the vehicle passes by the side of obstacles during the lane change.
Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| execute_object_num | [-] | int | Number of avoidance target objects on ego driving lane is greater than this value, this module will be launched. | 1 |
| execute_object_longitudinal_margin | [m] | double | [maybe unused] Only when distance between the ego and avoidance target object is longer than this value, this module will be launched. | 0.0 |
| execute_only_when_lane_change_finish_before_object | [-] | bool | If this flag set true, this module will be launched only when the lane change end point is NOT behind the avoidance target object. |
true |
Changelog for package autoware_behavior_path_avoidance_by_lane_change_module
0.53.0 (2026-09-29)
- Merge remote-tracking branch 'origin/main' into prepare-0.53.0-changelog
- chore(planning): update package maintainers (#13186)
- Contributors: Ryohsuke Mitsudome, Satoshi OTA
0.52.0 (2026-06-30)
0.51.0 (2026-05-01)
-
Merge remote-tracking branch 'origin/main' into tmp/bot/bump_version_base
-
chore(behavior_path_planner): remove unused lanelet2_extension header (#12292) unused lanelet2_extension in bpp modules Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
feat(autoware_lanelet2_extension): replace remaining lanelet2_extension utilities functions - bpp packages (#12085)
- replace getArcCoordinates in bpp packages
- replace getArcCoordinates usage in bpp packages (2)
* replace getArcCoordinates in bpp package (3) (autoware_behavior_path_goal_planner_module)
* replace getArcCoordinates in bpp package(4) (autoware_behavior_path_start_planner_module)
- replace getLateralDistanceToClosestLanelet in bpp package
- replace getExpandedLanelet(s) in bpp package
- replace combineLaneletsShape in bpp packages
- fix wrong condition in bpp
- style(pre-commit): autofix
- remove directly dereference opt for combine_lanelet
- remove log if lanelet is empty
- bind reference to optional value for combine_lanelets_shape
- remove log and simply return outside else in get_dirty_expanded_lanelets opt
* remove .has_value in lane_change_module for consistency ---------Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com> Co-authored-by: Mamoru Sobue <<hilo.soblin@gmail.com>>
-
Contributors: Sarun MUKDAPITAK, github-actions
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- fix(behavior_path_planner): fix funcArgNamesDifferent (#11981)
- Contributors: Ryohsuke Mitsudome, Ryuta Kambe
0.49.0 (2025-12-30)
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions (#11487)
- Revert "fix(static_obstacle_avoidance): ensure sufficient avoidance margin on high-curvature paths for parked vehicle avoidance (#10902)"
- feat(static_obstacle_avoidance): enhance overhang distance calculation with vehicle dimensions
- Updated [calcEnvelopeOverhangDistance]{.title-ref} to include vehicle front and rear overhang parameters for more accurate obstacle avoidance.
- Introduced new utility functions for calculating lateral distances and filling midpoints of polygon edges.
- Improved the logic for determining overhang points based on the updated vehicle dimensions. This change aims to ensure better obstacle avoidance performance by considering the vehicle's physical characteristics.
- fix(test_utils): update overhang distance calculation in tests to include additional parameters
- Modified calls to [calcEnvelopeOverhangDistance]{.title-ref} in multiple test cases to include new parameters for improved accuracy.
- Ensured consistency in testing behavior for obstacle avoidance scenarios. This change aligns the test cases with the recent enhancements made to the overhang distance calculation logic.
- refactor(static_obstacle_avoidance): update utility function calls for lateral distance and midpoint calculations
File truncated at 100 lines see the full file