Skip to content

This repository is a fork of the Dex-Net gcqcnn repository. It is adjusted such that 3D user input can be used to guide Dex-Net's grasp pose prediction.

License

Notifications You must be signed in to change notification settings

vladislav-klass/Dex-Net-with-user-input

Repository files navigation

A Weakly-supervised Labeling Approach for Robotic Grasp Teaching and its Effects on Grasp Quality and Operator's Human Factors

This is the supporting material for the paper "A Weakly-supervised Labeling Approach for Robotic Grasp Teaching and its Effects on Grasp Quality and Operator's Human Factors". Within this repo the code used for fusing the user input together with Dex-Net is provided. Moreover,supplementary materials (i.e., figures, example of test objects) are provided. If you find this work useful please consider citing it.

In this video we demonstrate how our approach outperforms a state of the art grasp pose prediction approach (Dex-Net) in an exemplary grasp task:

Robotic Grasp Pose Prediction with User Input

Installation

[DISCLAIMER] Prerequisites for Dex-Net

This repo is a fork of the Berkeley AUTOLAB's dex-net GQ-CNN. Therefore, here we focus only on the modifications for fusing the user input.For Dex-Net documentation and code see [1], [2], and [3]. Dex-Net general information can be find in:

@article{mahler2019learning,
    title={Learning ambidextrous robot grasping policies},
    author={Mahler, Jeffrey and Matl, Matthew and Satish, Vishal and Danielczuk, Michael and DeRose, Bill and McKinley, Stephen and Goldberg, Ken},
    journal={Science Robotics},
    volume={4},
    number={26},
    pages={eaau4984},
    year={2019},
    publisher={AAAS}
}

Prerequisites

The package has only been tested with Python 3.7 on Ubuntu 16.04. We recommend using a Python environment management system, in particular Virtualenv.

virtualenv -p /usr/bin/python3.7 ~/virtualenv/dex-net-user-input
source ~/virtualenv/dex-net-user-input/bin/activate

1. Clone the repository

Clone or download the project from Github.

git clone https://github.com/matteopantano/Dex-Net-userInput

2. Run pip installation

Change directories into the gqcnn repository and run the pip installation.

pip install .

This will install gqcnn in your current virtual environment.

Inference

With the virtualenv activated, run from the gqcnn directory execute:

./run_DexNet_with_user_input_example.sh

You can adjust the parameters defined in the shell script to point to your own data.

Note that segmask, config_filename and user_input_fusion_method are optional parameters.

If user_input_fusion method is provided, also camera_pose_path, user_input_3d_dir must be provided

Useful material

The objects used for the evaluation are stored under in data/objects and are divided upon object for virtual evaluation and physical evaluation. For sake of clarity some figures are reported here:

Virtual evaluation

drawing

Physical evaluation

drawing

Contributors

Reference

@software{pantano2022weaklysupervised,
    title={A Weakly-supervised Labeling Approach for Robotic Grasp Teaching and its Effects on Grasp Quality and Operator's Human Factors},
    author = {Matteo Pantano and Vladislav Klass},
    title = {Fusing of the user input in Dex-Net},
    url = {https://github.com/matteopantano/Dex-Net-userInput},
    version = {1.0},
    date = {2022-09-12},
}

About

This repository is a fork of the Dex-Net gcqcnn repository. It is adjusted such that 3D user input can be used to guide Dex-Net's grasp pose prediction.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published