DarlingHang / radiance_field_propagation

[NeurIPS 2022] Unsupervised Multi-View Object Segmentation Using Radiance Field Propagation
https://xinhangliu.com/nerf_seg
MIT License
13 stars 2 forks source link

Unsupervised Multi-View Object Segmentation Using Radiance Field Propagation

Project page | Paper

This repository contains a PyTorch implementation for NeurIPS 2022 paper: Unsupervised Multi-View Object Segmentation Using Radiance Field Propagation. Our work present one of the first unsupervised approaches for tackling 3D real scene object segmentation for neural radiance field (NeRF) without any supervision, annotations, or other cues such as 3D bounding boxes and prior knowledge of object class.

Installation

Tested on Ubuntu 22.04 + Pytorch 1.13.0

Install environment:

conda create -n nerf_seg python=3.8
conda activate nerf_seg
conda install pytorch torchvision torchaudio pytorch-cuda=11.7 -c pytorch -c nvidia
pip install tqdm scikit-image opencv-python configargparse lpips imageio-ffmpeg kornia lpips tensorboard

Data Preparation

Please download the following datasets and remember to set correct data path in configs.

Our method relies on unsupervised single image segmentation algorithms to get good initialization. Recommended methods are iem and ReDO. We provide a set of initial labels here.

Please the data folder as follows:

<case_name>
|-- poses_bounds.npy         # camera parameters
|-- images_4
    |-- image000.png        # target image for each view
    |-- image001.png
    ...
|-- masks
    |-- image000.png        # target mask for each view
    |-- image001.png
    ...

Quick Start

The training script is in train.py, to train our method on a scene in the LLFF dataset:

python train.py --config configs/fortress.txt

TODO

Acknowlegements

Thanks TensoRF, semantic_nerf, and st-nerf for providing awesome open source libraries.

Citation

If you find our code or paper helps, please consider citing:

@inproceedings{liu2022unsupervised,
    title={Unsupervised Multi-View Object Segmentation Using Radiance Field Propagation},
    author={Liu, Xinhang and Chen, Jiaben and Yu, Huai and Tai, Yu-Wing and Tang, Chi-Keung},
    booktitle={Advances in Neural Information Processing Systems},
    volume = {35},
    url = {https://arxiv.org/pdf/2210.00489.pdf},
    year={2022}
    }