TNLMeans - Revision history

Reel.Deal: v1.1 update

2021-04-11T09:07:00Z

v1.1 update

Reel.Deal: add x64 version and archived downloads

2020-05-24T02:18:09Z

add x64 version and archived downloads

Groucho2004 at 09:56, 15 February 2019

2019-02-15T09:56:20Z

Groucho2004: /* Description */

2019-02-15T09:53:44Z

‎Description

Yakub2.X at 22:49, 24 June 2018

2018-06-24T22:49:27Z

Reel.Deal: /* Theory Of Operation: */ add links

2016-03-07T00:10:01Z

‎Theory Of Operation:: add links

Reel.Deal: TNLMeans ICL10 archive.org link

2016-02-27T13:17:57Z

TNLMeans ICL10 archive.org link

Reel.Deal: archived link

2016-02-14T02:22:27Z

archived link

Reel.Deal: TNLMeans

2015-11-28T13:04:17Z

TNLMeans

Raffriff42: redirect for convenient searching

2015-11-08T01:29:39Z

redirect for convenient searching

New page

#REDIRECT [[External_filters#Denoisers]]
{{FilterCat|External_filters|Denoisers|}}

@@ Line 1: / Line 1: @@
-{{FilterCat5|External_filters|Plugins|Plugins_x64|Denoisers|Spatial-Temporal Denoisers}}
+{{FilterCat6|External_filters|Plugins|Plugins_x64|Denoisers|Spatial-Temporal Denoisers|Deep_color_tools}}
 {{Filter3
-|{{Author/tritical}}
+|1={{Author/tritical}}, {{Author/pinterf}}
-|1.0.3
+|2=1.1
+|3=[https://github.com/pinterf/TNLMeans/releases TNLMeans_v1.1.7z]
-=[x86]: [https://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
-------------
-[x86 & x64]: [https://web.archive.org/web/20200522181545if_/https://files.videohelp.com/u/223002/TNLMeans103_ICL.7z TNLMeans103_ICL.7z]
 |4=Spatial-Temporal Denoisers
 |5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
@@ Line 16: / Line 13: @@
 [[TNLMeans]] is an implementation of the [http://en.wikipedia.org/wiki/Non-local_means NL-means denoising algorithm]. Aside from the original method, [[TNLMeans]] also supports extension into 3D, a faster, block based approach, and a multiscale version.
-*<tt>TNLMeans103_ICL.7z</tt> is an optimized build compiled with Intel C++ Compiler. It includes [[SSE2]] and [[SSE4.2]] optimized binaries (32 and 64-bit).
+* Filter reports itself as [[MT_MULTI_INSTANCE]] under AviSynth+.
 <br>
 == Requirements ==
-* [x86] [[AviSynth+]] or [http://sourceforge.net/projects/avisynth2/ AviSynth 2.5.8 or greater]
+* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0]
-* [x64] [[AviSynth+]]
+* [x64]: [[AviSynth+]]
-* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
+* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], [[YUY2]]
-* Supported color formats: [[YUY2]], [[YV12]]
+** AviSynth+: All [[planar]] formats (8/10/12/14/16-bit, Y, YUV(A), and RGB(A) with or without alpha) are supported.
 <br>
@@ Line 56: / Line 52: @@
 <br>
 ::{{Par2| |clip| }}
-:::Input clip.
+:::Input clip; filter works all 8-16 bits Y and planar YUV/RGB color spaces and YUY2.
 <br>
 ::{{Par2|Ax|int|4}}
@@ Line 107: / Line 104: @@
 == Changelog ==
   Version          Date(D/M/Y)      Changes<br>
   v1.0.3           08/28/2007       - Removed fast exp() approximation that was used for sse=false. Turns out it was
                                       quite inaccurate and had overflow problems resulting in artifacts.<br>
@@ Line 135: / Line 142: @@
 |-
 !v1.0.3
 |[http://web.archive.org/web/20140420182218/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
 |}
 * x86/x64 version compiled by [https://forum.doom9.org/showthread.php?t=173259 Groucho2004].
 <br>
 == External Links ==
 *[http://github.com/VFR-maniac/VapourSynth-TNLMeans GitHub] - VapourSynth port of TNLMeans.
 <br>
 -----------------------------------------------
 '''Back to [[External_filters#Spatio-Temporal_Denoisers| External Filters]] &larr;'''

@@ Line 1: / Line 1: @@
-{{FilterCat4|External_filters|Plugins|Denoisers|Spatial-Temporal Denoisers}}
+{{FilterCat5|External_filters|Plugins|Plugins_x64|Denoisers|Spatial-Temporal Denoisers}}
 {{Filter3
 |{{Author/tritical}}
 |1.0.3
+|
-=[http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
+=[x86]: [https://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
-[http://www.iol.ie/~schubert/gas/gas.html TNLMeans 1.0.3 (x86 & x64)] <!--[http://www.sendspace.com/file/6k226c]-->
+------------
 |4=Spatial-Temporal Denoisers
 |5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
@@ Line 15: / Line 16: @@
 [[TNLMeans]] is an implementation of the [http://en.wikipedia.org/wiki/Non-local_means NL-means denoising algorithm]. Aside from the original method, [[TNLMeans]] also supports extension into 3D, a faster, block based approach, and a multiscale version.
-*<tt>TNLMeans_ICL.7z</tt> is an optimized build compiled with Intel C++ Compiler 10, see [https://forum.doom9.org/showthread.php?t=173259 discussion] for more details.
+*<tt>TNLMeans103_ICL.7z</tt> is an optimized build compiled with Intel C++ Compiler. It includes [[SSE2]] and [[SSE4.2]] optimized binaries (32 and 64-bit).
 <br>
 == Requirements ==
-* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
+* [x86] [[AviSynth+]] or [http://sourceforge.net/projects/avisynth2/ AviSynth 2.5.8 or greater]
 * [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
 * Supported color formats: [[YUY2]], [[YV12]]
@@ Line 127: / Line 129: @@
 !!width="150px"| Download
 !!width="150px"| Mirror
 |-
 !v1.0.3
@@ Line 132: / Line 138: @@
 |[http://web.archive.org/web/20140420182218/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
 |}
+* x86/x64 version compiled by [https://forum.doom9.org/showthread.php?t=173259 Groucho2004].
 <br>
 == External Links ==
 *[http://github.com/VFR-maniac/VapourSynth-TNLMeans GitHub] - VapourSynth port of TNLMeans.
 <br>
 -----------------------------------------------
 '''Back to [[External_filters#Spatio-Temporal_Denoisers| External Filters]] &larr;'''

@@ Line 5: / Line 5: @@
+|
 =[http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
-[http://web.archive.org/web/20160224092631/https://filetea.me/t1sw6hYQVQbSbG4DGPuojmb9g/dl TNLMeans_ICL.7z] <!--[http://www.sendspace.com/file/6k226c]-->
+[http://www.iol.ie/~schubert/gas/gas.html TNLMeans 1.0.3 (x86 & x64)] <!--[http://www.sendspace.com/file/6k226c]-->
 |4=Spatial-Temporal Denoisers
 |5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]

@@ Line 15: / Line 15: @@
 [[TNLMeans]] is an implementation of the [http://en.wikipedia.org/wiki/Non-local_means NL-means denoising algorithm]. Aside from the original method, [[TNLMeans]] also supports extension into 3D, a faster, block based approach, and a multiscale version.
-*<tt>TNLMeans_ICL.7z</tt> is an optimized build compiled with Intel C++ Compiler 10, see [http://forum.doom9.org/showthread.php?t=168090 discussion] for more details.
+*<tt>TNLMeans_ICL.7z</tt> is an optimized build compiled with Intel C++ Compiler 10, see [https://forum.doom9.org/showthread.php?t=173259 discussion] for more details.
 <br>
 == Requirements ==
 * AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]

@@ Line 11: / Line 11: @@
 }}
 == Description ==
 [[TNLMeans]] is an implementation of the [http://en.wikipedia.org/wiki/Non-local_means NL-means denoising algorithm]. Aside from the original method, [[TNLMeans]] also supports extension into 3D, a faster, block based approach, and a multiscale version.
 *<tt>TNLMeans_ICL.7z</tt> is an optimized build compiled with Intel C++ Compiler 10, see [http://forum.doom9.org/showthread.php?t=168090 discussion] for more details.
 == Requirements ==
 * AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
 * [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
 * Supported color formats: [[YUY2]], [[YV12]]
 <br>
 ==Theory Of Operation:==
@@ Line 45: / Line 47: @@
 *[http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/nl2.pdf A non-local algorithm for image denoising]
 *[http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/nl3.pdf Denosing image sequences does not require motion estimation]
 == [[Script variables|Syntax and Parameters]] ==
 :{{Template:FuncDef|TNLMeans (clip, int "Ax", int "Ay", int "Az", int "Sx", int "Sy", int "Bx", int "By", bool "ms", int "rm", float "a", float "h", bool "sse")}}
@@ Line 92: / Line 94: @@
 :::*true - use sse
 :::*false - use sad
 == Examples ==
 TNLMeans with all default settings:
   [[AviSource]]("Blah.avi")
   TNLMeans(Ax=4, Ay=4, Az=0, Sx=2, Sy=2, Bx=1, By=1, ms=false, rm=4, a=1.0, h=1.8, sse=true)
 <br>
 == Changelog ==
@@ Line 115: / Line 118: @@
                                     - Changed defaults for ax/ay/sx/sy/h<br>
   v1.0 Beta 1      05/17/2006       - Initial Release
 <br>
 == Archived Downloads ==
@@ Line 127: / Line 131: @@
 |[http://web.archive.org/web/20140420182218/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
 |}
 <br>
 == External Links ==
 *[http://forum.doom9.org/showthread.php?t=168090 Doom9 Forum] - TNLMeans 1.0.3 built with ICL10.
 *[http://github.com/VFR-maniac/VapourSynth-TNLMeans GitHub] - VapourSynth port of TNLMeans.
-<br>
 <br>
 -----------------------------------------------
 '''Back to [[External_filters#Spatio-Temporal_Denoisers| External Filters]] &larr;'''

@@ Line 40: / Line 40: @@
 The multiscale version works by running the normal algorithm with Ax/Ay = 2 on the original image, and then running the algorithm again on a downsampled (width/2,height/2) version of the original image with Ax/Ay/Bx/By/Sx/Sy all divided by 2.  The weights from the two scales are then combined to form the final image.  This process can greatly speed up processing for large search windows but sacrifices quality (especially around edges/lines/fine details). The type of downsampling that is used is set by the 'rm' parameter.
-More information can be found by following the links to papers about NL-means under the TNLMeans portion of http://bengal.missouri.edu/~kes25c/.
+For more information see the following papers:
-<br>
 <br>
 == [[Script variables|Syntax and Parameters]] ==
 :{{Template:FuncDef|TNLMeans (clip, int "Ax", int "Ay", int "Az", int "Sx", int "Sy", int "Bx", int "By", bool "ms", int "rm", float "a", float "h", bool "sse")}}

@@ Line 4: / Line 4: @@
 |1.0.3
+|
-=[http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
+=[http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
 [http://www.sendspace.com/file/6k226c TNLMeans_ICL.7z]
 |4=Spatial-Temporal Denoisers
@@ Line 120: / Line 120: @@
 |-
 !v1.0.3
-|[http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
+|<strike>[http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]</strike>
 |[http://web.archive.org/web/20140420182218/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
 |}

← Older revision		Revision as of 13:04, 28 November 2015
Line 1:		Line 1:
−	~~#REDIRECT~~ [[~~External_filters#~~Denoisers]]	+	{{FilterCat4\|External_filters\|Plugins\|Denoisers\|Spatial-Temporal Denoisers}}
−	{{~~FilterCat~~\|~~External_filters~~\|~~Denoisers~~\|}}	+	{{Filter3
		+	\|{{Author/tritical}}
		+	\|1.0.3
		+	\|
		+	3=[http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
		+	[http://www.sendspace.com/file/6k226c TNLMeans_ICL.7z]
		+	\|4=Spatial-Temporal Denoisers
		+	\|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
		+	\|6=[http://forum.doom9.org/showthread.php?t=111344 Doom9 Thread]
		+	}}
		+
		+	== Description ==
		+	[[TNLMeans]] is an implementation of the [http://en.wikipedia.org/wiki/Non-local_means NL-means denoising algorithm]. Aside from the original method, [[TNLMeans]] also supports extension into 3D, a faster, block based approach, and a multiscale version.
		+
		+	*<tt>TNLMeans_ICL.7z</tt> is an optimized build compiled with ICL10, see [http://forum.doom9.org/showthread.php?t=168090 discussion] for more details.
		+	<br>
		+
		+	== Requirements ==
		+	* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
		+	* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F\|Progressive]] input only
		+	* Supported color formats: [[YUY2]], [[YV12]]
		+	<br>
		+	==Theory Of Operation:==
		+
		+	The NL-means algorithm works in the following manner. For each pixel in the image define a search window in which to look for similar pixels. The search window is defined by the parameters Ax and Ay, which set the x-axis radius and y-axis radius. For each pixel in the window determine a weight based on the similarity of that pixel's gray level neighborhood to the center pixel's gray level neighborhood. The neighborhood is defined by the Sx and Sy parameters, which set the x-axis radius and y-axis radius. The similarity between two neighborhoods is measured using gaussian weighted (as a function of distance, the standard deviation is set by the "a" parameter) sum of squared differences. The final weight for a pixel is computed as:
		+
		+	exp(-(total_sse_difference/sum_of_gaussian_weights)/(h*h));
		+
		+	If the parameter 'sse' is set to false, then sum of absolute differences is used instead of sum of squared differences. In that case, the final weight for a pixel is computed as:
		+
		+	exp(-(total_sad_difference/sum_of_gaussian_weights)/h);
		+
		+	Once a weight for each pixel in the window is acquired, the final pixel value is simply the weighted average of all the pixels. In order for the center pixel to not be too heavily weighted, it is assigned a weight equal to the largest weight given to another pixel in the search window.
		+
		+	The block based modification changes the base step (or base window) from 1 pixel to blocks with size Bx and By where Bx and By set the x-axis radius and y-axis radius. The support and search windows still work the same way, but now whole blocks are computed/averaged at once instead of individual pixels. This modification cuts the computation time down by Bx2+1)(By*2+1) times.
		+
		+	The 3D extension allows extending the search window into neighbor frames. The parameter Az sets the temporal (z-axis) radius. With Az=1 frames n-1 and n+1 would be included.
		+
		+	The multiscale version works by running the normal algorithm with Ax/Ay = 2 on the original image, and then running the algorithm again on a downsampled (width/2,height/2) version of the original image with Ax/Ay/Bx/By/Sx/Sy all divided by 2. The weights from the two scales are then combined to form the final image. This process can greatly speed up processing for large search windows but sacrifices quality (especially around edges/lines/fine details). The type of downsampling that is used is set by the 'rm' parameter.
		+
		+	More information can be found by following the links to papers about NL-means under the TNLMeans portion of http://bengal.missouri.edu/~kes25c/.
		+	<br>
		+	<br>
		+	== [[Script variables\|Syntax and Parameters]] ==
		+	:{{Template:FuncDef\|TNLMeans (clip, int "Ax", int "Ay", int "Az", int "Sx", int "Sy", int "Bx", int "By", bool "ms", int "rm", float "a", float "h", bool "sse")}}
		+	<br>
		+	::{{Par2\| \|clip\| }}
		+	:::Input clip.
		+	<br>
		+	::{{Par2\|Ax\|int\|4}}
		+	::{{Par2\|Ay\|int\|4}}
		+	::{{Par2\|Az\|int\|0}}
		+	:::These set the x-axis, y-axis, and z-axis radii of the search window. These must be greater than or equal to 0. The full window size will be:
		+	::::<code>(Ax2+1) x (Ay2+1) x (Az*2+1)</code>
		+	:::Generally, the larger the search window the better the result of the denoising. Of course, the larger the search window the longer the denoising takes.
		+	<br>
		+	::{{Par2\|Sx\|int\|2}}
		+	::{{Par2\|Sy\|int\|2}}
		+	:::These set the x-axis and y-axis radii of the support (similarity neighborhood) window. These must be greater than or equal to 0. A larger similarity window will retain more detail/texture but will also cause less noise removal. Typical values for Sx/Sy are 2 or 3. The full window size will be: <code>(Sx2+1) x (Sy2+1)</code>
		+	<br>
		+	::{{Par2\|Bx\|int\|1}}
		+	::{{Par2\|By\|int\|1}}
		+	:::These set the x-axis and y-axis radii of the base window. In the original NL-means algorithm the base was a single pixel (Bx=0 and By=0). Using blocks larger than a single pixel will sacrifice some quality for speed. Note that Sx must be greater than or equal to Bx and Sy must be greater than or equal to By. It is recommended that Sx/Sy be larger than Bx/By.
		+	<br>
		+	::{{Par2\|ms\|bool\|false}}
		+	:::Controls whether or not the multiscale version is used. The multiscale version is faster but lower quality. The larger ax/ay are the greater the speed increase from using the multiscale version will be. If Ax/Ay are less than or equal to 2 then the multiscale version will not give any speed up and will make things slower. The multiscale version requires [[modulo\|mod 8]] input (width divisible by 8).
		+	<br>
		+	::{{Par2\|rm\|int\|4}}
		+	:::If ms = true, then rm sets the type of resizing used for downsampling. Possible options:
		+	:::*0 - Point
		+	:::*1 - Bilinear
		+	:::*2 - Bicubic
		+	:::*3 - Lanczos3
		+	:::*4 - Spline16
		+	:::*5 - Spline36
		+	<br>
		+	::{{Par2\|a\|float\|1.0}}
		+	:::Sets the standard deviation of the Gaussian used for weighting the difference calculation used for computing neighborhood similarity. Smaller values will result in less noise removal but will retain more detail/texture.
		+	<br>
		+	::{{Par2\|h\|float\|1.8}}
		+	:::Controls the strength of the filtering (blurring). Larger values will remove more noise but will also destroy more detail. 'h' should typically be set equal to the standard deviation of the noise in the image when using sse=true and assuming the noise fits the zero mean, Gaussian model.
		+
		+	:::*h defaults to 0.5 when sse=false
		+	<br>
		+	::{{Par2\|sse\|bool\|true}}
		+	:::Controls whether sum of squared differences or sum of absolute differences is used when computing neighborhood similarity. sse is slightly slower but retains fine detail/texture better. sad typically works better for cartoons/anime. The 'h' parameter usually needs to be set about 4 times lower when using sad than when using sse.
		+	:::*true - use sse
		+	:::*false - use sad
		+	<br>
		+
		+	== Examples ==
		+	TNLMeans with all default settings:
		+	[[AviSource]]("Blah.avi")
		+	TNLMeans(Ax=4, Ay=4, Az=0, Sx=2, Sy=2, Bx=1, By=1, ms=false, rm=4, a=1.0, h=1.8, sse=true)
		+	<br>
		+	== Changelog ==
		+	Version Date(D/M/Y) Changes<br>
		+	v1.0.3 08/28/2007 - Removed fast exp() approximation that was used for sse=false. Turns out it was
		+	quite inaccurate and had overflow problems resulting in artifacts.<br>
		+	v1.0.2 07/30/2006 - Fixed a problem with small weights causing artifacts<br>
		+	v1.0.1 06/19/2006 - Fixed a bug that caused a crash when ms=true was used with yuy2 input<br>
		+	v1.0 Final 05/31/2006 - Fixed always creating the downsampled clip unless ms=false was explicitly
		+	specified<br>
		+	v1.0 Beta 2 05/25/2006 + Added multiscale version (parameters ms/rm)
		+	+ Added sse parameter
		+	+ Optimized non-block based routines by buffering (100% speed increase)
		+	- Removed b parameter
		+	- Fixed a bug in the block based routines that caused some blocks
		+	in the search window not to be tested
		+	- Changed defaults for ax/ay/sx/sy/h<br>
		+	v1.0 Beta 1 05/17/2006 - Initial Release
		+	<br>
		+	== Archived Downloads ==
		+	{\| class="wikitable" border="1"; width="600px"
		+	\|-
		+	!!width="100px"\| Version
		+	!!width="150px"\| Download
		+	!!width="150px"\| Mirror
		+	\|-
		+	!v1.0.3
		+	\|[http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
		+	\|[http://web.archive.org/web/20140420182218/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip TNLMeansv103.zip]
		+	\|}
		+	<br>
		+	== External Links ==
		+	*[http://github.com/VFR-maniac/VapourSynth-TNLMeans GitHub] - VapourSynth port of TNLMeans.
		+	<br>
		+	<br>
		+	-----------------------------------------------
		+	'''Back to [[External_filters#Spatio-Temporal_Denoisers\| External Filters]] ←'''