moveit2
The MoveIt Motion Planning Framework for ROS 2.
pr2_arm_kinematics_plugin.hpp
Go to the documentation of this file.
1 /*********************************************************************
2  * Software License Agreement (BSD License)
3  *
4  * Copyright (c) 2008, Willow Garage, Inc.
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 Willow Garage 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 OWNER 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 /* Author: Sachin Chitta */
36 
37 #pragma once
38 
39 #include <kdl/config.h>
40 #include <kdl/frames.hpp>
41 #include <kdl/jntarray.hpp>
42 #include <kdl/tree.hpp>
43 #include <kdl_parser/kdl_parser.hpp>
44 
46 #include <moveit_msgs/srv/get_position_fk.hpp>
47 #include <moveit_msgs/srv/get_position_ik.hpp>
48 #include <moveit_msgs/msg/kinematic_solver_info.hpp>
49 #include <moveit_msgs/msg/move_it_error_codes.hpp>
50 
51 #include <kdl/chainfksolverpos_recursive.hpp>
52 
53 #if __has_include(<urdf/model.hpp>)
54 #include <urdf/model.hpp>
55 #else
56 #include <urdf/model.h>
57 #endif
58 
60 
61 #include <memory>
62 
63 #include "pr2_arm_ik.hpp"
64 
65 namespace pr2_arm_kinematics
66 {
67 static const int NO_IK_SOLUTION = -1;
68 static const int TIMED_OUT = -2;
69 
71 
72 // minimal stuff necessary
73 class PR2ArmIKSolver : public KDL::ChainIkSolverPos
74 {
75 public:
77 
86  PR2ArmIKSolver(const urdf::ModelInterface& robot_model, const std::string& root_frame_name,
87  const std::string& tip_frame_name, double search_discretization_angle, int free_angle);
88 
89  ~PR2ArmIKSolver() override{};
90 
91  void updateInternalDataStructures() override;
92 
97 
101  bool active_;
102 
103  int CartToJnt(const KDL::JntArray& q_init, const KDL::Frame& p_in, KDL::JntArray& q_out) override;
104 
105  int cartToJntSearch(const KDL::JntArray& q_in, const KDL::Frame& p_in, KDL::JntArray& q_out, double timeout);
106 
107  void getSolverInfo(moveit_msgs::msg::KinematicSolverInfo& response)
108  {
109  pr2_arm_ik_.getSolverInfo(response);
110  }
111 
112 private:
113  bool getCount(int& count, int max_count, int min_count);
114 
115  double search_discretization_angle_;
116 
117  int free_angle_;
118 
119  std::string root_frame_name_;
120 };
121 
122 Eigen::Isometry3f kdlToEigenMatrix(const KDL::Frame& p);
123 double computeEuclideanDistance(const std::vector<double>& array_1, const KDL::JntArray& array_2);
124 void getKDLChainInfo(const KDL::Chain& chain, moveit_msgs::msg::KinematicSolverInfo& chain_info);
125 
127 
129 {
130 public:
135 
140  bool isActive();
141 
149  bool
150  getPositionIK(const geometry_msgs::msg::Pose& ik_pose, const std::vector<double>& ik_seed_state,
151  std::vector<double>& solution, moveit_msgs::msg::MoveItErrorCodes& error_code,
153 
162  bool searchPositionIK(
163  const geometry_msgs::msg::Pose& ik_pose, const std::vector<double>& ik_seed_state, double timeout,
164  std::vector<double>& solution, moveit_msgs::msg::MoveItErrorCodes& error_code,
175  bool searchPositionIK(
176  const geometry_msgs::msg::Pose& ik_pose, const std::vector<double>& ik_seed_state, double timeout,
177  const std::vector<double>& consistency_limits, std::vector<double>& solution,
178  moveit_msgs::msg::MoveItErrorCodes& error_code,
180 
189  bool searchPositionIK(
190  const geometry_msgs::msg::Pose& ik_pose, const std::vector<double>& ik_seed_state, double timeout,
191  std::vector<double>& solution, const IKCallbackFn& solution_callback,
192  moveit_msgs::msg::MoveItErrorCodes& error_code,
194 
205  bool searchPositionIK(
206  const geometry_msgs::msg::Pose& ik_pose, const std::vector<double>& ik_seed_state, double timeout,
207  const std::vector<double>& consistency_limits, std::vector<double>& solution,
208  const IKCallbackFn& solution_callback, moveit_msgs::msg::MoveItErrorCodes& error_code,
210 
218  bool getPositionFK(const std::vector<std::string>& link_names, const std::vector<double>& joint_angles,
219  std::vector<geometry_msgs::msg::Pose>& poses) const override;
220 
225  bool initialize(const rclcpp::Node::SharedPtr& node, const moveit::core::RobotModel& robot_model,
226  const std::string& group_name, const std::string& base_frame,
227  const std::vector<std::string>& tip_frames, double search_discretization) override;
228 
232  const std::vector<std::string>& getJointNames() const override;
233 
237  const std::vector<std::string>& getLinkNames() const override;
238 
239 protected:
240  bool active_;
242  pr2_arm_kinematics::PR2ArmIKSolverPtr pr2_arm_ik_solver_;
243  std::string root_name_;
245  std::shared_ptr<KDL::ChainFkSolverPos_recursive> jnt_to_pose_solver_;
246  KDL::Chain kdl_chain_;
247  moveit_msgs::msg::KinematicSolverInfo ik_solver_info_, fk_solver_info_;
248 
251 
252  void desiredPoseCallback(const KDL::JntArray& jnt_array, const KDL::Frame& ik_pose,
253  moveit_msgs::msg::MoveItErrorCodes& error_code) const;
254 
255  void jointSolutionCallback(const KDL::JntArray& jnt_array, const KDL::Frame& ik_pose,
256  moveit_msgs::msg::MoveItErrorCodes& error_code) const;
257 };
258 } // namespace pr2_arm_kinematics
ROS/KDL based interface for the inverse kinematics of the PR2 arm.
Provides an interface for kinematics solvers.
std::function< void(const geometry_msgs::msg::Pose &, const std::vector< double > &, moveit_msgs::msg::MoveItErrorCodes &)> IKCallbackFn
Signature for a callback to validate an IK solution. Typically used for collision checking.
Definition of a kinematic model. This class is not thread safe, however multiple instances can be cre...
Definition: robot_model.hpp:76
int cartToJntSearch(const KDL::JntArray &q_in, const KDL::Frame &p_in, KDL::JntArray &q_out, double timeout)
PR2ArmIK pr2_arm_ik_
The PR2 inverse kinematics solver.
void getSolverInfo(moveit_msgs::msg::KinematicSolverInfo &response)
int CartToJnt(const KDL::JntArray &q_init, const KDL::Frame &p_in, KDL::JntArray &q_out) override
bool active_
Indicates whether the solver has been successfully initialized.
PR2ArmIKSolver(const urdf::ModelInterface &robot_model, const std::string &root_frame_name, const std::string &tip_frame_name, double search_discretization_angle, int free_angle)
void getSolverInfo(moveit_msgs::msg::KinematicSolverInfo &info)
get chain information about the arm. This populates the IK query response, filling in joint level inf...
Definition: pr2_arm_ik.cpp:205
bool isActive()
Specifies if the node is active or not.
void desiredPoseCallback(const KDL::JntArray &jnt_array, const KDL::Frame &ik_pose, moveit_msgs::msg::MoveItErrorCodes &error_code) const
moveit_msgs::msg::KinematicSolverInfo ik_solver_info_
const std::vector< std::string > & getJointNames() const override
Return all the joint names in the order they are used internally.
bool initialize(const rclcpp::Node::SharedPtr &node, const moveit::core::RobotModel &robot_model, const std::string &group_name, const std::string &base_frame, const std::vector< std::string > &tip_frames, double search_discretization) override
Initialization function for the kinematics.
const std::vector< std::string > & getLinkNames() const override
Return all the link names in the order they are represented internally.
pr2_arm_kinematics::PR2ArmIKSolverPtr pr2_arm_ik_solver_
moveit_msgs::msg::KinematicSolverInfo fk_solver_info_
bool getPositionIK(const geometry_msgs::msg::Pose &ik_pose, const std::vector< double > &ik_seed_state, std::vector< double > &solution, moveit_msgs::msg::MoveItErrorCodes &error_code, const kinematics::KinematicsQueryOptions &options=kinematics::KinematicsQueryOptions()) const override
Given a desired pose of the end-effector, compute the joint angles to reach it.
void jointSolutionCallback(const KDL::JntArray &jnt_array, const KDL::Frame &ik_pose, moveit_msgs::msg::MoveItErrorCodes &error_code) const
bool getPositionFK(const std::vector< std::string > &link_names, const std::vector< double > &joint_angles, std::vector< geometry_msgs::msg::Pose > &poses) const override
Given a set of joint angles and a set of links, compute their pose.
std::shared_ptr< KDL::ChainFkSolverPos_recursive > jnt_to_pose_solver_
bool searchPositionIK(const geometry_msgs::msg::Pose &ik_pose, const std::vector< double > &ik_seed_state, double timeout, std::vector< double > &solution, moveit_msgs::msg::MoveItErrorCodes &error_code, const kinematics::KinematicsQueryOptions &options=kinematics::KinematicsQueryOptions()) const override
Given a desired pose of the end-effector, search for the joint angles required to reach it....
void getKDLChainInfo(const KDL::Chain &chain, moveit_msgs::msg::KinematicSolverInfo &chain_info)
double computeEuclideanDistance(const std::vector< double > &array_1, const KDL::JntArray &array_2)
MOVEIT_CLASS_FORWARD(PR2ArmIKSolver)
Eigen::Isometry3f kdlToEigenMatrix(const KDL::Frame &p)
FilterFn chain(const std::vector< FilterFn > &filter_functions)
A set of options for the kinematics solver.