KNLMeansCL
From Avisynth wiki
| Abstract | |
|---|---|
| Author | Khanattila, pinterf |
| Version | v1.1.1e |
| Download | KNLMeansCL_1.1.1e_v20201112-pfmod.7z |
| Category | Spatial-Temporal Denoisers |
| License | GPLv3 |
| Discussion | Doom9 Thread |
Contents |
Description
KNLMeansCL is an optimized OpenCL implementation of the Non-local means de-noising algorithm. The NLMeans filter, originally proposed by Buades et al., is a very popular filter for the removal of white Gaussian noise, due to its simplicity and excellent performance. The strength of this algorithm is to exploit the repetitive character of the image in order to de-noise the image unlike conventional de-noising algorithms, which typically operate in a local neighbourhood.
Requirements
- [x86]: AviSynth+ or AviSynth 2.6
- [x64]: AviSynth+
- Supported color formats: RGB32, Y8, YV12, YV16, YV24, YV411
- *** vc_redist.x86.exe is required for KNLMeansCL-x86
- *** vc_redist.x64.exe is required for KNLMeansCL-x64
- Compatible CPU or GPU, see requirements here: https://github.com/Khanattila/KNLMeansCL/wiki/Requirements
Syntax and Parameters
- KNLMeansCL (clip, int "d", int "a", int "s", float "h", string "channels", int "wmode", float "wref", clip "rclip", string "device_type", int "device_id", int "ocl_x", int "ocl_y", int "ocl_r", bool "stacked", bool "info", int "mode_9_to_15bits")
- clip =
- Input clip; 8192x8192 is the highest resolution supported.
- clip =
- int d = 1
- Set the number of past and future frame that the filter uses for denoising the current frame. d=0 uses 1 frame, while d=1 uses 3 frames and so on. Usually, larger it the better the result of the denoising. Temporal size = (2 * d + 1).
- int d = 1
- int a = 2
- Set the radius of the search window. a=0 uses 1 pixel, while a=1 uses 9 pixels and so on. Usually, larger it the better the result of the denoising. Spatial size = (2 * a + 1)^2.
- int a = 2
- Tip: total search window size = temporal size * spatial size.
- int s = 4
- Set the radius of the similarity neighbourhood window. The impact on performance is low, therefore it depends on the nature of the noise. Similarity neighborhood size = (2 * s + 1)^2.
- int s = 4
- float h = 1.2
- Controls the strength of the filtering. Larger values will remove more noise.
- float h = 1.2
- string channels = "auto"
- Set the colour channels to be denoised. Possible values are
"YUV", "Y", "UV" or "RGB", depending on the source colour format. By default, "Y" is denoised if colour space is YUV, otherwise "RGB". - Note:
channels="YUV"requires a 4:4:4 pixel format (YV24 or YUV444Px).
- Set the colour channels to be denoised. Possible values are
- string channels = "auto"
Advanced
- int wmode = 0
- 0 : Welsch weighting function has a faster decay, but still assigns positive weights to dissimilar blocks. Original Non-local means denoising weighting function.
- 1 : Modified Bisquare weighting function to be less robust.
- 2 : Bisquare weighting function use a soft threshold to compare neighbourhoods (the weight is 0 as soon as a given threshold is exceeded).
- 3 : Modified Bisquare weighting function to be even more robust.
- int wmode = 0
- float wref = 1.0
- Amount of original pixel to contribute to the filter output, relative to the weight of the most similar pixel found.
- float wref = 1.0
- clip rclip =
- Extra reference clip option to do weighting calculation.
- clip rclip =
OpenCL
- string device_type = "auto"
"accelerator": Dedicated OpenCL accelerators."cpu": An OpenCL device that is the host processor."gpu": An OpenCL device that is a GPU."auto": "accelerator" -> "gpu" -> "cpu".
- string device_type = "auto"
- int device_id = 0
- The 'device_id'+1º device of type 'device_type' in the system. Example: [device_type = "GPU", device_id = 1] return the second GPU in the system.
- int device_id = 0
- int ocl_x = 0
- int ocl_y = 0
- int ocl_r = 0
- They should not be changed, unless you know what you are doing.
- 'ocl_x' and 'olc_y' are the local work group size of the separable convolution kernel.
- 'olc_r' is the number of processed pixel for work-item.
- They should not be changed, unless you know what you are doing.
- int ocl_x = 0
Miscellaneous
- bool stacked = false
- AviSynth hack. Set 16-bit stacked input and output clip. See Stack16 for more info.
- AviSynth+ supports native high bit depth; this hack is only for AviSynth 2.6.
- bool stacked = false
- bool info = false
- Display info on the screen. It requires YUV colour space.
- bool info = false
- int mode_9_to_15bits = 1
- Affects how less-than-16-bit formats are handled internally. Result is the same, speed may vary.
- Range: 0 to 2, 1 is the default
- int mode_9_to_15bits = 1
Examples
KNLMeansCL with all default settings:
AviSource("Blah.avi") KNLMeansCL()
Changelog
v1.1.1e [20201112 (pinterf)]
Update internal VERSION with 'e' shown in 'info' pages
New: Add (debug) parameter: 'mode_9_to_15bits' (integer). Values 0, 1 (default), 2
Affects how less-than-16-bit formats are handled internally.
Result is the same, speed may vary
New: VapourSynth: support for all bit depth between 8 and 16
Fix: VapourSynth: check if format is 4:4:4 for parameter channels="YUV" (was: crash)
New: VapourSynth: If OpenCL driver does not support special 10-10-10 bit internal processing mode,
silently fallbacks to the new high bit depth normal mode instead of
"format not supported"
v1.1.1d [20201102 (pinterf)]
Fix: Avisynth: channels="UV" gives error on greyscale clips with bit depth > 8
Fix: Avisynth: YV24 text in a parameter checking error replaced to bit depth independent 4:4:4
Fix: Avisynth: channels="UV" was working only for 8 bit subsampled formats
Fix: Avisynth: channels="UV" to properly support 4:1:1 subsampling
New: Avisynth: add planar RGB support
New: Avisynth: add general support for 9-15 bit input formats (avs: 10, 12, 14)
New: Avisynth: 10 bit input processing is no longer restricted to channels="YUV"
New: Avisynth: If OpenCL driver does not support special 10-10-10 bit internal processing mode,
silently fallbacks to the new high bit depth normal mode instead of
"format not supported"
v1.1.1c [20201028 (pinterf)]
Avisynth: fixes invalid frame content / ghost frames / hangup in multithreaded environment
v1.1.1test [20200429 (pinterf)]
Khanattila's KNLMeansCL unofficial test build for AviSynth+ 3.5.2
For older changelog see https://github.com/Khanattila/KNLMeansCL/blob/master/CHANGELOG
External Links
- GitHub - Source code repository.
Back to External Filters ←
