-
ROS index logo ROS Index
  1. Home
  2. Packages
  3. nav2_graceful_controller
 

nav2_graceful_controller package from navigation2 repo

nav2_amcl nav2_behavior_tree nav2_behaviors nav2_bringup nav2_bt_navigator nav2_collision_monitor nav2_common nav2_constrained_smoother nav2_controller nav2_core nav2_costmap_2d costmap_queue dwb_core dwb_critics dwb_msgs dwb_plugins nav2_dwb_controller nav_2d_msgs nav_2d_utils nav2_graceful_controller nav2_lifecycle_manager nav2_map_server nav2_mppi_controller nav2_msgs nav2_navfn_planner nav2_planner nav2_regulated_pure_pursuit_controller nav2_rotation_shim_controller nav2_rviz_plugins nav2_simple_commander nav2_smac_planner nav2_smoother nav2_system_tests nav2_theta_star_planner nav2_util nav2_velocity_smoother nav2_voxel_grid nav2_waypoint_follower navigation2

API Docs
Browse Code

Package Summary

Tags No category tags.
Version 1.1.17
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/ros-planning/navigation2.git
VCS Type git
VCS Version humble
Last Updated 2024-11-08
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

Graceful motion controller

Additional Links

No additional links.

Maintainers

  • Alberto Tudela

Authors

No additional authors.
nav2_graceful_controller/README.md

Graceful Motion Controller

The graceful motion controller implements a controller based on the works of Jong Jin Park in “Graceful Navigation for Mobile Robots in Dynamic and Uncertain Environments”. (2016). In this implementation, a motion_target is set at a distance away from the robot that is exponentially stable to generate a smooth trajectory for the robot to follow.

See its Configuration Guide Page for additional parameter descriptions.

Smooth control law

The smooth control law is a pose-following kinematic control law that generates a smooth and confortable trajectory for the robot to follow. It is Lyapunov-based feedback control law made of three components:

  • The egocentric polar coordinates of the motion target (r, phi, delta) with respect to the robot frame.
  • A slow subsystem which describes the position of the robot.
  • A fast subsystem which describes the steering angle of the robot.

Trajectories

Parameters

Parameter Description
transform_tolerance The TF transform tolerance.
motion_target_dist The lookahead distance to use to find the motion_target point. This distance should be a value around 1.0m but not much farther away. Greater values will cause the robot to generate smoother paths but not necessarily follow the path as closely.
max_robot_pose_search_dist Maximum integrated distance along the path to bound the search for the closest pose to the robot. This is set by default to the maximum costmap extent, so it shouldn’t be set manually unless there are loops within the local costmap.
k_phi Ratio of the rate of change in phi to the rate of change in r. Controls the convergence of the slow subsystem. If this value is equal to zero, the controller will behave as a pure waypoint follower. A high value offers extreme scenario of pose-following where theta is reduced much faster than r. Note: This variable is called k1 in earlier versions of the paper.
k_delta Constant factor applied to the heading error feedback. Controls the convergence of the fast subsystem. The bigger the value, the robot converge faster to the reference heading. Note: This variable is called k2 in earlier versions of the paper.
beta Constant factor applied to the path curvature. This value must be positive. Determines how fast the velocity drops when the curvature increases.
lambda Constant factor applied to the path curvature. This value must be greater or equal to 1. Determines the sharpness of the curve: higher lambda implies sharper curves.
v_linear_min Minimum linear velocity. Units: meters/sec.
v_linear_max Maximum linear velocity. Units: meters/sec.
v_angular_max Maximum angular velocity produced by the control law. Units: radians/sec.
slowdown_radius Radius around the goal pose in which the robot will start to slow down. Units: meters.
initial_rotation Enable a rotation in place to the goal before starting the path. The control law may generate large sweeping arcs to the goal pose, depending on the initial robot orientation and k_phi, k_delta.
initial_rotation_min_angle The difference in the path orientation and the starting robot orientation to trigger a rotate in place, if initial_rotation is enabled.
final_rotation Similar to initial_rotation, the control law can generate large arcs when the goal orientation is not aligned with the path. If this is enabled, the final pose will be ignored and the robot will follow the orientation of he path and will make a final rotation in place to the goal orientation.
rotation_scaling_factor The scaling factor applied to the rotation in place velocity.
allow_backward Whether to allow the robot to move backward.

Topics

Topic Type Description
transformed_global_plan nav_msgs/Path The global plan transformed into the robot frame.
local_plan nav_msgs/Path The local plan generated by appliyng iteratively the control law upon a set of motion targets along the global plan.
motion_target geometry_msgs/PointStamped The current motion target used by the controller to compute the velocity commands.
slowdown visualization_msgs/Marker A flat circle marker of radius slowdown_radius around the motion target.
CHANGELOG
No CHANGELOG found.

Wiki Tutorials

This package does not provide any links to tutorials in it's rosindex metadata. You can check on the ROS Wiki Tutorials page for the package.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

Recent questions tagged nav2_graceful_controller at Robotics Stack Exchange

No version for distro iron. Known supported distros are highlighted in the buttons above.

nav2_graceful_controller package from navigation2 repo

nav2_amcl nav2_behavior_tree nav2_behaviors nav2_bringup nav2_bt_navigator nav2_collision_monitor nav2_common nav2_constrained_smoother nav2_controller nav2_core nav2_costmap_2d opennav_docking opennav_docking_bt opennav_docking_core costmap_queue dwb_core dwb_critics dwb_msgs dwb_plugins nav2_dwb_controller nav_2d_msgs nav_2d_utils nav2_graceful_controller nav2_lifecycle_manager nav2_loopback_sim nav2_map_server nav2_mppi_controller nav2_msgs nav2_navfn_planner nav2_planner nav2_regulated_pure_pursuit_controller nav2_rotation_shim_controller nav2_rviz_plugins nav2_simple_commander nav2_smac_planner nav2_smoother nav2_system_tests nav2_theta_star_planner nav2_util nav2_velocity_smoother nav2_voxel_grid nav2_waypoint_follower navigation2

