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/logger.hpp"
22 #include "rclcpp/node_interfaces/node_parameters_interface.hpp"
23 #include "rclcpp/parameter.hpp"
24 #include "nav2_ros_common/lifecycle_node.hpp"
25 #include "nav2_core/goal_checker.hpp"
26 #include "nav2_costmap_2d/costmap_2d_ros.hpp"
27 
28 namespace nav2_controller
29 {
30 
36 {
37 public:
42 
47 
54  void initialize(
55  const nav2::LifecycleNode::WeakPtr & parent,
56  const std::string & plugin_name,
57  const std::shared_ptr<nav2_costmap_2d::Costmap2DROS> costmap_ros) override;
58 
62  void reset() override;
63 
72  bool isGoalReached(
73  const geometry_msgs::msg::Pose & query_pose, const geometry_msgs::msg::Pose & goal_pose,
74  const geometry_msgs::msg::Twist & velocity,
75  const nav_msgs::msg::Path & transformed_global_plan) override;
76 
84  bool getTolerances(
85  geometry_msgs::msg::Pose & pose_tolerance,
86  geometry_msgs::msg::Twist & vel_tolerance,
87  double & path_length_tolerance) override;
88 
97  bool isGoalXYReached(
98  const geometry_msgs::msg::Pose & query_pose,
99  const geometry_msgs::msg::Pose & goal_pose,
100  const geometry_msgs::msg::Twist & velocity,
101  const nav_msgs::msg::Path & transformed_global_plan) override;
102 
103 protected:
104  nav2::LifecycleNode::WeakPtr node_;
105  rclcpp::Logger logger_{rclcpp::get_logger("position_goal_checker")};
106  double xy_goal_tolerance_, xy_goal_tolerance_buffer_;
107  double xy_goal_tolerance_sq_, xy_goal_tolerance_reset_sq_;
108  double path_length_tolerance_;
109  bool stateful_;
110  bool position_reached_;
111  std::string plugin_name_;
112  std::mutex mutex_;
113  rclcpp::node_interfaces::PostSetParametersCallbackHandle::SharedPtr post_set_params_handler_;
114  rclcpp::node_interfaces::OnSetParametersCallbackHandle::SharedPtr on_set_params_handler_;
115 
124  rcl_interfaces::msg::SetParametersResult validateParameterUpdatesCallback(
125  const std::vector<rclcpp::Parameter> & parameters);
126 
133  void updateParametersCallback(const std::vector<rclcpp::Parameter> & parameters);
134 };
135 
136 } // namespace nav2_controller
137 
138 #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.