Open In Github
Python scripts for performing 6D pose estimation and shape reconstruction using the CenterSnap model in ONNX
Important
- The original model has not been officially released, therefore, there might be changes to the official model later on.
- The examples seem to not properly work when using a camera other than the one in the original dataset. This is probably due to an implementation mistake on this repository, if you find the issue, please submit an issue or PR.
- The model only works with the following objects (the objects avaialble in the training dataset): bottle, bowl, camera, can, laptop, and mug.
Requirements
- Check the requirements.txt file.
- Additionally depthai library is necessary for testing with OAK-D boards. Check the example below for how to install it.
- Similarly, you will need to commit the pyKinectAzure repository to run the example with the Azure Kinect. Check the example below for how to install it.
Installation
1
pip install -r requirements.txt
ONNX model
Download the models from here and here, and place them in the models folder. For converting the original Pytorch model to ONNX, check the following branch: https://github.com/ibaiGorordo/CenterSnap/tree/convert_onnx
How to use
The model returns multiple outputs (segmentation map, heat map, 3D position…), here is a short explanation on how to run these examples. For the image examples, you will need to download the data from the original source: https://www.dropbox.com/s/yfenvre5fhx3oda/nocs_test_subset.tar.gz
- Image Segmentation map:
1
python image_draw_semantic_map.py
- Image heatmap:
1
python image_draw_heatmap.py
- Image depth map (Same as input):
1
python image_draw_depth.py
- Image projected 3D pose:
1
python image_draw_pose2d.py
- Image 3D pose:
1
python image_draw_pose3d.py
- OAK-D 3D pose:
First, install the depthai library: pip install depthai
1
python depthai_draw_pose3d.py
- Realsense 3D pose:
First, install the pyrealsense2 library: pip install pyrealsense2
1
python realsense_draw_pose3d.py
Azure Kinect 3D pose:
- First, install the Azure Kinect SDK: https://docs.microsoft.com/en-us/azure/kinect-dk/sensor-sdk-download
- Clone the pyKinectAzure repository inside this repository:
git clone https://github.com/ibaiGorordo/pyKinectAzure.git
1
python kinect_draw_pose3d.py
References
- CenterSnap: https://github.com/zubair-irshad/CenterSnap
- Original paper: https://arxiv.org/abs/2203.01929
- Modified CenterSnap for conversion: https://github.com/ibaiGorordo/CenterSnap/tree/convert_onnx
- Depthai library: https://github.com/luxonis/depthai-python
- PyRealsense2 library: https://github.com/IntelRealSense/librealsense
- pyKinectAzure: https://github.com/ibaiGorordo/pyKinectAzure