API Docs
Browse Code

Package Summary

Tags No category tags.
Version 1.3.3
License Apache-2.0
Build type AMENT_CMAKE
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/ros-planning/navigation2.git
VCS Type git
VCS Version jazzy
Last Updated 2024-11-08
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

Graceful motion controller

Additional Links

No additional links.

Maintainers

  • Alberto Tudela

Authors

No additional authors.
nav2_graceful_controller/README.md

Graceful Motion Controller

The graceful motion controller implements a controller based on the works of Jong Jin Park in “A Smooth Control Law for Graceful Motion of Differential Wheeled Mobile Robots in 2D Environment”. In this implementation, a motion_target is set at a distance away from the robot that is exponentially stable to generate a smooth trajectory for the robot to follow.

See its Configuration Guide Page for additional parameter descriptions.

Smooth control law

The smooth control law is a pose-following kinematic control law that generates a smooth and confortable trajectory for the robot to follow. It is Lyapunov-based feedback control law made of three components:

  • The egocentric polar coordinates of the motion target (r, phi, delta) with respect to the robot frame.
  • A slow subsystem which describes the position of the robot.
  • A fast subsystem which describes the steering angle of the robot.

Trajectories

Parameters

Parameter Description
transform_tolerance The TF transform tolerance.
motion_target_dist The lookahead distance to use to find the motion_target point. This distance should be a value around 1.0m but not much farther away. Greater values will cause the robot to generate smoother paths but not necessarily follow the path as closely.
max_robot_pose_search_dist Maximum integrated distance along the path to bound the search for the closest pose to the robot. This is set by default to the maximum costmap extent, so it shouldn’t be set manually unless there are loops within the local costmap.
k_phi Ratio of the rate of change in phi to the rate of change in r. Controls the convergence of the slow subsystem. If this value is equal to zero, the controller will behave as a pure waypoint follower. A high value offers extreme scenario of pose-following where theta is reduced much faster than r. Note: This variable is called k1 in earlier versions of the paper.
k_delta Constant factor applied to the heading error feedback. Controls the convergence of the fast subsystem. The bigger the value, the robot converge faster to the reference heading. Note: This variable is called k2 in earlier versions of the paper.
beta Constant factor applied to the path curvature. This value must be positive. Determines how fast the velocity drops when the curvature increases.
lambda Constant factor applied to the path curvature. This value must be greater or equal to 1. Determines the sharpness of the curve: higher lambda implies sharper curves.
v_linear_min Minimum linear velocity. Units: meters/sec.
v_linear_max Maximum linear velocity. Units: meters/sec.
v_angular_max Maximum angular velocity produced by the control law. Units: radians/sec.
slowdown_radius Radius around the goal pose in which the robot will start to slow down. Units: meters.
initial_rotation Enable a rotation in place to the goal before starting the path. The control law may generate large sweeping arcs to the goal pose, depending on the initial robot orientation and k_phi, k_delta.
initial_rotation_min_angle The difference in the path orientation and the starting robot orientation to trigger a rotate in place, if initial_rotation is enabled.
final_rotation Similar to initial_rotation, the control law can generate large arcs when the goal orientation is not aligned with the path. If this is enabled, the final pose will be ignored and the robot will follow the orientation of he path and will make a final rotation in place to the goal orientation.
rotation_scaling_factor The scaling factor applied to the rotation in place velocity.
allow_backward Whether to allow the robot to move backward.

Topics

Topic Type Description
transformed_global_plan nav_msgs/Path The global plan transformed into the robot frame.
local_plan nav_msgs/Path The local plan generated by appliyng iteratively the control law upon a set of motion targets along the global plan.
motion_target geometry_msgs/PointStamped The current motion target used by the controller to compute the velocity commands.
slowdown visualization_msgs/Marker A flat circle marker of radius slowdown_radius around the motion target.
CHANGELOG
No CHANGELOG found.

Wiki Tutorials

This package does not provide any links to tutorials in it's rosindex metadata. You can check on the ROS Wiki Tutorials page for the package.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

Recent questions tagged nav2_graceful_controller at Robotics Stack Exchange

No version for distro rolling. Known supported distros are highlighted in the buttons above.
No version for distro noetic. Known supported distros are highlighted in the buttons above.
No version for distro ardent. Known supported distros are highlighted in the buttons above.
No version for distro bouncy. Known supported distros are highlighted in the buttons above.
No version for distro crystal. Known supported distros are highlighted in the buttons above.
No version for distro eloquent. Known supported distros are highlighted in the buttons above.
No version for distro dashing. Known supported distros are highlighted in the buttons above.
No version for distro galactic. Known supported distros are highlighted in the buttons above.
No version for distro foxy. Known supported distros are highlighted in the buttons above.
No version for distro lunar. Known supported distros are highlighted in the buttons above.
No version for distro jade. Known supported distros are highlighted in the buttons above.
No version for distro indigo. Known supported distros are highlighted in the buttons above.
No version for distro hydro. Known supported distros are highlighted in the buttons above.
No version for distro kinetic. Known supported distros are highlighted in the buttons above.
No version for distro melodic. Known supported distros are highlighted in the buttons above.