Vapoursynth MC Temporal Denoise: Difference between revisions

From wiki.selur.net
Jump to navigation Jump to search
New filter page (via create-page on MediaWiki MCP Server)
 
Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server)
 
Line 48: Line 48:
== Example ==
== Example ==
Default settings on a 10-bit YUV 4:2:0 source (machine with a discrete GPU):
Default settings on a 10-bit YUV 4:2:0 source (machine with a discrete GPU):
<syntaxhighlight lang="python">
<pre>
# denoising using MCTemporalDenoise
# denoising using MCTemporalDenoise
clip = denoise.MCTemporalDenoise(clip, settings="low", ncpu=1, tools={'mv': 'mvgpu', 'expr': 'akarin', 'dfttest': 'neo_fft', 'dctfilter': 'zsmooth', 'rg': 'zsmooth', 'median': 'zsmooth', 'ttempsmooth': 'zsmooth', 'limiter': 'std', 'edgemasks': 'edgemasks', 'fft3d': 'neo_fft', 'scd': 'scd'})
clip = denoise.MCTemporalDenoise(clip, settings="low", ncpu=1, tools={'mv': 'mvgpu', 'expr': 'akarin', 'dfttest': 'neo_fft', 'dctfilter': 'zsmooth', 'rg': 'zsmooth', 'median': 'zsmooth', 'ttempsmooth': 'zsmooth', 'limiter': 'std', 'edgemasks': 'edgemasks', 'fft3d': 'neo_fft', 'scd': 'scd'})
</syntaxhighlight>
</pre>


== How Hybrid calls it ==
== How Hybrid calls it ==

Latest revision as of 09:50, 16 November 2026

MC Temporal Denoise (MCTemporalDenoise, MCTD) is a motion-compensated temporal denoiser. Five presets set its strength; every group of values can be overridden by hand.

Filtering → Vapoursynth → DeNoise

MC Temporal Denoise controls in Hybrid
MC Temporal Denoise controls in Hybrid

What it does

  1. A prefiltered copy (DFTTest) is used to search the motion.
  2. Each frame is averaged with its motion-compensated neighbors (MDegrain), once or – with TwoPass – twice; a limiter keeps the changes in check.
  3. Optionally: deblocking before denoising, an FFT3D post pass, and for the high presets a stabilizing step for edges and flat areas.

Settings

Settings: very low, low (default), medium, high, very high. Without the Custom groups only the preset is written, and the script's preset table decides; the fields show the preset's values.

Preset Radius Sigma TwoPass Limit / Limit 2 Chroma SAD / SCD1 SCD2 Pel Stabilize
very low 1 2 off -1 / -1 off 200 90 1 off
low 2 4 off -1 / -1 off 300 100 2 off
medium 3 8 off -1 / -1 on 400 100 2 off
high 2 12 on -1 / 0 on 500 130 2 on
very high 3 16 on 0 / 0 on 600 130 2 on

Custom groups

Group Controls (parameters) Meaning
Custom Denoise Radius (radius, 1–6), Sigma (sigma), TwoPass (twopass), Limit / Limit 2 (limit, limit2, -1–255), Post (post, 0–40), Chroma (chroma) Frames on each side, prefilter strength, second pass, limits (-1 adaptive, 0 none, above 0 the largest change on the 8-bit scale), FFT3D post pass, chroma.
Custom Deblock DeBlock before denoise (deblock), Use Deblock_QED (useQED), Quant 1/2 (quant1, quant2) Deblocking before denoising; the quantizers only for Deblock_QED.
Custom Block/Overlap bwbh, owoh, Blocksize, Overlap FFT3D and motion search block sizes; automatically 16/8 above 1024×576, otherwise 8/4.
Custom FFT3D BT (bt, 0–5) Temporal block size of the FFT3D post pass.
Custom MVTools SAD 1/2, SCD 1/2, Truemotion, Global, Pel, Pel search, Search, Searchparam, Sharp, DCT Motion search settings; the presets use hexagon search. Search is ignored with mvgpu.

nCPU (1–10) is always written and only used by FFT3D.

Tools: MV, Expr, DFTTest, and depending on the settings FFT3D (post pass), DCTFilter (Deblock_QED) and the stabilizing step's Edgemasks, Median, TTempSmooth and SCD.

Example

Default settings on a 10-bit YUV 4:2:0 source (machine with a discrete GPU):

# denoising using MCTemporalDenoise
clip = denoise.MCTemporalDenoise(clip, settings="low", ncpu=1, tools={'mv': 'mvgpu', 'expr': 'akarin', 'dfttest': 'neo_fft', 'dctfilter': 'zsmooth', 'rg': 'zsmooth', 'median': 'zsmooth', 'ttempsmooth': 'zsmooth', 'limiter': 'std', 'edgemasks': 'edgemasks', 'fft3d': 'neo_fft', 'scd': 'scd'})

How Hybrid calls it

  • MC Temporal Denoise works on YUV clips; width and height must be divisible by 4. The script pads the clip to the block size internally and crops it back.
  • Sigma, Post and the limits are on the 8-bit scale; the script scales them.
  • MC Temporal Denoise also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

The script

The function is a port of the AviSynth MCTemporalDenoise (by LaTo) that came to VapourSynth through havsfunc. Hybrid's version takes its plugins from the Tools group.

Sources