Guided filter Light Field Cost Volume is a CUDA implementation of a disparity estimation algorithm for 4D light fields. It uses the guided filter on cost volume slices computed using the TAD C+G metric on 4D shears of the light field. Estimated disparity is calculated by an argmin on the filtered cost volume over a range of disparity values.
Results have been evaluated on the HCI 4D Light Field Benchmark.
This code is licensed under GNU GPL V3, with a commercial licence available on request. See the LICENSE file for the full license text.
Copyright (C) 2017 Adam Stacey
Install required libraries as per the last section in this README.
cd ./build
cmake ..
make
GLFCV can be run on a folder with the image formats as in the benchmark datasets or on an LFR or LFP lytro file with the calibration archive.
GLFCV <input>.LFR <white_image_folder> <output_folder>
GLFCV <light_field_folder> <output_dir>
Visualisations can be added by using the following functions, which are commented out in main.cpp.
decoder.DisplayLightFieldSlices();
decoder.DisplayLenslet();
decoder.WriteLensletImage();
cd ./build
./GLFCV ../data/cotton .
The following images are the results of GLFCV on the Cotton scene from the HCI benchmark. Left to right: central sub-aperture image, GLFCV disparity estimate, ground truth, GLFCV error vs ground truth.
cd ./build
./GLFCV ../data/IMG_0128.LFR ../data/caldata-B5155000720/ .
Download the cuda local .deb from NVIDIA (https://developer.nvidia.com/cuda-downloads)
sudo dpkg -i cuda*.deb
sudo apt update
sudo apt install cuda
export PATH=/usr/local/cuda-8.0.61/bin${PATH:+:${PATH}}
export LD_LIBRARY_PATH=/usr/local/cuda-8.0.61/lib64\ ${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}
git clone https://github.com/opencv/opencv.git
cd opencv
git checkout tags/3.2.0
mkdir build
Use cmake-gui or cmake to generate makefiles including with cuda, jpeg and qt5 and generate build files in the build directory
cd build
make -j7
sudo make install
sudo apt install libboost-all-dev
Download and run the installer from NVIDIA (https://developer.nvidia.com/cuda-downloads)
export PATH=/Developer/NVIDIA/CUDA-8.0/bin${PATH:+:${PATH}}
export DYLD_LIBRARY_PATH=/Developer/NVIDIA/CUDA-8.0/lib${DYLD_LIBRARY_PATH:+:${DYLD_LIBRARY_PATH}}
brew install opencv3 --with-contrib --with-cuda --with-qt5 --with-libtiff --with-eigen
Install boost 1.58 or higher
brew install boost
brew switch boost 1.58.0 # Some systems need 1.58.0 specifically