move_group.h

Go to the documentation of this file.

/*********************************************************************
* Software License Agreement (BSD License)
*
*  Copyright (c) 2012, Willow Garage, Inc.
*  All rights reserved.
*
*  Redistribution and use in source and binary forms, with or without
*  modification, are permitted provided that the following conditions
*  are met:
*
*   * Redistributions of source code must retain the above copyright
*     notice, this list of conditions and the following disclaimer.
*   * Redistributions in binary form must reproduce the above
*     copyright notice, this list of conditions and the following
*     disclaimer in the documentation and/or other materials provided
*     with the distribution.
*   * Neither the name of the Willow Garage nor the names of its
*     contributors may be used to endorse or promote products derived
*     from this software without specific prior written permission.
*
*  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
*  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
*  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
*  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
*  COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
*  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
*  BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
*  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
*  CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
*  LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
*  ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
*  POSSIBILITY OF SUCH DAMAGE.
*********************************************************************/

/* Author: Ioan Sucan */

#ifndef MOVEIT_MOVE_GROUP_INTERFACE_MOVE_GROUP_
#define MOVEIT_MOVE_GROUP_INTERFACE_MOVE_GROUP_

#include <moveit/robot_state/robot_state.h>
#include <moveit_msgs/RobotTrajectory.h>
#include <moveit_msgs/RobotState.h>
#include <moveit_msgs/PlannerInterfaceDescription.h>
#include <moveit_msgs/Constraints.h>
#include <manipulation_msgs/Grasp.h>
#include <manipulation_msgs/PlaceLocation.h>
#include <geometry_msgs/PoseStamped.h>
#include <boost/shared_ptr.hpp>
#include <tf/tf.h>

namespace moveit
{

namespace planning_interface
{

class MoveGroup
{
public:

  static const std::string ROBOT_DESCRIPTION;

  struct Options
  {
    Options(const std::string &group_name,
            const std::string &desc = ROBOT_DESCRIPTION) :
      group_name_(group_name),
      robot_description_(desc)
    {
    }

    std::string group_name_;

    std::string robot_description_;

    robot_model::RobotModelConstPtr robot_model_;
  };

  struct Plan
  {
    moveit_msgs::RobotState start_state_;

    moveit_msgs::RobotTrajectory trajectory_;
  };

  MoveGroup(const Options &opt, const boost::shared_ptr<tf::Transformer> &tf = boost::shared_ptr<tf::Transformer>(),
            const ros::Duration &wait_for_server = ros::Duration(0, 0));

  MoveGroup(const std::string &group, const boost::shared_ptr<tf::Transformer> &tf = boost::shared_ptr<tf::Transformer>(),
            const ros::Duration &wait_for_server = ros::Duration(0, 0));

  ~MoveGroup();

  const std::string& getName() const;

  const std::string& getPlanningFrame() const;

  const std::vector<std::string>& getJoints() const;

  unsigned int getVariableCount() const;

  bool getInterfaceDescription(moveit_msgs::PlannerInterfaceDescription &desc);

  void setPlannerId(const std::string &planner_id);

  void setPlanningTime(double seconds);

  double getPlanningTime() const;

  double getGoalJointTolerance() const;

  double getGoalPositionTolerance() const;

  double getGoalOrientationTolerance() const;

  void setGoalTolerance(double tolerance);

  void setGoalJointTolerance(double tolerance);

  void setGoalPositionTolerance(double tolerance);

  void setGoalOrientationTolerance(double tolerance);

  void setWorkspace(double minx, double miny, double minz, double maxx, double maxy, double maxz);

  void setStartState(const robot_state::RobotState &start_state);

  void setStartStateToCurrentState();

  void setSupportSurfaceName(const std::string &name);

  bool setJointValueTarget(const std::vector<double> &group_variable_values);

  bool setJointValueTarget(const std::map<std::string, double> &variable_values);

  bool setJointValueTarget(const robot_state::RobotState &robot_state);

  bool setJointValueTarget(const robot_state::JointStateGroup &joint_state_group);

  bool setJointValueTarget(const robot_state::JointState &joint_state);

  bool setJointValueTarget(const std::string &joint_name, const std::vector<double> &values);

