Reel.Deal: r11

2021-08-22T19:49:24Z

r11

Reel.Deal: neo_fft3d

2021-08-16T04:38:30Z

neo_fft3d

New page

{{FilterCat6|External_filters|Plugins|Plugins_x64|Denoisers|Spatial-Temporal_Denoisers|Deep_color_tools}}
{{Filter3
|1=[https://github.com/msg7086 MeteorRain]
|2=r10
|3=[https://github.com/HomeOfAviSynthPlusEvolution/neo_FFT3D/releases NeoFFT3D_r10.zip]
|4=Denoisers
|5=[https://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|6=[https://forum.doom9.org/showthread.php?t=181294 Doom9 Forum]
}}

== Description ==
FFT3DFilter is a 3D Frequency Domain filter - strong denoiser and moderate sharpener. It was originally written by Alexander G. Balakhnin aka Fizick, and later modified by martin53 for AviSynth 2.6 and later modified by Ferenc Pintér aka pinterf for further improvement, high bit depth, and more. Kudos to them for creating and improving this fantastic tool.

In this project, legacy format like YUY2 has been removed, legacy parameter like multiplane has been removed, and SIMD code has been completely re-written for all core parts of the code. Due to API change, the project has been renamed from FFT3DFilter to [[neo_FFT3D]] to avoid confusion. SSE is required to run optimized routine. AVX and AVX512 routine is also available.
 
 

== Requirements ==
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0]
* [x64]: [[AviSynth+]]
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
** AviSynth+: All [[planar]] formats (8/10/12/14/16/32-bit, Y, YUV(A), and RGB(A) with or without alpha) are supported.
 
===Runtime dependencies===
The following are required, neo_fft3d will not run or load without them.

* [http://www.fftw.org/install/windows.html FFTW 3.3.5] (<code>'''fftw-3.3.5-dll32.zip'''</code> or <code>'''fftw-3.3.5-dll64.zip'''</code>)
:*** 32-bit <tt>[[libfftw3f-3.dll]]</tt> needs to be in the search path (<tt>C:\Windows\SysWOW64</tt> 64-bit OS or <tt>C:\windows\system32</tt> 32-bit OS)
:*** 64-bit <tt>[[libfftw3f-3.dll]]</tt> needs to be in the search path (<tt>C:\windows\system32</tt> 64-bit OS)
 
== [[Script variables|Syntax and Parameters]] ==
{{Template:FuncDef|neo_fft3d (clip, float "sigma", float "beta", int "bw", int "bh", int "bt", int "ow", int "oh", float "kratio", float "sharpen", float "scutoff", float "svr", float "smin", float "smax", bool "measure", bool "interlaced", int "wintype", int "pframe", int "px", int "py", bool "pshow", float "pcutoff", float "pfactor", float "sigma2", float "sigma3", float "sigma4", float "degrid", float "dehalo", float "hr", float "ht", int "y", int "u", int "v", int "l", int "t", int "r", int "b", int "opt", int "ncpu", bool "mt")}}

 
::{{Par2| |clip| }}
:::Input clip
 
::{{Par2|sigma|float|2.0}}
:::Given noise value for all (or highest) frequencies. Only values greater that 0.0
 
::{{Par2|beta|float|1.0}}
:::Noise margin (float>=1.0, default=1.0 for no noise left): control noise amount left in the restoration for Wiener filter, so max filter noise attenuation = <code>(beta-1)/beta</code>.
 
::{{Par2|bw|int|48}}
::{{Par2|bh|int|48}}
:::Block width and height.
 
::{{Par2|bt|int|3}}
:::Block temporal size, number of frames.
:::*0 : all previous frames (switch Kalman filter mode)
:::*1 : only current frame (spatial 2D Wiener filter)
:::*2 : previous and current frame (3D Wiener filter)
:::*3 : previous, current and next frame (3D Wiener filter)
:::*4 : two previous, current and next frame (3D Wiener filter)
:::*5 : two previous, current and two next frames (3D Wiener filter)
:::*-1 : sharpen only (2D)
 
::{{Par2|ow|int|bw/3}}
::{{Par2|oh|int|bh/3}}
:::Overlap width and height.
 
::{{Par2|kratio|float|2.0}}
:::Ratio of threshold to sigma to reset Kalman filter. Variation threshold = <code>sigma*kratio</code>, good value is about from 1.5 to 3.0
 
::{{Par2|sharpen|float|0.0}}
:::Sharpening strength (default=0 - do not sharpen). Good values are about 0.3 to 1.0 (negative values results in reverse effect)
 
::{{Par2|scutoff|float|0.3}}
::: Sharpening cutoff frequency, relative to max.
 
::{{Par2|svr|float|1.0}}
:::Sharpening (and dehalo) vertical ratio (to horizontal) (default=1.0 - same as horizontal, 0 - no vertical sharpening)
 
::{{Par2|smin|float|4.0}}
::{{Par2|smin|float|20.0}}
::: Minimum and maximum limit (approximate noise margin) for sharpening stage.
 
::{{Par2|measure|bool|true}}
:::Select the most optimal (fastest) FFT method by speed measure (with longer init stage) instead of simple estimation.
 
::{{Par2|interlaced|bool|false}}
:::Separate fields processing.
 
::{{Par2|wintype|int|0}}
:::weighting windows type:
:::*0 : same analysis and synthesis half-cosine window, used in all versions before 1.4.
:::*1 : intermediate between 0 and 2
:::*2 : flat analysis window, rised cosine (Hanning) synthesis window.
 
::{{Par2|pframe|bool|false}}
:::Noise pattern frame number.
 
::{{Par2|px|int|0}}
::{{Par2|py|int|0}}
:::Noise pattern block horizontal X position and vertical Y position. If <code>px=py=0</code>, then the pattern block is defined automatically with minimal power spectral density.
 
::{{Par2|pshow|bool|false}}
:::Show noise pattern block and its properties.
 
::{{Par2|pcutoff|float|0.1}}
:::Noise pattern cutoff frequency (relative to max).
 
::{{Par2|pfactor|float|0.0}}
:::Noise pattern denoise strength (0 to 1.0, default=0, this method disabled).
 
::{{Par2|singma2|float|sigma}}
::{{Par2|singma3|float|sigma}}
::{{Par2|singma4|float|sigma}}
:::Given noise value at second, third, and lowest scale level frequencies. Only values greater that 0.0
 
::{{Par2|degrid|float|1.0}}
:::Weighting window compensation degree for grid decreasing. Only values greater that 0.0
 
::{{Par2|dehalo|float|0.0}}
:::Halo removal strength. Only values greater that 0.0
 
::{{Par2|hr|float|2.0}}
:::Halo approximate radius. Only values greater that 0.0
 
::{{Par2|ht|float|50.0}}
:::Halo approximate threshold. Only values greater that 0.0
 
::{{Par2|y|int|3}}
::{{Par2|u|int|3}}
::{{Par2|v|int|3}}
:::Whether a plane is to be filtered.
:::*1 - Do not touch, leaving garbage data
:::*2 - Copy from origin
:::*3 - Process
 
::{{Par2|l|int|0}}
::{{Par2|t|int|0}}
::{{Par2|r|int|0}}
::{{Par2|b|int|0}}
:::Exclude part of image to be filtered.
:::Non-filtered part is copied from the source.
 
::{{Par2|opt|int|0}}
:::Sets which CPU optimizations to use.
:::*<0 - Auto detect
:::*0 - Auto detect with AVX512 disabled
:::*1 - Use C
:::*2 - Use up to SSE
:::*3 - Use up to AVX
:::*4 - Use up to AVX512
 
::{{Par2|ncpu|int|2}}
:::Number of FFTW multi threads.
 
::{{Par2|mt|bool|false}}
:::<code>mt = false</code> disables plane based multi-threading (default).
 
==Examples==
To sharpen only:

AviSource("blah.avi")
neo_fft3d(bt=-1, sharpen=0.7)

To denoise and slightly sharpen the interlaced clip:

neo_fft3d(sigma=2, sharpen=0.3, interlaced=true)

Some "best settings", slower processing:

neo_fft3d(sigma=1.5, bt=5, bw=32, bh=32, ow=16, oh=16, sharpen=0.4)

To denoise all color planes (both luma and chroma):

neo_fft3d(sigma=2, y=3, u=3, v=3) # same as neo_fft3d(sigma=2)

To denoise luma and chroma with different settings:

neo_fft3d(sigma=1.5, y=3, u=2, v=2)
neo_fft3d(sigma=3.0, y=2, u=3, v=3)

To decrease the existing horizontal halo only:

neo_fft3d(bt=-1, dehalo=1.0, hr=2.0, ht=50, svr=0, y=3, u=2, v=2)
 
== Changelog ==
See GitHub [https://github.com/HomeOfAviSynthPlusEvolution/neo_FFT3D/releases releases page].
 

== External Links ==
*[https://github.com/HomeOfAviSynthPlusEvolution/neo_FFT3D GitHub] - Source code repository
 
 
-----------------------------------------------
'''Back to [[External_filters#Spatio-Temporal_Denoisers|External Filters]] ←'''

@@ Line 2: / Line 2: @@
 {{Filter3
 |1=[https://github.com/msg7086 MeteorRain]
-|2=r10
+|2=r11
-|3=[https://github.com/HomeOfAviSynthPlusEvolution/neo_FFT3D/releases NeoFFT3D_r10.zip]
+|3=[https://github.com/HomeOfAviSynthPlusEvolution/neo_FFT3D/releases NeoFFT3D_r11.zip]
 |4=Denoisers
 |5=[https://www.gnu.org/licenses/gpl-2.0.txt GPLv2]

Neo FFT3D - Revision history

Reel.Deal: r11

Reel.Deal: neo_fft3d