SUPPORT FOR THIS PACKAGE HAS ENDED

Sorry, too many things to maintain. I’ll still merge PRs and am happy to share maintainership of this package with someone interested.

MoveIt! Simple Grasps

A basic grasp generator for simple objects such as blocks or cylinders for use with the MoveIt! pick and place pipeline. Does not consider friction cones or other dynamics.

Its current implementation simple takes as input a pose vector (postition and orientation) and generates a large number of potential grasp approaches and directions. Also includes a grasp filter for removing kinematically infeasible grasps via threaded IK solvers.

This package includes:

• Simple pose-based grasp generator for a block
• Separate grasp generators for custom objects such as rectanguar or cylindrical objects
• Grasp filter
• Test code and visualizations

Developed by Dave Coleman at the Correll Robotics Lab, University of Colorado Boulder with outside contributors.

Video Demo

A simple demo with Baxter:

Build Status

Install

Ubuntu Debian

Hydro:

sudo apt-get install ros-hydro-moveit-simple-grasps

Indigo:

sudo apt-get install ros-indigo-moveit-simple-grasps

Install From Source

Clone this repository into a catkin workspace, then use the rosdep install tool to automatically download its dependencies. Depending on your current version of ROS, use:

Hydro:

rosdep install --from-paths src --ignore-src --rosdistro hydro

Indigo:

rosdep install --from-paths src --ignore-src --rosdistro indigo

Robot-Agnostic Configuration

You will first need a configuration file that described your robot’s end effector geometry. Currently an example format can be seen in this repository at config/baxter_grasp_data.yaml. See the comments within that file for explanations.

To load that file at launch, you copy the example in the file launch/grasp_test.launch where you should see the line <rosparam command="load" file="$(find moveit_simple_grasps)/config/baxter_grasp_data.yaml"/>.

Code Usage

Note: You might find the moveit_blocks.h example, discussed at the bottom of this page, most helpful.

We will discuss how to use the generation, filtering, and visualization components.

Within your robot’s ROS package, add this package to your package.xml, CMakeLists.txt. Then in whatever C++ file add this to your includes:

// Grasp generation and visualization
#include <moveit_simple_grasps/simple_grasps.h>
#include <moveit_simple_grasps/grasp_data.h>
#include <moveit_visual_tools/moveit_visual_tools.h>

Add to your class’s member variables the following:

// Grasp generator
moveit_simple_grasps::SimpleGraspsPtr simple_grasps_;

// class for publishing stuff to rviz
moveit_visual_tools::MoveItVisualToolsPtr visual_tools_;

// robot-specific data for generating grasps
moveit_simple_grasps::GraspData grasp_data_;

In your class’ constructor initialize the visualization tools;

// Load the Robot Viz Tools for publishing to Rviz
visual_tools_.reset(new moveit_visual_tools::MoveItVisualTools("base_link"));

Change the first parameter of visual tools to the name of your robot’s base link. For more information on that package, see moveit_visual_tools.

Then load your robot’s custom .yaml grasp data file:

``` // Load grasp data specific to our robot ros::NodeHandle nh(“~”);

File truncated at 100 lines see the full file

Changelog for package moveit_simple_grasps

1.3.1 (2015-12-07)

• catkin lint cleanup
• Contributors: Dave Coleman

1.3.0 (2015-12-05)

• Z Axis implemented
• Fixed API changes in moveit_visual_tools
• Adding grasp configurations for Romeo, Nao and Pepper
• Update README.md
• Fix install space
• New setRobotStatePreGrasp(), setRobotStateGrasp(), and setRobotState() functions for opening and closing EE
• Fixed test launch
• Added new test functions
• Contributors: Dave Coleman, nlyubova, rheidrich

1.2.1 (2014-10-27)

• Refactored for new moveit_visual_tools API
• Fixed package.xml
• Updated README
• Contributors: Dave Coleman

1.2.0 (2014-09-19)

1.1.0 (2014-07-31)

• Fixed grasp pose rotation
• Created new verbose constructor flag to enable easy debugging
• Allow a grasp pose to be rotated along z axis
• Created new pick place pipeline template
• Moved ClamArm config to this repo
• Updated package description
• Updated README
• Contributors: Dave Coleman

1.0.1 (2014-05-30)

• Moved base link out of individual end effector configurations
• Fixed tests for new gripper config format
• Fix for strict cppcheck and g++ warnings/errors
• Remove self assignment
• fix functions with no return statement and other cppcheck errors fix
• Compatibility changes for ROS Indigo (Eigen find pkg)
• Restored the lost grasp data for REEM
• Renamed grasp data config file for REEM and updated launch file accordingly.
• Fix lost contents of file and add left hand.
• Enabled dual arm grasping, filtering
• Fixes for more strict moveit_visual_tools data access
• Deprecated function, made robot grasp config files have more than 1 end effector
• Fixed posture bug and renamed local vars to not have _ postfix
• Added ability to filter pre-grasps as well
• Removed this-> because does not follow MoveIt style guidelines
• Made tests left/right invariant
• Refactored RobotGraspData and loader function
• Renamed RobotGraspData to GraspData
• Made graspDataLoader into a function the GraspData class.
• Move grasp data struct to separate file
• Fixed filter test
• Created left hand config for baxter
• Improved tests
• Changed deprecated function name
• Add options to grasp generation action goal.
• Yaml conversion
• Improved error handling of loading from yaml, removed unnecessary data
• Fixes for new grasp data loader
• Fixes per catkin_lintg
• Convert baxter_data.h to baxter_gripper.yaml
• Add launch script for grasp generator server + testing node
• Replace reem_data.h with reem_hand.yaml
• Add grasp_data_loader to be used by server.
• Changed way visualizations are made
• Moved the visualize grasp functionality to moveit_visual_tools. Deprecated generateAllGrasps
• Fixed grasp filter bug of pose in wrong frame of reference
• Trying to visualize arm reaches
• Fixed grasp filter
• Added new hand_roll feature
• Changed name of moveit_simple_grasps
• Renamed files and classes to not have the word MoveIt
• Added picture
• Added ability to do full grasp rotation, finer grained access, documentation
• Fix travis
• Changed name of moveit_visual_tools
• Initial commit
• Contributors: Bence Magyar, Dave Coleman, Jordi Pages