CVLAB-Unibo / neural-disparity-refinement

Other
46 stars 4 forks source link

Neural Disparity Refinement for Arbitrary Resolution Stereo

Best Paper Honorable Mention 3DV 2021

Filippo Aleotti, Fabio Tosi, Pierluigi Zama Ramirez*, Matteo Poggi, Samuele Salti, Stefano Mattoccia, Luigi Di Stefano

*Equal Contribution

#

Alt text

This repository contains a Pytorch implementation of: "Neural Disparity Refinement for Arbitrary Resolution Stereo". 3DV 2021

Contributions:

For more details, please check:

[Project Page] [Paper&Supplementary]

If you find this code useful in your research, please cite:

@inproceedings{aleotti2021neural,
    title={Neural Disparity Refinement for Arbitrary Resolution Stereo},
    author={Aleotti, Filippo and Tosi, Fabio and Zama Ramirez, Pierluigi and Poggi, Matteo and Salti, Samuele and Di Stefano, Luigi and Mattoccia, Stefano},
    booktitle={International Conference on 3D Vision},
    note={3DV},
    year={2021},
}

Requirements

This code was tested with Python 3.8, Pytotch 1.8.1, CUDA 11.1 and Ubuntu 20.04.
All our experiments were performed on a single NVIDIA RTX 3090 GPU.
Requirements can be installed using the following script:

pip install -r requirements.txt

Inference

Use the following command to refine an input noisy disparity map (rgb also required).

python apps/inference.py --load_checkpoint_path $ckpt \
                         --backbone $backbone \
                         --results_path $results_path \
                         --upsampling_factor $upsampling_factor \
                         --results_path $results_path \
                         --max_disp $max_disp \
                         --disp_scale $disp_scale \
                         --downsampling_factor $downsampling_factor \
                         --rgb $rgb \
                         --disparity $disparity

You can run on input images contained in the sample folder using:

bash inference.sh

Pretrained models

You can download pre-trained models on our UnrealStereo4K dataset from the following links:

Note on training code

Training code will not be released due to licence terms and conditions.

Contacts

For questions, please send an email to filippo.aleotti2@unibo.it or fabio.tosi5@unibo.it or pierluigi.zama@unibo.it

Acknowledgements

We gratefully acknowledge the funding support of Huawei Technologies Oy (Finland).