  bool setJointValueTarget(const std::string &joint_name, double value);

  bool setJointValueTarget(const sensor_msgs::JointState &state);

  void setRandomTarget();

  bool setNamedTarget(const std::string &name);

  const robot_state::JointStateGroup& getJointValueTarget() const;

  bool setPositionTarget(double x, double y, double z, const std::string &end_effector_link = "");

  bool setRPYTarget(double roll, double pitch, double yaw, const std::string &end_effector_link = "");

  bool setOrientationTarget(double x, double y, double z, double w, const std::string &end_effector_link = "");

  bool setPoseTarget(const Eigen::Affine3d &end_effector_pose, const std::string &end_effector_link = "");

  bool setPoseTarget(const geometry_msgs::Pose &target, const std::string &end_effector_link = "");

  bool setPoseTarget(const geometry_msgs::PoseStamped &target, const std::string &end_effector_link = "");

  bool setPoseTargets(const EigenSTL::vector_Affine3d &end_effector_pose, const std::string &end_effector_link = "");

  bool setPoseTargets(const std::vector<geometry_msgs::Pose> &target, const std::string &end_effector_link = "");

  bool setPoseTargets(const std::vector<geometry_msgs::PoseStamped> &target, const std::string &end_effector_link = "");

  void setPoseReferenceFrame(const std::string &pose_reference_frame);

  bool setEndEffectorLink(const std::string &link_name);

  bool setEndEffector(const std::string &eef_name);

  void clearPoseTarget(const std::string &end_effector_link = "");

  void clearPoseTargets();

  const geometry_msgs::PoseStamped& getPoseTarget(const std::string &end_effector_link = "") const;

  const std::vector<geometry_msgs::PoseStamped>& getPoseTargets(const std::string &end_effector_link = "") const;

  const std::string& getEndEffectorLink() const;

  const std::string& getEndEffector() const;

  const std::string& getPoseReferenceFrame() const;

  bool asyncMove();

  bool move();

  bool plan(Plan &plan);

  bool asyncExecute(const Plan &plan);

  bool execute(const Plan &plan);

  double computeCartesianPath(const std::vector<geometry_msgs::Pose> &waypoints, double eef_step, double jump_threshold,
                  moveit_msgs::RobotTrajectory &trajectory,  bool avoid_collisions = true);

  void stop();

  void allowLooking(bool flag);

  void allowReplanning(bool flag);

  bool pick(const std::string &object);

  bool pick(const std::string &object, const manipulation_msgs::Grasp &grasp);

  bool pick(const std::string &object, const std::vector<manipulation_msgs::Grasp> &grasps);

  bool place(const std::string &object);

  bool place(const std::string &object, const std::vector<manipulation_msgs::PlaceLocation> &locations);

  bool place(const std::string &object, const std::vector<geometry_msgs::PoseStamped> &poses);

  bool place(const std::string &object, const geometry_msgs::PoseStamped &pose);

  std::vector<double> getCurrentJointValues();

  robot_state::RobotStatePtr getCurrentState();

  geometry_msgs::PoseStamped getCurrentPose(const std::string &end_effector_link = "");

  std::vector<double> getCurrentRPY(const std::string &end_effector_link = "");

  std::vector<double> getRandomJointValues();

  geometry_msgs::PoseStamped getRandomPose(const std::string &end_effector_link = "");

  void rememberJointValues(const std::string &name);

  void rememberJointValues(const std::string &name, const std::vector<double> &values);

  const std::map<std::string, std::vector<double> >& getRememberedJointValues() const
  {
    return remembered_joint_values_;
  }

  void forgetJointValues(const std::string &name);

  void setConstraintsDatabase(const std::string &host, unsigned int port);

  std::vector<std::string> getKnownConstraints() const;

  bool setPathConstraints(const std::string &constraint);

  void setPathConstraints(const moveit_msgs::Constraints &constraint);

  void clearPathConstraints();

private:

  std::map<std::string, std::vector<double> > remembered_joint_values_;
  class MoveGroupImpl;
  MoveGroupImpl *impl_;

};

}
}
// for backward compatibility; remove in hydro
namespace move_group_interface=moveit::planning_interface;

#endif