RED - Regularization by Denoising
Switch branches/tags
Nothing to show
Clone or download
sungjoonchoi Merge pull request #1 from mpoullet/master
Add reference to the published article.
Latest commit 1b303e0 Mar 29, 2018
Permalink
Failed to load latest commit information.
helper_functions Initial commit Jul 26, 2017
images Add teaser image Aug 12, 2017
minimizers Initial commit Jul 26, 2017
parameters Initial commit Jul 26, 2017
CONTRIBUTING.md Initial commit Jul 26, 2017
LICENSE Initial commit Jul 26, 2017
README.md Add reference to the published article. Mar 28, 2018
main.m Initial commit Jul 26, 2017

README.md

RED: version 1.0.0

Demonstration of the image restoration experiments conducted in Y. Romano, M. Elad, and P. Milanfar, "The Little Engine that Could: Regularization by Denoising (RED)", SIAM Journal on Imaging Sciences, 10(4), 1804–1844, 2017 [arXiv].

Examples

The code was tested on Windows 7 and Windows 10, with Matlab R2016a.

This is not an official Google product.

Quick start

  1. Clone or download this repository.
  2. Download a lightweight version of TNRD denoising from https://drive.google.com/file/d/0B9L0NyTobx_3NHdJLUtPQWJmc2c/view?usp=sharing.
  3. Unzip the file tnrd_denoising.zip (containing 7 files in total) to the folder located in YOUR_LOCAL_PATH/RED/tnrd_denoising.
  4. Download test images from https://drive.google.com/drive/folders/0BzCe024Ewz8aZ3pNQXNqYXJseTQ?usp=sharing and copy to the folder located in YOUR_LOCAL_PATH/RED/test_images.
  5. Open Matlab and change the current folder to YOUR_LOCAL_PATH/RED (use "cd" function).
  6. In Matlab's command window run
    >> main
    
    to start a demo.

Third-party software components needed

The code uses an image denoising algorithm called TNRD, described in Yunjin Chen, and Thomas Pock, "Trainable Nonlinear Reaction Diffusion: A Flexible Framework for Fast and Effective Image Restoration", IEEE TPAMI 2016. The TNRD code is available in the authors website http://www.escience.cn/people/chenyunjin and downloaded from https://www.dropbox.com/s/8j6b880m6ddxtee/TNRD-Codes.zip?dl=0.

Note1: For a fast execution, please enable "parfor" using Matlab command "matlabpool".

Note2: The TNRD software contains mex files. If you encounter problems when running the denoiser, try to download the TNRD code from the above dropbox link. Then, copy the files from the directory YOUR_LOCAL_PATH/TNRD-Codes/TestCodes(denoising-deblocking-SR)/GaussianDenoising to YOUR_LOCAL_PATH/RED/tnrd_denoising directory. If you are using mex files for the first time, please run the following in Matlab's command window:

>> mex -setup
You will see the following question:
"Would you like mex to locate installed compilers [y]/n?"
>> y
Now you should choose a compiler. Simply choose the first one by clicking
>> 1
Then verify by
>> y

The test images, used to degrade the image, are taken from on the NCSR software. For more details, please refer to Weisheng Dong, Lei Zhang, Guangming Shi, and Xin Li "Nonlocally Centralized Sparse Representation for Image Restoration", IEEE-TIP, 2013. The NCSR code is available in http://www4.comp.polyu.edu.hk/~cslzhang/NCSR.htm. Also, to have a fair comparison, we use a similar degradation process as done in NCSR.

Good luck!