facebookresearch / hot3d

HOT3D: An egocentric dataset for 3D hand and object tracking
https://facebookresearch.github.io/hot3d/
Apache License 2.0
83 stars 12 forks source link

Add conversion code to the BOP format #12

Closed AnasIbrahim closed 2 months ago

AnasIbrahim commented 2 months ago

This PR contains 3 scripts to convert the HOT3D-Clips dataset from its native format to the BOP format. The BOP format had to be extended because the original format only included RGB and depth modalities. This extension made it possible to include a varying number of modalities (RGB, gray1, gray2) with separate annotations for each modality. The dataset has already been converted using these scripts and uploaded to the BOP website. These scripts went through several revisions, as the conversion process required multiple changes to adapt the dataset to the new standard format, which was initially not strictly defined and required frequent adjustments. The scripts in this PR are isolated and do not make any changes to the existing code in the repository.

The 3 Scripts are:

  1. hot3d_models_to_bop.py : Script that converts the 3D object (full) models from the GLTF format to the PLY format
  2. hot3d_models_eval_to_bop.py: Script to convert the eval object model
  3. hot3d_clips_to_bop_scenewise.py: Script to convert the dataset itself
facebook-github-bot commented 2 months ago

Hi @AnasIbrahim!

Thank you for your pull request and welcome to our community.

Action Required

In order to merge any pull request (code, docs, etc.), we require contributors to sign our Contributor License Agreement, and we don't seem to have one on file for you.

Process

In order for us to review and merge your suggested changes, please sign at https://code.facebook.com/cla. If you are contributing on behalf of someone else (eg your employer), the individual CLA may not be sufficient and your employer may need to sign the corporate CLA.

Once the CLA is signed, our tooling will perform checks and validations. Afterwards, the pull request will be tagged with CLA signed. The tagging process may take up to 1 hour after signing. Please give it that time before contacting us about it.

If you have received this in error or have any questions, please contact us at cla@meta.com. Thanks!

SeaOtocinclus commented 2 months ago

Thank you @AnasIbrahim,

facebook-github-bot commented 2 months ago

Thank you for signing our Contributor License Agreement. We can now accept your code for this (and any) Meta Open Source project. Thanks!

AnasIbrahim commented 2 months ago

I added the description and signed the license.

facebook-github-bot commented 2 months ago

@SeaOtocinclus has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

facebook-github-bot commented 2 months ago

@SeaOtocinclus has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

AnasIbrahim commented 2 months ago

@SeaOtocinclus I just made a trivial change to the argparse input parameters. To make it easier to automate the conversion on the BOP server.

facebook-github-bot commented 2 months ago

@SeaOtocinclus has imported this pull request. If you are a Meta employee, you can view this diff on Phabricator.

SeaOtocinclus commented 2 months ago

@AnasIbrahim Look good to me, I will merge.

facebook-github-bot commented 2 months ago

@SeaOtocinclus merged this pull request in facebookresearch/hot3d@1d766a303230837315d41e44120f41077a70ee8f.