Nav2 Navigation Stack - jazzy  jazzy
ROS 2 Navigation Stack
rotate_to_goal.cpp
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 #include "dwb_critics/rotate_to_goal.hpp"
36 #include <string>
37 #include <vector>
38 #include "nav_2d_utils/parameters.hpp"
39 #include "dwb_core/exceptions.hpp"
40 #include "pluginlib/class_list_macros.hpp"
41 #include "dwb_core/trajectory_utils.hpp"
42 #include "angles/angles.h"
43 
45 
46 namespace dwb_critics
47 {
48 
49 inline double hypot_sq(double dx, double dy)
50 {
51  return dx * dx + dy * dy;
52 }
53 
54 void RotateToGoalCritic::onInit()
55 {
56  auto node = node_.lock();
57  if (!node) {
58  throw std::runtime_error{"Failed to lock node"};
59  }
60 
61  xy_goal_tolerance_ = nav_2d_utils::searchAndGetParam(
62  node,
63  dwb_plugin_name_ + ".xy_goal_tolerance", 0.25);
64  xy_goal_tolerance_sq_ = xy_goal_tolerance_ * xy_goal_tolerance_;
65  double stopped_xy_velocity = nav_2d_utils::searchAndGetParam(
66  node,
67  dwb_plugin_name_ + ".trans_stopped_velocity", 0.25);
68  stopped_xy_velocity_sq_ = stopped_xy_velocity * stopped_xy_velocity;
69  slowing_factor_ = nav_2d_utils::searchAndGetParam(
70  node,
71  dwb_plugin_name_ + "." + name_ + ".slowing_factor", 5.0);
72  lookahead_time_ = nav_2d_utils::searchAndGetParam(
73  node,
74  dwb_plugin_name_ + "." + name_ + ".lookahead_time", -1.0);
75  reset();
76 }
77 
79 {
80  in_window_ = false;
81  rotating_ = false;
82 }
83 
85  const geometry_msgs::msg::Pose2D & pose, const nav_2d_msgs::msg::Twist2D & vel,
86  const geometry_msgs::msg::Pose2D & goal,
87  const nav_2d_msgs::msg::Path2D &)
88 {
89  double dxy_sq = hypot_sq(pose.x - goal.x, pose.y - goal.y);
90  in_window_ = in_window_ || dxy_sq <= xy_goal_tolerance_sq_;
91  current_xy_speed_sq_ = hypot_sq(vel.x, vel.y);
92  rotating_ = rotating_ || (in_window_ && current_xy_speed_sq_ <= stopped_xy_velocity_sq_);
93  goal_yaw_ = goal.theta;
94  return true;
95 }
96 
97 double RotateToGoalCritic::scoreTrajectory(const dwb_msgs::msg::Trajectory2D & traj)
98 {
99  // If we're not sufficiently close to the goal, we don't care what the twist is
100  if (!in_window_) {
101  return 0.0;
102  } else if (!rotating_) {
103  double speed_sq = hypot_sq(traj.velocity.x, traj.velocity.y);
104  if (speed_sq >= current_xy_speed_sq_) {
105  throw dwb_core::IllegalTrajectoryException(name_, "Not slowing down near goal.");
106  }
107  return speed_sq * slowing_factor_ + scoreRotation(traj);
108  }
109 
110  // If we're sufficiently close to the goal, any transforming velocity is invalid
111  if (fabs(traj.velocity.x) > 0 || fabs(traj.velocity.y) > 0) {
112  throw dwb_core::
113  IllegalTrajectoryException(name_, "Nonrotation command near goal.");
114  }
115 
116  return scoreRotation(traj);
117 }
118 
119 double RotateToGoalCritic::scoreRotation(const dwb_msgs::msg::Trajectory2D & traj)
120 {
121  if (traj.poses.empty()) {
122  throw dwb_core::IllegalTrajectoryException(name_, "Empty trajectory.");
123  }
124 
125  double end_yaw;
126  if (lookahead_time_ >= 0.0) {
127  geometry_msgs::msg::Pose2D eval_pose = dwb_core::projectPose(traj, lookahead_time_);
128  end_yaw = eval_pose.theta;
129  } else {
130  end_yaw = traj.poses.back().theta;
131  }
132  return fabs(angles::shortest_angular_distance(end_yaw, goal_yaw_));
133 }
134 
135 } // namespace dwb_critics
Thrown when one of the critics encountered a fatal error.
Definition: exceptions.hpp:50
Evaluates a Trajectory2D to produce a score.
Forces the commanded trajectories to only be rotations if within a certain distance window.
void reset() override
Reset the state of the critic.
virtual double scoreRotation(const dwb_msgs::msg::Trajectory2D &traj)
Assuming that this is an actual rotation when near the goal, score the trajectory.
double scoreTrajectory(const dwb_msgs::msg::Trajectory2D &traj) override
Return a raw score for the given trajectory.
bool prepare(const geometry_msgs::msg::Pose2D &pose, const nav_2d_msgs::msg::Twist2D &vel, const geometry_msgs::msg::Pose2D &goal, const nav_2d_msgs::msg::Path2D &global_plan) override
Prior to evaluating any trajectories, look at contextual information constant across all trajectories...