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/logger.hpp"
43 #include "rclcpp/node_interfaces/node_parameters_interface.hpp"
44 #include "rclcpp/parameter.hpp"
45 #include "nav2_ros_common/lifecycle_node.hpp"
46 #include "nav2_core/goal_checker.hpp"
47 #include "rcl_interfaces/msg/set_parameters_result.hpp"
48 
49 namespace nav2_controller
50 {
51 
60 {
61 public:
66 
71 
78  void initialize(
79  const nav2::LifecycleNode::WeakPtr & parent,
80  const std::string & plugin_name,
81  const std::shared_ptr<nav2_costmap_2d::Costmap2DROS> costmap_ros) override;
82 
86  void reset() override;
87 
96  bool isGoalReached(
97  const geometry_msgs::msg::Pose & query_pose, 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 
108  bool getTolerances(
109  geometry_msgs::msg::Pose & pose_tolerance,
110  geometry_msgs::msg::Twist & vel_tolerance,
111  double & path_length_tolerance) override;
112 
121  bool isGoalXYReached(
122  const geometry_msgs::msg::Pose & query_pose,
123  const geometry_msgs::msg::Pose & goal_pose,
124  const geometry_msgs::msg::Twist & velocity,
125  const nav_msgs::msg::Path & transformed_global_plan) override;
126 
127 protected:
128  nav2::LifecycleNode::WeakPtr node_;
129  rclcpp::Logger logger_{rclcpp::get_logger("simple_goal_checker")};
130  double xy_goal_tolerance_, xy_goal_tolerance_buffer_, yaw_goal_tolerance_, path_length_tolerance_;
131  bool stateful_, check_xy_;
132  bool symmetric_yaw_tolerance_;
133  // Cached squared xy_goal_tolerance_ and xy_goal_tolerance_reset_
134  double xy_goal_tolerance_sq_, xy_goal_tolerance_reset_sq_;
135  // Dynamic parameters handler
136  std::mutex mutex_;
137  rclcpp::node_interfaces::PostSetParametersCallbackHandle::SharedPtr post_set_params_handler_;
138  rclcpp::node_interfaces::OnSetParametersCallbackHandle::SharedPtr on_set_params_handler_;
139  std::string plugin_name_;
140 
149  rcl_interfaces::msg::SetParametersResult validateParameterUpdatesCallback(
150  const std::vector<rclcpp::Parameter> & parameters);
151 
158  void updateParametersCallback(const std::vector<rclcpp::Parameter> & parameters);
159 };
160 
161 } // namespace nav2_controller
162 
163 #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.