Nav2 Navigation Stack - lyrical  lyrical
ROS 2 Navigation Stack
position_goal_checker.hpp
1 // Copyright (c) 2025 Prabhav Saxena
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #ifndef NAV2_CONTROLLER__PLUGINS__POSITION_GOAL_CHECKER_HPP_
16 #define NAV2_CONTROLLER__PLUGINS__POSITION_GOAL_CHECKER_HPP_
17 
18 #include <string>
19 #include <memory>
20 #include <vector>
21 #include "rclcpp/rclcpp.hpp"
22 #include "nav2_ros_common/lifecycle_node.hpp"
23 #include "nav2_core/goal_checker.hpp"
24 #include "nav2_costmap_2d/costmap_2d_ros.hpp"
25 
26 namespace nav2_controller
27 {
28 
34 {
35 public:
40 
45 
52  void initialize(
53  const nav2::LifecycleNode::WeakPtr & parent,
54  const std::string & plugin_name,
55  const std::shared_ptr<nav2_costmap_2d::Costmap2DROS> costmap_ros) override;
56 
60  void reset() override;
61 
70  bool isGoalReached(
71  const geometry_msgs::msg::Pose & query_pose, const geometry_msgs::msg::Pose & goal_pose,
72  const geometry_msgs::msg::Twist & velocity,
73  const nav_msgs::msg::Path & transformed_global_plan) override;
74 
82  bool getTolerances(
83  geometry_msgs::msg::Pose & pose_tolerance,
84  geometry_msgs::msg::Twist & vel_tolerance,
85  double & path_length_tolerance) override;
86 
95  bool isGoalXYReached(
96  const geometry_msgs::msg::Pose & query_pose,
97  const geometry_msgs::msg::Pose & goal_pose,
98  const geometry_msgs::msg::Twist & velocity,
99  const nav_msgs::msg::Path & transformed_global_plan) override;
100 
101 protected:
102  nav2::LifecycleNode::WeakPtr node_;
103  rclcpp::Logger logger_{rclcpp::get_logger("position_goal_checker")};
104  double xy_goal_tolerance_, xy_goal_tolerance_buffer_;
105  double xy_goal_tolerance_sq_, xy_goal_tolerance_reset_sq_;
106  double path_length_tolerance_;
107  bool stateful_;
108  bool position_reached_;
109  std::string plugin_name_;
110  std::mutex mutex_;
111  rclcpp::node_interfaces::PostSetParametersCallbackHandle::SharedPtr post_set_params_handler_;
112  rclcpp::node_interfaces::OnSetParametersCallbackHandle::SharedPtr on_set_params_handler_;
113 
122  rcl_interfaces::msg::SetParametersResult validateParameterUpdatesCallback(
123  const std::vector<rclcpp::Parameter> & parameters);
124 
131  void updateParametersCallback(const std::vector<rclcpp::Parameter> & parameters);
132 };
133 
134 } // namespace nav2_controller
135 
136 #endif // NAV2_CONTROLLER__PLUGINS__POSITION_GOAL_CHECKER_HPP_
Goal Checker plugin that only checks XY position, ignoring orientation.
void reset() override
Reset the goal checker state.
bool getTolerances(geometry_msgs::msg::Pose &pose_tolerance, geometry_msgs::msg::Twist &vel_tolerance, double &path_length_tolerance) override
Get the position and velocity tolerances.
rcl_interfaces::msg::SetParametersResult validateParameterUpdatesCallback(const std::vector< rclcpp::Parameter > &parameters)
Validate incoming parameter updates before applying them. This callback is triggered when one or more...
bool isGoalXYReached(const geometry_msgs::msg::Pose &query_pose, const geometry_msgs::msg::Pose &goal_pose, const geometry_msgs::msg::Twist &velocity, const nav_msgs::msg::Path &transformed_global_plan) override
Check if XY goal position has been reached (without considering yaw)
~PositionGoalChecker()
Destroy the Position Goal Checker object.
bool isGoalReached(const geometry_msgs::msg::Pose &query_pose, const geometry_msgs::msg::Pose &goal_pose, const geometry_msgs::msg::Twist &velocity, const nav_msgs::msg::Path &transformed_global_plan) override
Check if the goal is reached.
void updateParametersCallback(const std::vector< rclcpp::Parameter > &parameters)
Apply parameter updates after validation This callback is executed when parameters have been successf...
void initialize(const nav2::LifecycleNode::WeakPtr &parent, const std::string &plugin_name, const std::shared_ptr< nav2_costmap_2d::Costmap2DROS > costmap_ros) override
Initialize the goal checker.
PositionGoalChecker()
Construct a new Position Goal Checker object.
Function-object for checking whether a goal has been reached.