dexpoint-release

DexPoint: Generalizable Point Cloud Reinforcement Learning for Sim-to-Real Dexterous Manipulation, CoRL 2022

https://github.com/yzqin/dexpoint-release

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: arxiv.org
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.9%) to scientific vocabulary

Keywords

dexterous-manipulation pointcloud reinforcement-learning sim2real
Last synced: 6 months ago · JSON representation ·

Repository

DexPoint: Generalizable Point Cloud Reinforcement Learning for Sim-to-Real Dexterous Manipulation, CoRL 2022

Basic Info
Statistics
  • Stars: 76
  • Watchers: 2
  • Forks: 8
  • Open Issues: 1
  • Releases: 0
Topics
dexterous-manipulation pointcloud reinforcement-learning sim2real
Created almost 3 years ago · Last pushed almost 2 years ago
Metadata Files
Readme License Citation

README.md

DexPoint: Generalizable Point Cloud Reinforcement Learning for Sim-to-Real Dexterous Manipulation

[Project Page] [Paper] [Poster][ShapeNet Object Models]

DexPoint: Generalizable Point Cloud Reinforcement Learning for Sim-to-Real Dexterous Manipulation

Yuzhe Qin, Binghao Huang, Zhao-Heng Yin, Hao Su, Xiaolong Wang, CoRL 2022.

DexPoint is a novel system and algorithm for RL from point cloud. This repo contains the simulated environment and training code for DexPoint.

Teaser

Bibtex

@article{dexpoint, title = {DexPoint: Generalizable Point Cloud Reinforcement Learning for Sim-to-Real Dexterous Manipulation }, author = {Qin, Yuzhe and Huang, Binghao and Yin, Zhao-Heng and Su, Hao and Wang, Xiaolong}, journal = {Conference on Robot Learning (CoRL)}, year = {2022}, }

Installation

shell git clone git@github.com:yzqin/dexpoint-release.git cd dexart-release conda create --name dexpoint python=3.8 conda activate dexpoint pip install -e .

Download data file for the scene from Google Drive Link. Place the day.ktx at assets/misc/ktx/day.ktx.

shell pip install gdown gdown https://drive.google.com/uc?id=1Xe3jgcIUZm_8yaFUsHnO7WJWr8cV41fE

File Structure

  • dexpoint: main content for the environment, utils, and other staff needs for RL training.
  • assets: robot and object models, and other static files
  • example: entry files to learn how to use the DexPoint environment
  • docker: dockerfile that can create container to be used for headless training on server

Quick Start

Use DexPoint environment and extend it for your project

Run and explore the comments in the file below provided to familiarize yourself with the basic architecture of the DexPoint environment. Check the printed messages to understand the observation, action, camera, and speed for these environments.

The environment we used in the training of DexPoint paper can be found here in exampledexpointgrasping.py.

Training

Download the ShapeNet models from Google Drive can place it inside the following directory dexpoint-release/assets/shapenet/.

The DexPoint repo is using the same training code as DexArt and environment interface for RL training. Please check the training code here to train DexPoint with PPO.

Acknowledgements

We would like to thank the following people for making this project possible:

Example extension of DexPoint environment framework in other project

DexArt: Benchmarking Generalizable Dexterous Manipulation with Articulated Objects (CVPR 2023): extend DexPoint to articulated object manipulation.

From One Hand to Multiple Hands: Imitation Learning for Dexterous Manipulation from Single-Camera Teleoperation (RA-L 2022): use teleoperation for data collection in DexPoint environment.

Owner

  • Name: Yuzhe Qin
  • Login: yzqin
  • Kind: user
  • Location: La Jolla, CA
  • Company: UC San Diego

Citation (CITATION.cff)

cff-version: 1.2.0
message: "Thanks for using DexPoint. If you use this software, please cite it as below."
authors:
- family-names: "Qin"
  given-names: "Yuzhe"
- family-names: "Huang"
  given-names: "Binghao"
- family-names: "Yin"
  given-names: "Zhao-Heng"
- family-names: "Su"
  given-names: "Hao"
- family-names: "Wang"
  given-names: "Xiaolong"
title: "DexPoint"
version: 0.4.0
date-released: 2023-04-10
url: "https://github.com/yzqin/dexpoint_release"
preferred-citation:
  type: conference-paper
  title: "DexPoint: Generalizable Point Cloud Reinforcement Learning for Sim-to-Real Dexterous Manipulation"
  authors:
  - family-names: "Qin"
    given-names: "Yuzhe"
  - family-names: "Huang"
    given-names: "Binghao"
  - family-names: "Yin"
    given-names: "Zhao-Heng"
  - family-names: "Su"
    given-names: "Hao"
  - family-names: "Wang"
    given-names: "Xiaolong"
  booktitle: "Conference on Robot Learning"
  year: 2023
  start: 594
  end: 605
  organization: PMLR

GitHub Events

Total
  • Issues event: 3
  • Watch event: 21
  • Fork event: 2
Last Year
  • Issues event: 3
  • Watch event: 21
  • Fork event: 2

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 2
  • Total pull requests: 0
  • Average time to close issues: about 1 year
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 0
  • Average comments per issue: 1.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • Charlie0257 (2)
  • ZhaoRunyi (1)
  • Janebek (1)
  • wslgqq277g (1)
Pull Request Authors
  • ykwang20 (1)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

docker/Dockerfile docker
  • nvidia/cudagl 11.3.0-devel-ubuntu20.04 build
pyproject.toml pypi
setup.py pypi
  • gym ==0.25.2
  • imageio *
  • numpy *
  • open3d >=0.15.2
  • sapien ==2.1.0
  • torch >=1.11.0
  • transforms3d *