A complete end-to-end demonstration in which we collect training data in Unity and use that data to train a deep neural network to predict the pose of a cube. This model is then deployed in a simulated robotic pick-and-place task.
Перейти к файлу
Amanda 45156479be
Merge pull request #54 from Unity-Technologies/dev
AIRO-1654 Merge dev to main
2022-01-26 13:06:54 -08:00
.github fix code and doc styles 2021-10-27 14:10:46 -07:00
.yamato AIRO-1561 Add Sonarqube Scanner (#42) 2021-12-13 12:42:05 -08:00
Documentation fix code and doc styles 2021-10-27 14:10:46 -07:00
Model fix code and doc styles 2021-10-27 14:10:46 -07:00
PoseEstimationDemoProject fix code and doc styles 2021-10-27 14:10:46 -07:00
ROS move the model to device (#52) 2022-01-19 12:17:29 -08:00
docker add ubuntu key update for docker building 2021-06-02 11:02:06 -07:00
.gitignore New repo cleanup (#3) 2021-02-19 14:22:59 -07:00
.gitmodules Updated perception package version to 0.8.0: Lightweight tags (#26) 2021-04-07 14:49:18 -06:00
.pre-commit-config.yaml add jira link and pre commit check 2021-10-27 14:09:39 -07:00
CHANGELOG.md Updated changelog 2022-01-26 11:03:32 -08:00
CODE_OF_CONDUCT.md Contributing guidelines 2021-02-25 12:49:03 -07:00
CONTRIBUTING.md Link updates 2021-03-01 17:55:38 -07:00
LICENSE Remove license appendix (#7) 2021-02-26 14:43:31 -07:00
README.md fix code and doc styles 2021-10-27 14:10:46 -07:00
Third Party Notices.md fix code and doc styles 2021-10-27 14:10:46 -07:00

README.md

Object Pose Estimation Demo

License

This tutorial will go through the steps necessary to perform pose estimation with a UR3 robotic arm in Unity. Youll gain experience integrating ROS with Unity, importing URDF models, collecting labeled training data, and training and deploying a deep learning model. By the end of this tutorial, you will be able to perform pick-and-place with a robot arm in Unity, using computer vision to perceive the object the robot picks up.

Want to skip the tutorial and run the full demo? Check out our Quick Demo.

Want to skip the tutorial and focus on collecting training data for the deep learning model? Check out our Quick Data-Collection Demo.

Note: This project has been developed with Python 3 and ROS Noetic.

Table of Contents


This part includes downloading and installing the Unity Editor, setting up a basic Unity scene, and importing a robot. We will import the UR3 robot arm using the URDF Importer package.


This part focuses on setting up the scene for data collection using the Unity Computer Vision Perception Package. You will learn how to use Perception Package Randomizers to randomize aspects of the scene in order to create variety in the training data.

If you would like to learn more about Randomizers, and apply domain randomization to this scene more thoroughly, check out our further exercises for the reader here.


This part includes running data collection with the Perception Package, and using that data to train a deep learning model. The training step can take some time. If you'd like, you can skip that step by using our pre-trained model.

To measure the success of grasping in simulation using our pre-trained model for pose estimation, we did 100 trials and got the following results:

Success Failures Percent Success
Without occlusion 82 5 94
With occlusion 7 6 54
All 89 11 89

Note: Data for the above experiment was collected in Unity 2020.2.1f1.


This part includes the preparation and setup necessary to run a pick-and-place task using MoveIt. Here, the cube pose is predicted by the trained deep learning model. Steps covered include:

  • Creating and invoking a motion planning service in ROS
  • Sending captured RGB images from our scene to the ROS Pose Estimation node for inference
  • Using a Python script to run inference on our trained deep learning model
  • Moving Unity Articulation Bodies based on a calculated trajectory
  • Controlling a gripping tool to successfully grasp and drop an object.

Support

For questions or discussions about Unity Robotics package installations or how to best set up and integrate your robotics projects, please create a new thread on the Unity Robotics forum and make sure to include as much detail as possible.

For feature requests, bugs, or other issues, please file a GitHub issue using the provided templates and the Robotics team will investigate as soon as possible.

For any other questions or feedback, connect directly with the Robotics team at unity-robotics@unity3d.com.

More from Unity Robotics

Visit the Robotics Hub for more tutorials, tools, and information on robotics simulation in Unity!

License

Apache License 2.0