Edge Guided Single Depth Image Super-resolution
Matlab C++ C Objective-C Makefile M
Switch branches/tags
Nothing to show
Clone or download
ClaireXie Update README.md
Fix a typo on self_similarity flag.
Latest commit be9f254 Mar 7, 2017
Permalink
Failed to load latest commit information.
dictionaries modify comments May 20, 2016
funcs modify comments May 20, 2016
inputs first commit Sep 13, 2014
mainCode modify comments May 20, 2016
mexFunctions modify comments May 20, 2016
utils/UGM change folder structure Oct 9, 2014
.gitignore clean up code May 20, 2016
LICENSE add license Nov 22, 2015
README.md Update README.md Mar 7, 2017
compileFiles.m modify comments May 20, 2016
demoFramework.m modify comments May 20, 2016
runBatch.m modify comments May 20, 2016
trainingScript.m clean up code May 20, 2016

README.md

EdgeGuided SDSP

Edge Guided Single Depth Image Super-resolution

This code implements the approach for super resolution with a single depth image input in this paper. For more details, please refer to the project page.

If you intend to use the source code, please cite the paper as follows:

Jun Xie, Rogerio S. Feris and Ming-Ting Sun, "Edge-Guided Single Depth Image Super Resolution," 
in IEEE Transactions on Image Processing, vol. 25, no. 1, pp. 428-438, Jan. 2016.

Dependences

  1. UGM toolbox (http://www.cs.ubc.ca/~schmidtm/Software/UGM.html), included in the utils/ folder. Please also cite its related work in order to use the toolbox. Remember to compile the toolbox before going to the next step.

  2. ANN (https://www.cs.umd.edu/~mount/ANN/), optional for a more efficient k-nearest neighbor search implementation. The source code of ANN is included in funs/ANN/. We have provided with a Matlab wrapper for ANN library. This feature is enabled by default. To disable it, simply set the flag in mainCode/mrfLearning.m from

    useANN = 1; => useANN = 0;
    
  3. Download the trained dictionary:

    (If you only intend to run the self-similarity part, just ignore this step.)

    Dictionary with upscaling factor = 3 [~167MB]

    Dictionary with upscaling factor = 4 [~75MB]

How to Use the Code

  1. Run compileFiles.m to compile all the necessary mex files. (Pre-built mex for Windows and Linux are included)

  2. demoFramework.m is a simple demo script. runBatch.m is the batch script to run a couple of images.

  3. Some example input depth images are included in inputs/

  4. If you intend to do the training on your own, with the collected image data, use trainingScript.m. We use the training images from http://visual.cs.ucl.ac.uk/pubs/depthSuperRes/. After getting the images, please modify the data directory in trainingScript.m.

  5. You can switch to the self-similarity mode (without the training data), change from

    self_similarity = 0; => self_similarity = 1;
    

    in runBatch.m/demoFramework.m

Note: The code has been tested under 64bit Linux and Windows platform with Matlab 2014b/2015a installed.

Depth Super-resolution Results

Please note that the quantitative evaluation result in this version is slightly lower than that was reported in the paper since we utilize some code optimization for efficiency concerns in this version.

Please feel free to contact xjsjtu88@gmail.com for any questions or bug reports.

Change Logs

2016-05-19: Add the self-similarity code, remove dictionary from repo to server