1 /*
2 #
3 # File : use_nlmeans.cpp
4 # ( C++ source file )
5 #
6 # Description : Example of use for the CImg plugin 'plugins/nlmeans.h'.
7 # This file is a part of the CImg Library project.
8 # ( http://cimg.eu )
9 #
10 # Copyright : Jerome Boulanger
11 # ( http://www.irisa.fr/vista/Equipe/People/Jerome.Boulanger.html )
12 #
13 # Benchmark : (CPU intel pentium 4 2.60GHz) compiled with cimg_debug=0.
14 # patch lambda* alpha T sigma PSNR
15 # 3x3 15 9x9 3.6s 20 28.22
16 # 5x5 17 15x15 22.2s 20 27.91
17 # 7x7 42 21x21 80.0s 20 28.68
18 #
19 # License : CeCILL v2.0
20 # ( http://www.cecill.info/licences/Licence_CeCILL_V2-en.html )
21 #
22 # This software is governed by the CeCILL license under French law and
23 # abiding by the rules of distribution of free software. You can use,
24 # modify and/ or redistribute the software under the terms of the CeCILL
25 # license as circulated by CEA, CNRS and INRIA at the following URL
26 # "http://www.cecill.info".
27 #
28 # As a counterpart to the access to the source code and rights to copy,
29 # modify and redistribute granted by the license, users are provided only
30 # with a limited warranty and the software's author, the holder of the
31 # economic rights, and the successive licensors have only limited
32 # liability.
33 #
34 # In this respect, the user's attention is drawn to the risks associated
35 # with loading, using, modifying and/or developing or reproducing the
36 # software by the user in light of its specific status of free software,
37 # that may mean that it is complicated to manipulate, and that also
38 # therefore means that it is reserved for developers and experienced
39 # professionals having in-depth computer knowledge. Users are therefore
40 # encouraged to load and test the software's suitability as regards their
41 # requirements in conditions enabling the security of their systems and/or
42 # data to be ensured and, more generally, to use and operate it in the
43 # same conditions as regards security.
44 #
45 # The fact that you are presently reading this means that you have had
46 # knowledge of the CeCILL license and that you accept its terms.
47 #
48 */
49
50 #define cimg_plugin "plugins/nlmeans.h"
51 #include "CImg.h"
52 using namespace cimg_library;
53 #ifndef cimg_imagepath
54 #define cimg_imagepath "img/"
55 #endif
56
57 // Main procedure
58 //----------------
main(int argc,char ** argv)59 int main(int argc,char **argv) {
60
61 // Read command line argument s
62 //-----------------------------
63 cimg_usage("Non-local means denoising algorithm.\n [1] Buades, A. Coll, B. and Morel, J.: A review of image "
64 "denoising algorithms, with a new one. Multiscale Modeling and Simulation: A SIAM Interdisciplinary "
65 "Journal 4 (2004) 490-530 \n [2] Gasser, T. Sroka,L. Jennen Steinmetz,C. Residual variance and residual "
66 "pattern nonlinear regression. Biometrika 73 (1986) 625-659 \n Build : ");
67
68 // input/output and general options
69 const char *file_i = cimg_option("-i",cimg_imagepath "milla.bmp","Input image");
70 const char *file_o = cimg_option("-o",(char*)NULL,"Output file");
71 const double zoom = cimg_option("-zoom",1.0,"Image magnification");
72 const double noiseg = cimg_option("-ng",0.0,"Add gauss noise before aplying the algorithm");
73 const double noiseu = cimg_option("-nu",0.0,"Add uniform noise before applying the algorithm");
74 const double noises = cimg_option("-ns",0.0,"Add salt&pepper noise before applying the algorithm");
75 const unsigned int visu = cimg_option("-visu",1,"Visualization step (0=no visualization)");
76
77 // non local means options
78 const int patch_size = cimg_option("-p",1,"Half size of the patch (2p+1)x(2p+1)");
79 const float lambda = (float)cimg_option("-lambda",-1.0f,"Bandwidth as defined in [1] (-1 : automatic bandwidth)");
80 const double sigma = cimg_option("-sigma",-1,"Noise standard deviation (-1 : robust estimation)");
81 const int alpha = cimg_option("-alpha",3,"Neighborhood size (3)");
82 const int sampling = cimg_option("-sampling",1,"Sampling of the patch (1: slow, 2: fast)");
83
84 // Read image
85 //------------
86 CImg<> img;
87 if (file_i) {
88 img = CImg<>(file_i);
89 if (zoom>1)
90 img.resize((int)(img.width()*zoom),(int)(img.height()*zoom),(int)(img.depth()*zoom),-100,3);
91 } else throw CImgException("You need to specify at least one input image (option -i)");
92 CImg<> original=img;
93
94 // Add some noise
95 //-----------------
96 img.noise(noiseg,0).noise(noiseu,1).noise(noises,2);
97
98 // Apply the filter
99 //---------------------
100 cimg_uint64 tic = cimg::time();
101 CImg<> dest;
102 dest = img.get_nlmeans(patch_size,lambda,alpha,sigma,sampling);
103 cimg_uint64 tac = cimg::time();
104
105 // Save result
106 //-----------------
107 if (file_o) dest.cut(0,255.f).save(file_o);
108
109 // Display (option -visu)
110 //-----------------------
111 if (visu){
112 fprintf(stderr,"Image computed in %f s \n",(float)(tac - tic)/1000.);
113 fprintf(stderr,"The pnsr is %f \n",
114 20.*std::log10(255./std::sqrt( (dest - original).pow(2).sum()/original.size() )));
115 if (noiseg==0 && noiseu==0 && noises==0)
116 CImgList<>(original,dest,((dest - original)*=2)+=128).display("Original + Restored + Estimated Noise");
117
118 else {
119 CImgList<>(original,img,dest,((dest - img)*=2)+=128,((dest - original)*=2)+=128).
120 display("Original + Noisy + Restored + Estimated Noise + Original Noise");
121 }
122 }
123
124 return 0;
125 }
126