Nav2 Navigation Stack - lyrical  lyrical
ROS 2 Navigation Stack
simple_goal_checker.hpp
1 /*
2  * Software License Agreement (BSD License)
3  *
4  * Copyright (c) 2017, Locus Robotics
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * * Redistributions of source code must retain the above copyright
12  * notice, this list of conditions and the following disclaimer.
13  * * Redistributions in binary form must reproduce the above
14  * copyright notice, this list of conditions and the following
15  * disclaimer in the documentation and/or other materials provided
16  * with the distribution.
17  * * Neither the name of the copyright holder nor the names of its
18  * contributors may be used to endorse or promote products derived
19  * from this software without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
24  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
25  * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
26  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
27  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
29  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
31  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
32  * POSSIBILITY OF SUCH DAMAGE.
33  */
34 
35 #ifndef NAV2_CONTROLLER__PLUGINS__SIMPLE_GOAL_CHECKER_HPP_
36 #define NAV2_CONTROLLER__PLUGINS__SIMPLE_GOAL_CHECKER_HPP_
37 
38 #include <memory>
39 #include <string>
40 #include <vector>
41 
42 #include "rclcpp/rclcpp.hpp"
43 #include "nav2_ros_common/lifecycle_node.hpp"
44 #include "nav2_core/goal_checker.hpp"
45 #include "rcl_interfaces/msg/set_parameters_result.hpp"
46 
47 namespace nav2_controller
48 {
49 
58 {
59 public:
64 
69 
76  void initialize(
77  const nav2::LifecycleNode::WeakPtr & parent,
78  const std::string & plugin_name,
79  const std::shared_ptr<nav2_costmap_2d::Costmap2DROS> costmap_ros) override;
80 
84  void reset() override;
85 
94  bool isGoalReached(
95  const geometry_msgs::msg::Pose & query_pose, const geometry_msgs::msg::Pose & goal_pose,
96  const geometry_msgs::msg::Twist & velocity,
97  const nav_msgs::msg::Path & transformed_global_plan) override;
98 
106  bool getTolerances(
107  geometry_msgs::msg::Pose & pose_tolerance,
108  geometry_msgs::msg::Twist & vel_tolerance,
109  double & path_length_tolerance) override;
110 
119  bool isGoalXYReached(
120  const geometry_msgs::msg::Pose & query_pose,
121  const geometry_msgs::msg::Pose & goal_pose,
122  const geometry_msgs::msg::Twist & velocity,
123  const nav_msgs::msg::Path & transformed_global_plan) override;
124 
125 protected:
126  nav2::LifecycleNode::WeakPtr node_;
127  rclcpp::Logger logger_{rclcpp::get_logger("simple_goal_checker")};
128  double xy_goal_tolerance_, xy_goal_tolerance_buffer_, yaw_goal_tolerance_, path_length_tolerance_;
129  bool stateful_, check_xy_;
130  bool symmetric_yaw_tolerance_;
131  // Cached squared xy_goal_tolerance_ and xy_goal_tolerance_reset_
132  double xy_goal_tolerance_sq_, xy_goal_tolerance_reset_sq_;
133  // Dynamic parameters handler
134  std::mutex mutex_;
135  rclcpp::node_interfaces::PostSetParametersCallbackHandle::SharedPtr post_set_params_handler_;
136  rclcpp::node_interfaces::OnSetParametersCallbackHandle::SharedPtr on_set_params_handler_;
137  std::string plugin_name_;
138 
147  rcl_interfaces::msg::SetParametersResult validateParameterUpdatesCallback(
148  const std::vector<rclcpp::Parameter> & parameters);
149 
156  void updateParametersCallback(const std::vector<rclcpp::Parameter> & parameters);
157 };
158 
159 } // namespace nav2_controller
160 
161 #endif // NAV2_CONTROLLER__PLUGINS__SIMPLE_GOAL_CHECKER_HPP_
Goal Checker plugin that only checks the position difference.
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.
void reset() override
Reset the goal checker state.
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.
~SimpleGoalChecker()
Destroy the Simple Goal Checker object.
void updateParametersCallback(const std::vector< rclcpp::Parameter > &parameters)
Apply parameter updates after validation This callback is executed when parameters have been successf...
SimpleGoalChecker()
Construct a new Simple Goal Checker object.
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)
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...
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.
Function-object for checking whether a goal has been reached.