Package Summary
| Version | 0.50.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-02-25 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Takumi Odashima
- Yuki Takagi
- Satoshi Ota
Authors
Road User Stop
Role
The road_user_stop module stops the ego vehicle when pedestrians, cyclists, or other road users are detected on or near the road within the ego’s planned trajectory. This module ensures safe interaction with vulnerable road users by maintaining appropriate stopping distances and making decisions about when to stop versus when to continue driving.
Activation
This module is activated if the launch parameter launch_road_user_stop_module is set to true.
Parameters
Option Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| suppress_sudden_stop | [-] | bool | Enable to suppress sudden stop | true |
Stop Planning Parameters
Longitudinal Margin Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| default_margin | [m] | double | Default longitudinal margin to obstacle | 5.0 |
| terminal_margin | [m] | double | Stop margin at the goal position | 3.0 |
| minimum_margin | [m] | double | Minimum stop margin for behavior decision | 3.0 |
Opposing Traffic Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| stop_margin | [m] | double | Ideal stop-margin from moving opposing obstacle when ego stops | 10.0 |
| max_negative_velocity | [m/s] | double | Maximum velocity of opposing traffic to consider stop planning | -0.1 |
| min_velocity_for_stop_planning | [m/s] | double | Minimum velocity of ego to consider stop planning | 2.77 |
| effective_deceleration | [m/s^2] | double | Higher value brings final stop-margin closer to ideal value | 4.0 |
General Stop Planning Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| hold_stop_velocity_threshold | [m/s] | double | The maximum ego velocity to hold stopping | 0.01 |
| hold_stop_distance_threshold | [m] | double | The ego keeps stopping if distance to stop changes within threshold | 0.3 |
| limit_min_acc | [m/s^2] | double | Overwrite the deceleration limit (usually from common_param.yaml) | -2.5 |
| sudden_object_acc_threshold | [m/s^2] | double | If stop achievable by smaller deceleration, not “sudden stop” | -1.0 |
| sudden_object_dist_threshold | [m] | double | If stop distance is longer than this, not considered “sudden stop” | 1000.0 |
| abandon_to_stop | [-] | bool | Give up stopping when cannot avoid run over within decel limit | false |
Stop on Curve Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable_approaching | [-] | bool | Enable approaching behavior on curved paths | false |
| additional_stop_margin | [m] | double | Additional stop margin for obstacles on curves | 3.0 |
| min_stop_margin | [m] | double | Minimum stop margin on curves | 6.0 |
Obstacle Filtering Parameters
Object Type Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| pedestrian | [-] | bool | Enable detection of pedestrians | true |
| bicycle | [-] | bool | Enable detection of bicycles | true |
| motorcycle | [-] | bool | Enable detection of motorcycles | false |
| unknown | [-] | bool | Enable detection of unknown objects | false |
General Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| trajectory_lateral_margin | [m] | double | Lateral margin from ego trajectory to detect objects | 1.0 |
Intersection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | If true, exclude objects inside intersection lanelets from detection | false |
Crosswalk Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | Exclude objects near crosswalks | true |
| margin | [m] | double | Margin distance from crosswalk | 1.0 |
Opposing Traffic Detection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable | [-] | bool | Enable wrong-way object detection | true |
| angle_threshold | [deg] | double | Angle threshold for wrong-way detection | 150.0 |
| min_speed_threshold | [m/s] | double | Minimum speed for wrong-way detection | 0.5 |
Temporal Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| min_detection_duration | [s] | double | Minimum duration for object detection | 0.1 |
| lost_object_retention_duration | [s] | double | Duration to keep tracking objects after they are lost or exit the detection area | 2.0 |
File truncated at 100 lines see the full file
Changelog for package autoware_motion_velocity_road_user_stop_module
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- perf(road_user_stop): reduce the number of published debug markers (#11865)
- feat(motion_velocity_planner): publish debug trajectory for each module (#11781)
- Contributors: Maxime CLEMENT, Ryohsuke Mitsudome
0.49.0 (2025-12-30)
-
Merge remote-tracking branch 'origin/main' into prepare-0.49.0-changelog
-
refactor: fix leftover dependent autoware_utils from updating vehicle_info_utils (#11734)
-
fix(road_user_stop): fix topic name string (#11678)
-
feat(motion_velocity_planner): refactor time publisher (#11646)
- delete bdp time publish
- delete dynamic_obstacle_stop time publish
- delete obstacle_cruise time publish
- delete obstacle_slow_down time publish
- delete obstacle_velocity_limiter time publish
- delete out of lane time publish
- delete run out time publish
* add short module name function ---------
-
Contributors: Mete Fatih Cırıt, Ryohsuke Mitsudome, Yuki TAKAGI
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
fix(road_user_stop): delete path_length_buffer (#11653)
-
fix: tf2 uses hpp headers in rolling (and is backported) (#11620)
-
docs(road_user_stop): add parameter docs (#11539) add parameters docs
-
feat(road_user_stop): exclude ego vehicle's sides from detection area (#11496)
- exclude ego side polygon
- fix typo
* delete polygon_utils copy function ---------
-
feat(road_user_stop): pass for stop vru (#11491)
- pass for stop vru
* fix cppcheck ---------
-
Contributors: Kotakku, Ryohsuke Mitsudome, Tim Clephas, Yuki TAKAGI
0.47.1 (2025-08-14)
0.47.0 (2025-08-11)
-
fix(road_user_stop): remove generate_parameter_library's default_value parameters (#11117)
- delete generate_parameter_library's_default_value parameter
* rerun ci ---------
-
feat(road_user_stop): add road_user_stop module (#11041)
- initial commit of road_user_stop module
- add stop condition for wrong user and masked adjacent lanelet
- update detection and stop planning method
- change stop plan algorithm
- use generate_parameter_library
- chattering prevention and on/off parameterize of intersection and crosswalk
- change detection method of intersection, and tidy up
- enable gtest
- fix default parameter to match obstacle_stop
- code tidy up
- update readme
- fix based on PR review
- remove dead code
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
| Name |
|---|
| libboost-dev |
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_motion_velocity_road_user_stop_module at Robotics Stack Exchange
Package Summary
| Version | 0.50.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-02-25 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Takumi Odashima
- Yuki Takagi
- Satoshi Ota
Authors
Road User Stop
Role
The road_user_stop module stops the ego vehicle when pedestrians, cyclists, or other road users are detected on or near the road within the ego’s planned trajectory. This module ensures safe interaction with vulnerable road users by maintaining appropriate stopping distances and making decisions about when to stop versus when to continue driving.
Activation
This module is activated if the launch parameter launch_road_user_stop_module is set to true.
Parameters
Option Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| suppress_sudden_stop | [-] | bool | Enable to suppress sudden stop | true |
Stop Planning Parameters
Longitudinal Margin Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| default_margin | [m] | double | Default longitudinal margin to obstacle | 5.0 |
| terminal_margin | [m] | double | Stop margin at the goal position | 3.0 |
| minimum_margin | [m] | double | Minimum stop margin for behavior decision | 3.0 |
Opposing Traffic Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| stop_margin | [m] | double | Ideal stop-margin from moving opposing obstacle when ego stops | 10.0 |
| max_negative_velocity | [m/s] | double | Maximum velocity of opposing traffic to consider stop planning | -0.1 |
| min_velocity_for_stop_planning | [m/s] | double | Minimum velocity of ego to consider stop planning | 2.77 |
| effective_deceleration | [m/s^2] | double | Higher value brings final stop-margin closer to ideal value | 4.0 |
General Stop Planning Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| hold_stop_velocity_threshold | [m/s] | double | The maximum ego velocity to hold stopping | 0.01 |
| hold_stop_distance_threshold | [m] | double | The ego keeps stopping if distance to stop changes within threshold | 0.3 |
| limit_min_acc | [m/s^2] | double | Overwrite the deceleration limit (usually from common_param.yaml) | -2.5 |
| sudden_object_acc_threshold | [m/s^2] | double | If stop achievable by smaller deceleration, not “sudden stop” | -1.0 |
| sudden_object_dist_threshold | [m] | double | If stop distance is longer than this, not considered “sudden stop” | 1000.0 |
| abandon_to_stop | [-] | bool | Give up stopping when cannot avoid run over within decel limit | false |
Stop on Curve Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable_approaching | [-] | bool | Enable approaching behavior on curved paths | false |
| additional_stop_margin | [m] | double | Additional stop margin for obstacles on curves | 3.0 |
| min_stop_margin | [m] | double | Minimum stop margin on curves | 6.0 |
Obstacle Filtering Parameters
Object Type Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| pedestrian | [-] | bool | Enable detection of pedestrians | true |
| bicycle | [-] | bool | Enable detection of bicycles | true |
| motorcycle | [-] | bool | Enable detection of motorcycles | false |
| unknown | [-] | bool | Enable detection of unknown objects | false |
General Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| trajectory_lateral_margin | [m] | double | Lateral margin from ego trajectory to detect objects | 1.0 |
Intersection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | If true, exclude objects inside intersection lanelets from detection | false |
Crosswalk Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | Exclude objects near crosswalks | true |
| margin | [m] | double | Margin distance from crosswalk | 1.0 |
Opposing Traffic Detection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable | [-] | bool | Enable wrong-way object detection | true |
| angle_threshold | [deg] | double | Angle threshold for wrong-way detection | 150.0 |
| min_speed_threshold | [m/s] | double | Minimum speed for wrong-way detection | 0.5 |
Temporal Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| min_detection_duration | [s] | double | Minimum duration for object detection | 0.1 |
| lost_object_retention_duration | [s] | double | Duration to keep tracking objects after they are lost or exit the detection area | 2.0 |
File truncated at 100 lines see the full file
Changelog for package autoware_motion_velocity_road_user_stop_module
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- perf(road_user_stop): reduce the number of published debug markers (#11865)
- feat(motion_velocity_planner): publish debug trajectory for each module (#11781)
- Contributors: Maxime CLEMENT, Ryohsuke Mitsudome
0.49.0 (2025-12-30)
-
Merge remote-tracking branch 'origin/main' into prepare-0.49.0-changelog
-
refactor: fix leftover dependent autoware_utils from updating vehicle_info_utils (#11734)
-
fix(road_user_stop): fix topic name string (#11678)
-
feat(motion_velocity_planner): refactor time publisher (#11646)
- delete bdp time publish
- delete dynamic_obstacle_stop time publish
- delete obstacle_cruise time publish
- delete obstacle_slow_down time publish
- delete obstacle_velocity_limiter time publish
- delete out of lane time publish
- delete run out time publish
* add short module name function ---------
-
Contributors: Mete Fatih Cırıt, Ryohsuke Mitsudome, Yuki TAKAGI
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
fix(road_user_stop): delete path_length_buffer (#11653)
-
fix: tf2 uses hpp headers in rolling (and is backported) (#11620)
-
docs(road_user_stop): add parameter docs (#11539) add parameters docs
-
feat(road_user_stop): exclude ego vehicle's sides from detection area (#11496)
- exclude ego side polygon
- fix typo
* delete polygon_utils copy function ---------
-
feat(road_user_stop): pass for stop vru (#11491)
- pass for stop vru
* fix cppcheck ---------
-
Contributors: Kotakku, Ryohsuke Mitsudome, Tim Clephas, Yuki TAKAGI
0.47.1 (2025-08-14)
0.47.0 (2025-08-11)
-
fix(road_user_stop): remove generate_parameter_library's default_value parameters (#11117)
- delete generate_parameter_library's_default_value parameter
* rerun ci ---------
-
feat(road_user_stop): add road_user_stop module (#11041)
- initial commit of road_user_stop module
- add stop condition for wrong user and masked adjacent lanelet
- update detection and stop planning method
- change stop plan algorithm
- use generate_parameter_library
- chattering prevention and on/off parameterize of intersection and crosswalk
- change detection method of intersection, and tidy up
- enable gtest
- fix default parameter to match obstacle_stop
- code tidy up
- update readme
- fix based on PR review
- remove dead code
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
| Name |
|---|
| libboost-dev |
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_motion_velocity_road_user_stop_module at Robotics Stack Exchange
Package Summary
| Version | 0.50.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-02-25 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Takumi Odashima
- Yuki Takagi
- Satoshi Ota
Authors
Road User Stop
Role
The road_user_stop module stops the ego vehicle when pedestrians, cyclists, or other road users are detected on or near the road within the ego’s planned trajectory. This module ensures safe interaction with vulnerable road users by maintaining appropriate stopping distances and making decisions about when to stop versus when to continue driving.
Activation
This module is activated if the launch parameter launch_road_user_stop_module is set to true.
Parameters
Option Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| suppress_sudden_stop | [-] | bool | Enable to suppress sudden stop | true |
Stop Planning Parameters
Longitudinal Margin Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| default_margin | [m] | double | Default longitudinal margin to obstacle | 5.0 |
| terminal_margin | [m] | double | Stop margin at the goal position | 3.0 |
| minimum_margin | [m] | double | Minimum stop margin for behavior decision | 3.0 |
Opposing Traffic Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| stop_margin | [m] | double | Ideal stop-margin from moving opposing obstacle when ego stops | 10.0 |
| max_negative_velocity | [m/s] | double | Maximum velocity of opposing traffic to consider stop planning | -0.1 |
| min_velocity_for_stop_planning | [m/s] | double | Minimum velocity of ego to consider stop planning | 2.77 |
| effective_deceleration | [m/s^2] | double | Higher value brings final stop-margin closer to ideal value | 4.0 |
General Stop Planning Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| hold_stop_velocity_threshold | [m/s] | double | The maximum ego velocity to hold stopping | 0.01 |
| hold_stop_distance_threshold | [m] | double | The ego keeps stopping if distance to stop changes within threshold | 0.3 |
| limit_min_acc | [m/s^2] | double | Overwrite the deceleration limit (usually from common_param.yaml) | -2.5 |
| sudden_object_acc_threshold | [m/s^2] | double | If stop achievable by smaller deceleration, not “sudden stop” | -1.0 |
| sudden_object_dist_threshold | [m] | double | If stop distance is longer than this, not considered “sudden stop” | 1000.0 |
| abandon_to_stop | [-] | bool | Give up stopping when cannot avoid run over within decel limit | false |
Stop on Curve Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable_approaching | [-] | bool | Enable approaching behavior on curved paths | false |
| additional_stop_margin | [m] | double | Additional stop margin for obstacles on curves | 3.0 |
| min_stop_margin | [m] | double | Minimum stop margin on curves | 6.0 |
Obstacle Filtering Parameters
Object Type Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| pedestrian | [-] | bool | Enable detection of pedestrians | true |
| bicycle | [-] | bool | Enable detection of bicycles | true |
| motorcycle | [-] | bool | Enable detection of motorcycles | false |
| unknown | [-] | bool | Enable detection of unknown objects | false |
General Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| trajectory_lateral_margin | [m] | double | Lateral margin from ego trajectory to detect objects | 1.0 |
Intersection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | If true, exclude objects inside intersection lanelets from detection | false |
Crosswalk Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | Exclude objects near crosswalks | true |
| margin | [m] | double | Margin distance from crosswalk | 1.0 |
Opposing Traffic Detection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable | [-] | bool | Enable wrong-way object detection | true |
| angle_threshold | [deg] | double | Angle threshold for wrong-way detection | 150.0 |
| min_speed_threshold | [m/s] | double | Minimum speed for wrong-way detection | 0.5 |
Temporal Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| min_detection_duration | [s] | double | Minimum duration for object detection | 0.1 |
| lost_object_retention_duration | [s] | double | Duration to keep tracking objects after they are lost or exit the detection area | 2.0 |
File truncated at 100 lines see the full file
Changelog for package autoware_motion_velocity_road_user_stop_module
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- perf(road_user_stop): reduce the number of published debug markers (#11865)
- feat(motion_velocity_planner): publish debug trajectory for each module (#11781)
- Contributors: Maxime CLEMENT, Ryohsuke Mitsudome
0.49.0 (2025-12-30)
-
Merge remote-tracking branch 'origin/main' into prepare-0.49.0-changelog
-
refactor: fix leftover dependent autoware_utils from updating vehicle_info_utils (#11734)
-
fix(road_user_stop): fix topic name string (#11678)
-
feat(motion_velocity_planner): refactor time publisher (#11646)
- delete bdp time publish
- delete dynamic_obstacle_stop time publish
- delete obstacle_cruise time publish
- delete obstacle_slow_down time publish
- delete obstacle_velocity_limiter time publish
- delete out of lane time publish
- delete run out time publish
* add short module name function ---------
-
Contributors: Mete Fatih Cırıt, Ryohsuke Mitsudome, Yuki TAKAGI
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
fix(road_user_stop): delete path_length_buffer (#11653)
-
fix: tf2 uses hpp headers in rolling (and is backported) (#11620)
-
docs(road_user_stop): add parameter docs (#11539) add parameters docs
-
feat(road_user_stop): exclude ego vehicle's sides from detection area (#11496)
- exclude ego side polygon
- fix typo
* delete polygon_utils copy function ---------
-
feat(road_user_stop): pass for stop vru (#11491)
- pass for stop vru
* fix cppcheck ---------
-
Contributors: Kotakku, Ryohsuke Mitsudome, Tim Clephas, Yuki TAKAGI
0.47.1 (2025-08-14)
0.47.0 (2025-08-11)
-
fix(road_user_stop): remove generate_parameter_library's default_value parameters (#11117)
- delete generate_parameter_library's_default_value parameter
* rerun ci ---------
-
feat(road_user_stop): add road_user_stop module (#11041)
- initial commit of road_user_stop module
- add stop condition for wrong user and masked adjacent lanelet
- update detection and stop planning method
- change stop plan algorithm
- use generate_parameter_library
- chattering prevention and on/off parameterize of intersection and crosswalk
- change detection method of intersection, and tidy up
- enable gtest
- fix default parameter to match obstacle_stop
- code tidy up
- update readme
- fix based on PR review
- remove dead code
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
| Name |
|---|
| libboost-dev |
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_motion_velocity_road_user_stop_module at Robotics Stack Exchange
Package Summary
| Version | 0.50.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-02-25 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Takumi Odashima
- Yuki Takagi
- Satoshi Ota
Authors
Road User Stop
Role
The road_user_stop module stops the ego vehicle when pedestrians, cyclists, or other road users are detected on or near the road within the ego’s planned trajectory. This module ensures safe interaction with vulnerable road users by maintaining appropriate stopping distances and making decisions about when to stop versus when to continue driving.
Activation
This module is activated if the launch parameter launch_road_user_stop_module is set to true.
Parameters
Option Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| suppress_sudden_stop | [-] | bool | Enable to suppress sudden stop | true |
Stop Planning Parameters
Longitudinal Margin Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| default_margin | [m] | double | Default longitudinal margin to obstacle | 5.0 |
| terminal_margin | [m] | double | Stop margin at the goal position | 3.0 |
| minimum_margin | [m] | double | Minimum stop margin for behavior decision | 3.0 |
Opposing Traffic Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| stop_margin | [m] | double | Ideal stop-margin from moving opposing obstacle when ego stops | 10.0 |
| max_negative_velocity | [m/s] | double | Maximum velocity of opposing traffic to consider stop planning | -0.1 |
| min_velocity_for_stop_planning | [m/s] | double | Minimum velocity of ego to consider stop planning | 2.77 |
| effective_deceleration | [m/s^2] | double | Higher value brings final stop-margin closer to ideal value | 4.0 |
General Stop Planning Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| hold_stop_velocity_threshold | [m/s] | double | The maximum ego velocity to hold stopping | 0.01 |
| hold_stop_distance_threshold | [m] | double | The ego keeps stopping if distance to stop changes within threshold | 0.3 |
| limit_min_acc | [m/s^2] | double | Overwrite the deceleration limit (usually from common_param.yaml) | -2.5 |
| sudden_object_acc_threshold | [m/s^2] | double | If stop achievable by smaller deceleration, not “sudden stop” | -1.0 |
| sudden_object_dist_threshold | [m] | double | If stop distance is longer than this, not considered “sudden stop” | 1000.0 |
| abandon_to_stop | [-] | bool | Give up stopping when cannot avoid run over within decel limit | false |
Stop on Curve Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable_approaching | [-] | bool | Enable approaching behavior on curved paths | false |
| additional_stop_margin | [m] | double | Additional stop margin for obstacles on curves | 3.0 |
| min_stop_margin | [m] | double | Minimum stop margin on curves | 6.0 |
Obstacle Filtering Parameters
Object Type Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| pedestrian | [-] | bool | Enable detection of pedestrians | true |
| bicycle | [-] | bool | Enable detection of bicycles | true |
| motorcycle | [-] | bool | Enable detection of motorcycles | false |
| unknown | [-] | bool | Enable detection of unknown objects | false |
General Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| trajectory_lateral_margin | [m] | double | Lateral margin from ego trajectory to detect objects | 1.0 |
Intersection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | If true, exclude objects inside intersection lanelets from detection | false |
Crosswalk Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | Exclude objects near crosswalks | true |
| margin | [m] | double | Margin distance from crosswalk | 1.0 |
Opposing Traffic Detection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable | [-] | bool | Enable wrong-way object detection | true |
| angle_threshold | [deg] | double | Angle threshold for wrong-way detection | 150.0 |
| min_speed_threshold | [m/s] | double | Minimum speed for wrong-way detection | 0.5 |
Temporal Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| min_detection_duration | [s] | double | Minimum duration for object detection | 0.1 |
| lost_object_retention_duration | [s] | double | Duration to keep tracking objects after they are lost or exit the detection area | 2.0 |
File truncated at 100 lines see the full file
Changelog for package autoware_motion_velocity_road_user_stop_module
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- perf(road_user_stop): reduce the number of published debug markers (#11865)
- feat(motion_velocity_planner): publish debug trajectory for each module (#11781)
- Contributors: Maxime CLEMENT, Ryohsuke Mitsudome
0.49.0 (2025-12-30)
-
Merge remote-tracking branch 'origin/main' into prepare-0.49.0-changelog
-
refactor: fix leftover dependent autoware_utils from updating vehicle_info_utils (#11734)
-
fix(road_user_stop): fix topic name string (#11678)
-
feat(motion_velocity_planner): refactor time publisher (#11646)
- delete bdp time publish
- delete dynamic_obstacle_stop time publish
- delete obstacle_cruise time publish
- delete obstacle_slow_down time publish
- delete obstacle_velocity_limiter time publish
- delete out of lane time publish
- delete run out time publish
* add short module name function ---------
-
Contributors: Mete Fatih Cırıt, Ryohsuke Mitsudome, Yuki TAKAGI
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
fix(road_user_stop): delete path_length_buffer (#11653)
-
fix: tf2 uses hpp headers in rolling (and is backported) (#11620)
-
docs(road_user_stop): add parameter docs (#11539) add parameters docs
-
feat(road_user_stop): exclude ego vehicle's sides from detection area (#11496)
- exclude ego side polygon
- fix typo
* delete polygon_utils copy function ---------
-
feat(road_user_stop): pass for stop vru (#11491)
- pass for stop vru
* fix cppcheck ---------
-
Contributors: Kotakku, Ryohsuke Mitsudome, Tim Clephas, Yuki TAKAGI
0.47.1 (2025-08-14)
0.47.0 (2025-08-11)
-
fix(road_user_stop): remove generate_parameter_library's default_value parameters (#11117)
- delete generate_parameter_library's_default_value parameter
* rerun ci ---------
-
feat(road_user_stop): add road_user_stop module (#11041)
- initial commit of road_user_stop module
- add stop condition for wrong user and masked adjacent lanelet
- update detection and stop planning method
- change stop plan algorithm
- use generate_parameter_library
- chattering prevention and on/off parameterize of intersection and crosswalk
- change detection method of intersection, and tidy up
- enable gtest
- fix default parameter to match obstacle_stop
- code tidy up
- update readme
- fix based on PR review
- remove dead code
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
| Name |
|---|
| libboost-dev |
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_motion_velocity_road_user_stop_module at Robotics Stack Exchange
Package Summary
| Version | 0.50.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-02-25 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Takumi Odashima
- Yuki Takagi
- Satoshi Ota
Authors
Road User Stop
Role
The road_user_stop module stops the ego vehicle when pedestrians, cyclists, or other road users are detected on or near the road within the ego’s planned trajectory. This module ensures safe interaction with vulnerable road users by maintaining appropriate stopping distances and making decisions about when to stop versus when to continue driving.
Activation
This module is activated if the launch parameter launch_road_user_stop_module is set to true.
Parameters
Option Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| suppress_sudden_stop | [-] | bool | Enable to suppress sudden stop | true |
Stop Planning Parameters
Longitudinal Margin Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| default_margin | [m] | double | Default longitudinal margin to obstacle | 5.0 |
| terminal_margin | [m] | double | Stop margin at the goal position | 3.0 |
| minimum_margin | [m] | double | Minimum stop margin for behavior decision | 3.0 |
Opposing Traffic Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| stop_margin | [m] | double | Ideal stop-margin from moving opposing obstacle when ego stops | 10.0 |
| max_negative_velocity | [m/s] | double | Maximum velocity of opposing traffic to consider stop planning | -0.1 |
| min_velocity_for_stop_planning | [m/s] | double | Minimum velocity of ego to consider stop planning | 2.77 |
| effective_deceleration | [m/s^2] | double | Higher value brings final stop-margin closer to ideal value | 4.0 |
General Stop Planning Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| hold_stop_velocity_threshold | [m/s] | double | The maximum ego velocity to hold stopping | 0.01 |
| hold_stop_distance_threshold | [m] | double | The ego keeps stopping if distance to stop changes within threshold | 0.3 |
| limit_min_acc | [m/s^2] | double | Overwrite the deceleration limit (usually from common_param.yaml) | -2.5 |
| sudden_object_acc_threshold | [m/s^2] | double | If stop achievable by smaller deceleration, not “sudden stop” | -1.0 |
| sudden_object_dist_threshold | [m] | double | If stop distance is longer than this, not considered “sudden stop” | 1000.0 |
| abandon_to_stop | [-] | bool | Give up stopping when cannot avoid run over within decel limit | false |
Stop on Curve Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable_approaching | [-] | bool | Enable approaching behavior on curved paths | false |
| additional_stop_margin | [m] | double | Additional stop margin for obstacles on curves | 3.0 |
| min_stop_margin | [m] | double | Minimum stop margin on curves | 6.0 |
Obstacle Filtering Parameters
Object Type Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| pedestrian | [-] | bool | Enable detection of pedestrians | true |
| bicycle | [-] | bool | Enable detection of bicycles | true |
| motorcycle | [-] | bool | Enable detection of motorcycles | false |
| unknown | [-] | bool | Enable detection of unknown objects | false |
General Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| trajectory_lateral_margin | [m] | double | Lateral margin from ego trajectory to detect objects | 1.0 |
Intersection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | If true, exclude objects inside intersection lanelets from detection | false |
Crosswalk Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | Exclude objects near crosswalks | true |
| margin | [m] | double | Margin distance from crosswalk | 1.0 |
Opposing Traffic Detection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable | [-] | bool | Enable wrong-way object detection | true |
| angle_threshold | [deg] | double | Angle threshold for wrong-way detection | 150.0 |
| min_speed_threshold | [m/s] | double | Minimum speed for wrong-way detection | 0.5 |
Temporal Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| min_detection_duration | [s] | double | Minimum duration for object detection | 0.1 |
| lost_object_retention_duration | [s] | double | Duration to keep tracking objects after they are lost or exit the detection area | 2.0 |
File truncated at 100 lines see the full file
Changelog for package autoware_motion_velocity_road_user_stop_module
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- perf(road_user_stop): reduce the number of published debug markers (#11865)
- feat(motion_velocity_planner): publish debug trajectory for each module (#11781)
- Contributors: Maxime CLEMENT, Ryohsuke Mitsudome
0.49.0 (2025-12-30)
-
Merge remote-tracking branch 'origin/main' into prepare-0.49.0-changelog
-
refactor: fix leftover dependent autoware_utils from updating vehicle_info_utils (#11734)
-
fix(road_user_stop): fix topic name string (#11678)
-
feat(motion_velocity_planner): refactor time publisher (#11646)
- delete bdp time publish
- delete dynamic_obstacle_stop time publish
- delete obstacle_cruise time publish
- delete obstacle_slow_down time publish
- delete obstacle_velocity_limiter time publish
- delete out of lane time publish
- delete run out time publish
* add short module name function ---------
-
Contributors: Mete Fatih Cırıt, Ryohsuke Mitsudome, Yuki TAKAGI
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
fix(road_user_stop): delete path_length_buffer (#11653)
-
fix: tf2 uses hpp headers in rolling (and is backported) (#11620)
-
docs(road_user_stop): add parameter docs (#11539) add parameters docs
-
feat(road_user_stop): exclude ego vehicle's sides from detection area (#11496)
- exclude ego side polygon
- fix typo
* delete polygon_utils copy function ---------
-
feat(road_user_stop): pass for stop vru (#11491)
- pass for stop vru
* fix cppcheck ---------
-
Contributors: Kotakku, Ryohsuke Mitsudome, Tim Clephas, Yuki TAKAGI
0.47.1 (2025-08-14)
0.47.0 (2025-08-11)
-
fix(road_user_stop): remove generate_parameter_library's default_value parameters (#11117)
- delete generate_parameter_library's_default_value parameter
* rerun ci ---------
-
feat(road_user_stop): add road_user_stop module (#11041)
- initial commit of road_user_stop module
- add stop condition for wrong user and masked adjacent lanelet
- update detection and stop planning method
- change stop plan algorithm
- use generate_parameter_library
- chattering prevention and on/off parameterize of intersection and crosswalk
- change detection method of intersection, and tidy up
- enable gtest
- fix default parameter to match obstacle_stop
- code tidy up
- update readme
- fix based on PR review
- remove dead code
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
| Name |
|---|
| libboost-dev |
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_motion_velocity_road_user_stop_module at Robotics Stack Exchange
Package Summary
| Version | 0.50.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-02-25 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Takumi Odashima
- Yuki Takagi
- Satoshi Ota
Authors
Road User Stop
Role
The road_user_stop module stops the ego vehicle when pedestrians, cyclists, or other road users are detected on or near the road within the ego’s planned trajectory. This module ensures safe interaction with vulnerable road users by maintaining appropriate stopping distances and making decisions about when to stop versus when to continue driving.
Activation
This module is activated if the launch parameter launch_road_user_stop_module is set to true.
Parameters
Option Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| suppress_sudden_stop | [-] | bool | Enable to suppress sudden stop | true |
Stop Planning Parameters
Longitudinal Margin Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| default_margin | [m] | double | Default longitudinal margin to obstacle | 5.0 |
| terminal_margin | [m] | double | Stop margin at the goal position | 3.0 |
| minimum_margin | [m] | double | Minimum stop margin for behavior decision | 3.0 |
Opposing Traffic Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| stop_margin | [m] | double | Ideal stop-margin from moving opposing obstacle when ego stops | 10.0 |
| max_negative_velocity | [m/s] | double | Maximum velocity of opposing traffic to consider stop planning | -0.1 |
| min_velocity_for_stop_planning | [m/s] | double | Minimum velocity of ego to consider stop planning | 2.77 |
| effective_deceleration | [m/s^2] | double | Higher value brings final stop-margin closer to ideal value | 4.0 |
General Stop Planning Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| hold_stop_velocity_threshold | [m/s] | double | The maximum ego velocity to hold stopping | 0.01 |
| hold_stop_distance_threshold | [m] | double | The ego keeps stopping if distance to stop changes within threshold | 0.3 |
| limit_min_acc | [m/s^2] | double | Overwrite the deceleration limit (usually from common_param.yaml) | -2.5 |
| sudden_object_acc_threshold | [m/s^2] | double | If stop achievable by smaller deceleration, not “sudden stop” | -1.0 |
| sudden_object_dist_threshold | [m] | double | If stop distance is longer than this, not considered “sudden stop” | 1000.0 |
| abandon_to_stop | [-] | bool | Give up stopping when cannot avoid run over within decel limit | false |
Stop on Curve Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable_approaching | [-] | bool | Enable approaching behavior on curved paths | false |
| additional_stop_margin | [m] | double | Additional stop margin for obstacles on curves | 3.0 |
| min_stop_margin | [m] | double | Minimum stop margin on curves | 6.0 |
Obstacle Filtering Parameters
Object Type Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| pedestrian | [-] | bool | Enable detection of pedestrians | true |
| bicycle | [-] | bool | Enable detection of bicycles | true |
| motorcycle | [-] | bool | Enable detection of motorcycles | false |
| unknown | [-] | bool | Enable detection of unknown objects | false |
General Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| trajectory_lateral_margin | [m] | double | Lateral margin from ego trajectory to detect objects | 1.0 |
Intersection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | If true, exclude objects inside intersection lanelets from detection | false |
Crosswalk Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | Exclude objects near crosswalks | true |
| margin | [m] | double | Margin distance from crosswalk | 1.0 |
Opposing Traffic Detection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable | [-] | bool | Enable wrong-way object detection | true |
| angle_threshold | [deg] | double | Angle threshold for wrong-way detection | 150.0 |
| min_speed_threshold | [m/s] | double | Minimum speed for wrong-way detection | 0.5 |
Temporal Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| min_detection_duration | [s] | double | Minimum duration for object detection | 0.1 |
| lost_object_retention_duration | [s] | double | Duration to keep tracking objects after they are lost or exit the detection area | 2.0 |
File truncated at 100 lines see the full file
Changelog for package autoware_motion_velocity_road_user_stop_module
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- perf(road_user_stop): reduce the number of published debug markers (#11865)
- feat(motion_velocity_planner): publish debug trajectory for each module (#11781)
- Contributors: Maxime CLEMENT, Ryohsuke Mitsudome
0.49.0 (2025-12-30)
-
Merge remote-tracking branch 'origin/main' into prepare-0.49.0-changelog
-
refactor: fix leftover dependent autoware_utils from updating vehicle_info_utils (#11734)
-
fix(road_user_stop): fix topic name string (#11678)
-
feat(motion_velocity_planner): refactor time publisher (#11646)
- delete bdp time publish
- delete dynamic_obstacle_stop time publish
- delete obstacle_cruise time publish
- delete obstacle_slow_down time publish
- delete obstacle_velocity_limiter time publish
- delete out of lane time publish
- delete run out time publish
* add short module name function ---------
-
Contributors: Mete Fatih Cırıt, Ryohsuke Mitsudome, Yuki TAKAGI
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
fix(road_user_stop): delete path_length_buffer (#11653)
-
fix: tf2 uses hpp headers in rolling (and is backported) (#11620)
-
docs(road_user_stop): add parameter docs (#11539) add parameters docs
-
feat(road_user_stop): exclude ego vehicle's sides from detection area (#11496)
- exclude ego side polygon
- fix typo
* delete polygon_utils copy function ---------
-
feat(road_user_stop): pass for stop vru (#11491)
- pass for stop vru
* fix cppcheck ---------
-
Contributors: Kotakku, Ryohsuke Mitsudome, Tim Clephas, Yuki TAKAGI
0.47.1 (2025-08-14)
0.47.0 (2025-08-11)
-
fix(road_user_stop): remove generate_parameter_library's default_value parameters (#11117)
- delete generate_parameter_library's_default_value parameter
* rerun ci ---------
-
feat(road_user_stop): add road_user_stop module (#11041)
- initial commit of road_user_stop module
- add stop condition for wrong user and masked adjacent lanelet
- update detection and stop planning method
- change stop plan algorithm
- use generate_parameter_library
- chattering prevention and on/off parameterize of intersection and crosswalk
- change detection method of intersection, and tidy up
- enable gtest
- fix default parameter to match obstacle_stop
- code tidy up
- update readme
- fix based on PR review
- remove dead code
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
| Name |
|---|
| libboost-dev |
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_motion_velocity_road_user_stop_module at Robotics Stack Exchange
Package Summary
| Version | 0.50.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-02-25 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Takumi Odashima
- Yuki Takagi
- Satoshi Ota
Authors
Road User Stop
Role
The road_user_stop module stops the ego vehicle when pedestrians, cyclists, or other road users are detected on or near the road within the ego’s planned trajectory. This module ensures safe interaction with vulnerable road users by maintaining appropriate stopping distances and making decisions about when to stop versus when to continue driving.
Activation
This module is activated if the launch parameter launch_road_user_stop_module is set to true.
Parameters
Option Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| suppress_sudden_stop | [-] | bool | Enable to suppress sudden stop | true |
Stop Planning Parameters
Longitudinal Margin Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| default_margin | [m] | double | Default longitudinal margin to obstacle | 5.0 |
| terminal_margin | [m] | double | Stop margin at the goal position | 3.0 |
| minimum_margin | [m] | double | Minimum stop margin for behavior decision | 3.0 |
Opposing Traffic Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| stop_margin | [m] | double | Ideal stop-margin from moving opposing obstacle when ego stops | 10.0 |
| max_negative_velocity | [m/s] | double | Maximum velocity of opposing traffic to consider stop planning | -0.1 |
| min_velocity_for_stop_planning | [m/s] | double | Minimum velocity of ego to consider stop planning | 2.77 |
| effective_deceleration | [m/s^2] | double | Higher value brings final stop-margin closer to ideal value | 4.0 |
General Stop Planning Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| hold_stop_velocity_threshold | [m/s] | double | The maximum ego velocity to hold stopping | 0.01 |
| hold_stop_distance_threshold | [m] | double | The ego keeps stopping if distance to stop changes within threshold | 0.3 |
| limit_min_acc | [m/s^2] | double | Overwrite the deceleration limit (usually from common_param.yaml) | -2.5 |
| sudden_object_acc_threshold | [m/s^2] | double | If stop achievable by smaller deceleration, not “sudden stop” | -1.0 |
| sudden_object_dist_threshold | [m] | double | If stop distance is longer than this, not considered “sudden stop” | 1000.0 |
| abandon_to_stop | [-] | bool | Give up stopping when cannot avoid run over within decel limit | false |
Stop on Curve Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable_approaching | [-] | bool | Enable approaching behavior on curved paths | false |
| additional_stop_margin | [m] | double | Additional stop margin for obstacles on curves | 3.0 |
| min_stop_margin | [m] | double | Minimum stop margin on curves | 6.0 |
Obstacle Filtering Parameters
Object Type Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| pedestrian | [-] | bool | Enable detection of pedestrians | true |
| bicycle | [-] | bool | Enable detection of bicycles | true |
| motorcycle | [-] | bool | Enable detection of motorcycles | false |
| unknown | [-] | bool | Enable detection of unknown objects | false |
General Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| trajectory_lateral_margin | [m] | double | Lateral margin from ego trajectory to detect objects | 1.0 |
Intersection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | If true, exclude objects inside intersection lanelets from detection | false |
Crosswalk Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | Exclude objects near crosswalks | true |
| margin | [m] | double | Margin distance from crosswalk | 1.0 |
Opposing Traffic Detection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable | [-] | bool | Enable wrong-way object detection | true |
| angle_threshold | [deg] | double | Angle threshold for wrong-way detection | 150.0 |
| min_speed_threshold | [m/s] | double | Minimum speed for wrong-way detection | 0.5 |
Temporal Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| min_detection_duration | [s] | double | Minimum duration for object detection | 0.1 |
| lost_object_retention_duration | [s] | double | Duration to keep tracking objects after they are lost or exit the detection area | 2.0 |
File truncated at 100 lines see the full file
Changelog for package autoware_motion_velocity_road_user_stop_module
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- perf(road_user_stop): reduce the number of published debug markers (#11865)
- feat(motion_velocity_planner): publish debug trajectory for each module (#11781)
- Contributors: Maxime CLEMENT, Ryohsuke Mitsudome
0.49.0 (2025-12-30)
-
Merge remote-tracking branch 'origin/main' into prepare-0.49.0-changelog
-
refactor: fix leftover dependent autoware_utils from updating vehicle_info_utils (#11734)
-
fix(road_user_stop): fix topic name string (#11678)
-
feat(motion_velocity_planner): refactor time publisher (#11646)
- delete bdp time publish
- delete dynamic_obstacle_stop time publish
- delete obstacle_cruise time publish
- delete obstacle_slow_down time publish
- delete obstacle_velocity_limiter time publish
- delete out of lane time publish
- delete run out time publish
* add short module name function ---------
-
Contributors: Mete Fatih Cırıt, Ryohsuke Mitsudome, Yuki TAKAGI
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
fix(road_user_stop): delete path_length_buffer (#11653)
-
fix: tf2 uses hpp headers in rolling (and is backported) (#11620)
-
docs(road_user_stop): add parameter docs (#11539) add parameters docs
-
feat(road_user_stop): exclude ego vehicle's sides from detection area (#11496)
- exclude ego side polygon
- fix typo
* delete polygon_utils copy function ---------
-
feat(road_user_stop): pass for stop vru (#11491)
- pass for stop vru
* fix cppcheck ---------
-
Contributors: Kotakku, Ryohsuke Mitsudome, Tim Clephas, Yuki TAKAGI
0.47.1 (2025-08-14)
0.47.0 (2025-08-11)
-
fix(road_user_stop): remove generate_parameter_library's default_value parameters (#11117)
- delete generate_parameter_library's_default_value parameter
* rerun ci ---------
-
feat(road_user_stop): add road_user_stop module (#11041)
- initial commit of road_user_stop module
- add stop condition for wrong user and masked adjacent lanelet
- update detection and stop planning method
- change stop plan algorithm
- use generate_parameter_library
- chattering prevention and on/off parameterize of intersection and crosswalk
- change detection method of intersection, and tidy up
- enable gtest
- fix default parameter to match obstacle_stop
- code tidy up
- update readme
- fix based on PR review
- remove dead code
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
| Name |
|---|
| libboost-dev |
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_motion_velocity_road_user_stop_module at Robotics Stack Exchange
Package Summary
| Version | 0.50.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-02-25 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Takumi Odashima
- Yuki Takagi
- Satoshi Ota
Authors
Road User Stop
Role
The road_user_stop module stops the ego vehicle when pedestrians, cyclists, or other road users are detected on or near the road within the ego’s planned trajectory. This module ensures safe interaction with vulnerable road users by maintaining appropriate stopping distances and making decisions about when to stop versus when to continue driving.
Activation
This module is activated if the launch parameter launch_road_user_stop_module is set to true.
Parameters
Option Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| suppress_sudden_stop | [-] | bool | Enable to suppress sudden stop | true |
Stop Planning Parameters
Longitudinal Margin Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| default_margin | [m] | double | Default longitudinal margin to obstacle | 5.0 |
| terminal_margin | [m] | double | Stop margin at the goal position | 3.0 |
| minimum_margin | [m] | double | Minimum stop margin for behavior decision | 3.0 |
Opposing Traffic Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| stop_margin | [m] | double | Ideal stop-margin from moving opposing obstacle when ego stops | 10.0 |
| max_negative_velocity | [m/s] | double | Maximum velocity of opposing traffic to consider stop planning | -0.1 |
| min_velocity_for_stop_planning | [m/s] | double | Minimum velocity of ego to consider stop planning | 2.77 |
| effective_deceleration | [m/s^2] | double | Higher value brings final stop-margin closer to ideal value | 4.0 |
General Stop Planning Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| hold_stop_velocity_threshold | [m/s] | double | The maximum ego velocity to hold stopping | 0.01 |
| hold_stop_distance_threshold | [m] | double | The ego keeps stopping if distance to stop changes within threshold | 0.3 |
| limit_min_acc | [m/s^2] | double | Overwrite the deceleration limit (usually from common_param.yaml) | -2.5 |
| sudden_object_acc_threshold | [m/s^2] | double | If stop achievable by smaller deceleration, not “sudden stop” | -1.0 |
| sudden_object_dist_threshold | [m] | double | If stop distance is longer than this, not considered “sudden stop” | 1000.0 |
| abandon_to_stop | [-] | bool | Give up stopping when cannot avoid run over within decel limit | false |
Stop on Curve Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable_approaching | [-] | bool | Enable approaching behavior on curved paths | false |
| additional_stop_margin | [m] | double | Additional stop margin for obstacles on curves | 3.0 |
| min_stop_margin | [m] | double | Minimum stop margin on curves | 6.0 |
Obstacle Filtering Parameters
Object Type Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| pedestrian | [-] | bool | Enable detection of pedestrians | true |
| bicycle | [-] | bool | Enable detection of bicycles | true |
| motorcycle | [-] | bool | Enable detection of motorcycles | false |
| unknown | [-] | bool | Enable detection of unknown objects | false |
General Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| trajectory_lateral_margin | [m] | double | Lateral margin from ego trajectory to detect objects | 1.0 |
Intersection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | If true, exclude objects inside intersection lanelets from detection | false |
Crosswalk Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | Exclude objects near crosswalks | true |
| margin | [m] | double | Margin distance from crosswalk | 1.0 |
Opposing Traffic Detection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable | [-] | bool | Enable wrong-way object detection | true |
| angle_threshold | [deg] | double | Angle threshold for wrong-way detection | 150.0 |
| min_speed_threshold | [m/s] | double | Minimum speed for wrong-way detection | 0.5 |
Temporal Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| min_detection_duration | [s] | double | Minimum duration for object detection | 0.1 |
| lost_object_retention_duration | [s] | double | Duration to keep tracking objects after they are lost or exit the detection area | 2.0 |
File truncated at 100 lines see the full file
Changelog for package autoware_motion_velocity_road_user_stop_module
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- perf(road_user_stop): reduce the number of published debug markers (#11865)
- feat(motion_velocity_planner): publish debug trajectory for each module (#11781)
- Contributors: Maxime CLEMENT, Ryohsuke Mitsudome
0.49.0 (2025-12-30)
-
Merge remote-tracking branch 'origin/main' into prepare-0.49.0-changelog
-
refactor: fix leftover dependent autoware_utils from updating vehicle_info_utils (#11734)
-
fix(road_user_stop): fix topic name string (#11678)
-
feat(motion_velocity_planner): refactor time publisher (#11646)
- delete bdp time publish
- delete dynamic_obstacle_stop time publish
- delete obstacle_cruise time publish
- delete obstacle_slow_down time publish
- delete obstacle_velocity_limiter time publish
- delete out of lane time publish
- delete run out time publish
* add short module name function ---------
-
Contributors: Mete Fatih Cırıt, Ryohsuke Mitsudome, Yuki TAKAGI
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
fix(road_user_stop): delete path_length_buffer (#11653)
-
fix: tf2 uses hpp headers in rolling (and is backported) (#11620)
-
docs(road_user_stop): add parameter docs (#11539) add parameters docs
-
feat(road_user_stop): exclude ego vehicle's sides from detection area (#11496)
- exclude ego side polygon
- fix typo
* delete polygon_utils copy function ---------
-
feat(road_user_stop): pass for stop vru (#11491)
- pass for stop vru
* fix cppcheck ---------
-
Contributors: Kotakku, Ryohsuke Mitsudome, Tim Clephas, Yuki TAKAGI
0.47.1 (2025-08-14)
0.47.0 (2025-08-11)
-
fix(road_user_stop): remove generate_parameter_library's default_value parameters (#11117)
- delete generate_parameter_library's_default_value parameter
* rerun ci ---------
-
feat(road_user_stop): add road_user_stop module (#11041)
- initial commit of road_user_stop module
- add stop condition for wrong user and masked adjacent lanelet
- update detection and stop planning method
- change stop plan algorithm
- use generate_parameter_library
- chattering prevention and on/off parameterize of intersection and crosswalk
- change detection method of intersection, and tidy up
- enable gtest
- fix default parameter to match obstacle_stop
- code tidy up
- update readme
- fix based on PR review
- remove dead code
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
| Name |
|---|
| libboost-dev |
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged autoware_motion_velocity_road_user_stop_module at Robotics Stack Exchange
Package Summary
| Version | 0.50.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-02-25 |
| Dev Status | UNKNOWN |
| Released | UNRELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Maintainers
- Takumi Odashima
- Yuki Takagi
- Satoshi Ota
Authors
Road User Stop
Role
The road_user_stop module stops the ego vehicle when pedestrians, cyclists, or other road users are detected on or near the road within the ego’s planned trajectory. This module ensures safe interaction with vulnerable road users by maintaining appropriate stopping distances and making decisions about when to stop versus when to continue driving.
Activation
This module is activated if the launch parameter launch_road_user_stop_module is set to true.
Parameters
Option Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| suppress_sudden_stop | [-] | bool | Enable to suppress sudden stop | true |
Stop Planning Parameters
Longitudinal Margin Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| default_margin | [m] | double | Default longitudinal margin to obstacle | 5.0 |
| terminal_margin | [m] | double | Stop margin at the goal position | 3.0 |
| minimum_margin | [m] | double | Minimum stop margin for behavior decision | 3.0 |
Opposing Traffic Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| stop_margin | [m] | double | Ideal stop-margin from moving opposing obstacle when ego stops | 10.0 |
| max_negative_velocity | [m/s] | double | Maximum velocity of opposing traffic to consider stop planning | -0.1 |
| min_velocity_for_stop_planning | [m/s] | double | Minimum velocity of ego to consider stop planning | 2.77 |
| effective_deceleration | [m/s^2] | double | Higher value brings final stop-margin closer to ideal value | 4.0 |
General Stop Planning Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| hold_stop_velocity_threshold | [m/s] | double | The maximum ego velocity to hold stopping | 0.01 |
| hold_stop_distance_threshold | [m] | double | The ego keeps stopping if distance to stop changes within threshold | 0.3 |
| limit_min_acc | [m/s^2] | double | Overwrite the deceleration limit (usually from common_param.yaml) | -2.5 |
| sudden_object_acc_threshold | [m/s^2] | double | If stop achievable by smaller deceleration, not “sudden stop” | -1.0 |
| sudden_object_dist_threshold | [m] | double | If stop distance is longer than this, not considered “sudden stop” | 1000.0 |
| abandon_to_stop | [-] | bool | Give up stopping when cannot avoid run over within decel limit | false |
Stop on Curve Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable_approaching | [-] | bool | Enable approaching behavior on curved paths | false |
| additional_stop_margin | [m] | double | Additional stop margin for obstacles on curves | 3.0 |
| min_stop_margin | [m] | double | Minimum stop margin on curves | 6.0 |
Obstacle Filtering Parameters
Object Type Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| pedestrian | [-] | bool | Enable detection of pedestrians | true |
| bicycle | [-] | bool | Enable detection of bicycles | true |
| motorcycle | [-] | bool | Enable detection of motorcycles | false |
| unknown | [-] | bool | Enable detection of unknown objects | false |
General Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| trajectory_lateral_margin | [m] | double | Lateral margin from ego trajectory to detect objects | 1.0 |
Intersection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | If true, exclude objects inside intersection lanelets from detection | false |
Crosswalk Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| exclude | [-] | bool | Exclude objects near crosswalks | true |
| margin | [m] | double | Margin distance from crosswalk | 1.0 |
Opposing Traffic Detection Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| enable | [-] | bool | Enable wrong-way object detection | true |
| angle_threshold | [deg] | double | Angle threshold for wrong-way detection | 150.0 |
| min_speed_threshold | [m/s] | double | Minimum speed for wrong-way detection | 0.5 |
Temporal Filtering Parameters
| Name | Unit | Type | Description | Default value |
|---|---|---|---|---|
| min_detection_duration | [s] | double | Minimum duration for object detection | 0.1 |
| lost_object_retention_duration | [s] | double | Duration to keep tracking objects after they are lost or exit the detection area | 2.0 |
File truncated at 100 lines see the full file
Changelog for package autoware_motion_velocity_road_user_stop_module
0.50.0 (2026-02-14)
- Merge remote-tracking branch 'origin/main' into humble
- perf(road_user_stop): reduce the number of published debug markers (#11865)
- feat(motion_velocity_planner): publish debug trajectory for each module (#11781)
- Contributors: Maxime CLEMENT, Ryohsuke Mitsudome
0.49.0 (2025-12-30)
-
Merge remote-tracking branch 'origin/main' into prepare-0.49.0-changelog
-
refactor: fix leftover dependent autoware_utils from updating vehicle_info_utils (#11734)
-
fix(road_user_stop): fix topic name string (#11678)
-
feat(motion_velocity_planner): refactor time publisher (#11646)
- delete bdp time publish
- delete dynamic_obstacle_stop time publish
- delete obstacle_cruise time publish
- delete obstacle_slow_down time publish
- delete obstacle_velocity_limiter time publish
- delete out of lane time publish
- delete run out time publish
* add short module name function ---------
-
Contributors: Mete Fatih Cırıt, Ryohsuke Mitsudome, Yuki TAKAGI
0.48.0 (2025-11-18)
-
Merge remote-tracking branch 'origin/main' into humble
-
fix(road_user_stop): delete path_length_buffer (#11653)
-
fix: tf2 uses hpp headers in rolling (and is backported) (#11620)
-
docs(road_user_stop): add parameter docs (#11539) add parameters docs
-
feat(road_user_stop): exclude ego vehicle's sides from detection area (#11496)
- exclude ego side polygon
- fix typo
* delete polygon_utils copy function ---------
-
feat(road_user_stop): pass for stop vru (#11491)
- pass for stop vru
* fix cppcheck ---------
-
Contributors: Kotakku, Ryohsuke Mitsudome, Tim Clephas, Yuki TAKAGI
0.47.1 (2025-08-14)
0.47.0 (2025-08-11)
-
fix(road_user_stop): remove generate_parameter_library's default_value parameters (#11117)
- delete generate_parameter_library's_default_value parameter
* rerun ci ---------
-
feat(road_user_stop): add road_user_stop module (#11041)
- initial commit of road_user_stop module
- add stop condition for wrong user and masked adjacent lanelet
- update detection and stop planning method
- change stop plan algorithm
- use generate_parameter_library
- chattering prevention and on/off parameterize of intersection and crosswalk
- change detection method of intersection, and tidy up
- enable gtest
- fix default parameter to match obstacle_stop
- code tidy up
- update readme
- fix based on PR review
- remove dead code
File truncated at 100 lines see the full file
Package Dependencies
System Dependencies
| Name |
|---|
| libboost-dev |