Skip to content

Latest commit

 

History

History
156 lines (114 loc) · 6.9 KB

README.md

File metadata and controls

156 lines (114 loc) · 6.9 KB
Raw

VoxDet: Voxel Learning for Novel Instance Detection

Bowen Li, Jiashun Wang, Yaoyu Hu, Chen Wang, and Sebastian Scherer

NeurIPS'23 🌟 SpotLight 🌟

Abstract

Detecting unseen instances based on multi-view templates is a challenging problem due to its open-world nature. Traditional methodologies, which primarily rely on $2 \mathrm{D}$ representations and matching techniques, are often inadequate in handling pose variations and occlusions. To solve this, we introduce VoxDet, a pioneer 3D geometry-aware framework that fully utilizes the strong 3D voxel representation and reliable voxel matching mechanism. VoxDet first ingeniously proposes template voxel aggregation (TVA) module, effectively transforming multi-view 2D images into 3D voxel features. By leveraging associated camera poses, these features are aggregated into a compact 3D template voxel. In novel instance detection, this voxel representation demonstrates heightened resilience to occlusion and pose variations. We also discover that a $3 \mathrm{D}$ reconstruction objective helps to pre-train the 2D-3D mapping in TVA. Second, to quickly align with the template voxel, VoxDet incorporates a Query Voxel Matching (QVM) module. The 2D queries are first converted into their voxel representation with the learned 2D-3D mapping. We find that since the 3D voxel representations encode the geometry, we can first estimate the relative rotation and then compare the aligned voxels, leading to improved accuracy and efficiency. In addition to method, we also introduce the first instance detection benchmark, RoboTools, where 20 unique instances are video-recorded with camera extrinsic. RoboTools also provides 24 challenging cluttered scenarios with more than $9 \mathrm{k}$ box annotations. Exhaustive experiments are conducted on the demanding LineMod-Occlusion, YCB-video, and RoboTools benchmarks, where VoxDet outperforms various 2D baselines remarkably with faster speed. To the best of our knowledge, VoxDet is the first to incorporate implicit 3D knowledge for 2D novel instance detection tasks.

TODO

  • Open-source everything about VoxDet-official
  • Open-source Dataset toolkit
  • Open-source ROS interface of VoxDet
    • Here, also a small demo :)
  • Open-source all the other baseline raw results (will be made public after conference)
    • Here
    • You can use the raw results to verify the numbers in Table 1 and 2 in the paper.
    • There are demonstrations below on how to evaluate these results.

Requirements

This repo is tested under Python 3.7, PyTorch 1.7.1, Cuda 11.0, and mmcv==1.7.1.

Installation

Build your own env (not recommended, mmcv is hard to setup)

This repo is built based on mmdetection.

For evaluation, you also need modified bop_toolkit

You can use the following commands to create conda env with related dependencies.

conda create -n voxdet python=3.7 -y
conda activate voxdet
pip install torch==1.7.1+cu110 torchvision==0.8.2+cu110 torchaudio==0.7.2 -f https://download.pytorch.org/whl/torch_stable.html
export CUDA_HOME=/usr/local/cuda
pip install mmcv-full==1.7.1
git clone https://github.com/Jaraxxus-Me/VoxDet.git
cd VoxDet
pip install -r requirements.txt
pip install -v -e . 

cd ..
git clone https://github.com/Jaraxxus-Me/bop_toolkit.git
cd bop_toolkit
pip install -e .

Docker (Strongly recommended)

docker pull bowenli1024/voxdet:ros-v1

In side the docker image:

git clone https://github.com/Jaraxxus-Me/VoxDet.git
cd VoxDet
pip install -v -e .
cd ..
git clone https://github.com/Jaraxxus-Me/bop_toolkit.git
cd bop_toolkit
pip install -e .

Prepare datasets

We provide the processed OWID, LM-O, YCB-V and RoboTools to reproduce the evaluation.

You can download them and creat data structure like this:

VoxDet
├── mmdet
├── tools
├── configs
├── data
│   ├── BOP
│   │   ├── lmo
|   |   |   ├── test
|   |   |   ├── test_video
│   │   ├── ycbv
│   │   ├── RoboTools
│   ├── OWID
│   │   ├── P1
│   │   ├── P2

You can also compile your custom instance detection dataset using this toolkit, it is very useful :)

Training

Our training set OWID has been released, we provide the code and script here:

# Single-GPU training for the reconstruction stage
bash tools/train.sh

# Multi-GPU training for the base detection, this should already produce the results close to table 1
bash tools/train_dist.sh

# Optional, use ground truth rotation for supervision for (slightly) better result, see table 4 for details
bash tools/train_dist_2.sh

Note: The train_dist.sh may consume a lot of CPU memory (~150GB), make sure you have enough RAM to avoid OOM problems.

Testing

Our trained models and raw results for all the stages are available for download.

Place it under outputs/ and run the following commands to test VoxDet on LM-O and YCB-V datasets.

bash tools/test.sh

By default, the script will only calculate results from the raw .pkl files, to actually run VoxDet, you need to change the output file name in the command like

# lmo
python3 tools/test.py --config configs/voxdet/${CONFIG}.py --out outputs/$OUT_DIR/lmo1.pkl \
--checkpoint outputs/VoxDet_p2_2/iter_100.pth >> outputs/$OUT_DIR/lmo1.txt

The results will be shown in the .txt file.

Evaluation

With the raw_result [Method].pkl, you can directly evaluate them and get the numbers in Table 1 and Table 2 without running the inference again.

# change line 171 in VoxDet_test.py for other datasets
# For example, output the evaluation results for OLN_Corr.
python3 tools/eva_only.py --config configs/voxdet/VoxDet_test.py --out baselines/lmo/oln_corr.pkl

Reference

If our work inspires your research, please cite us as:

@INPROCEEDINGS{Li2023vox,     
	author={Li, Bowen and Wang, Jiashun and Hu, Yaoyu and Wang, Chen and Scherer, Sebastian},   
	booktitle={Proceedings of the Advances in Neural Information Processing Systems (NeurIPS)}, 
	title={{VoxDet: Voxel Learning for Novel Instance Detection}},
	year={2023},
	volume={},
	number={}
}