Vapoursynth QTGMC (denoise)

From wiki.selur.net
Jump to navigation Jump to search

QTGMC (denoise) runs the QTGMC deinterlacer in its progressive modes: it removes shimmer and leftover interlacing artifacts from progressive material and can denoise or keep grain. The frame rate stays the same. For deinterlacing see QTGMC; QTempGaussMC is a different filter.

Filtering → Vapoursynth → DeNoise

QTGMC (denoise) controls in Hybrid
QTGMC (denoise) controls in Hybrid

What it does

QTGMC builds a temporally smoothed, motion-compensated version of the clip with Gaussian blurs and resharpens it. With Input type 1 it repairs shimmer on general progressive material; 2 and 3 are for badly deinterlaced material. Optional noise processing (EZDenoise/EZKeepGrain) and source matching improve fidelity.

Settings

Control Parameter Range / values Hybrid default Meaning
Preset Preset Draft … Placebo Fast Speed/quality preset; changing it resets Final temporal smoothing, Source matching, Sharpness, Noise preset and Lossless.
Input type InputType 1 – 3 1 1 = general progressive material, 2/3 = badly deinterlaced material.
Final temporal smoothing TR2 0 – 3 1 Temporal radius of the final smoothing.
Sharpness Sharpness 0 – 1.9 1.0 (0.2 with source matching) Resharpening; written only with the check box.
Source matching SourceMatch off, basic, refined, 2xrefined off Brings the result closer to the source.
Lossless Lossless off, after temporal smooth, before resharpening off Keeps the original pixels where possible; only for input types 2 and 3.
Match preset / Match preset 2 / Match enhance MatchPreset, MatchPreset2, MatchEnhance presets, 0 – 1000 default, 0.5 Settings of source matching (default: three and five steps faster than Preset).
EZDenoise / EZKeepGrain EZDenoise, EZKeepGrain 0 – 100 off Denoise, or keep grain; the two exclude each other.
Noise preset NoisePreset Slower … Faster Fast Speed of the noise processing; only with EZDenoise or EZKeepGrain.
Denoiser Denoiser auto, FFT3D, dfttest, KNLMeansCL, bm3d auto Denoiser of the noise processing; auto lets the noise preset decide.
Show settings / Show noise ShowSettings, ShowNoise on/off off Debug output.
Pad mod16 – on/off off Pads the clip to mod 16 instead of mod 4.
Addition – text – Further parameters, appended to the call.

Tools: MV, Expr, NNEDI3, EEDI3, DFTTest, NLMeans, BM3D, RG, Median, FFT3D and Grain implementations, and a GPU device.

Presets

A preset only fills in the values that are not given; every value set explicitly in Hybrid (including Addition) overrides the preset. Hybrid always writes Final temporal smoothing; changing Preset sets it to the value of the table below.

Preset settings

Values for Tuning "None" (QTGMC's default).

Setting Parameter Placebo Very Slow Slower Slow Medium Fast Faster Very Fast Super Fast Ultra Fast Draft
Motion search smoothing radius TR0 2 2 2 2 2 2 1 1 1 1 0
Shimmer removal smoothing radius TR1 2 2 2 1 1 1 1 1 1 1 1
Final temporal smoothing TR2 3 2 1 1 1 0 0 0 0 0 0
Repair of the motion search clip Rep0 4 4 4 4 3 3 0 0 0 0 0
Repair of the final output Rep2 4 4 4 4 4 4 4 4 3 3 0
Interpolation (input types 2/3) EdiMode NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 Bwdif Bob
NNEDI3 predictor area (input types 2/3) NNSize 1 (16x6) 1 (16x6) 1 (16x6) 1 (16x6) 5 (16x4) 5 (16x4) 4 (8x4) 4 (8x4) 4 (8x4) 4 (8x4) 4 (8x4)
NNEDI3 neurons (input types 2/3) NNeurons 2 (64) 2 (64) 1 (32) 1 (32) 1 (32) 0 (16) 0 (16) 0 (16) 0 (16) 0 (16) 0 (16)
EEDI3 search distance (only with an EEDI3 EdiMode, input types 2/3) EdiMaxD 12 10 8 7 7 6 6 5 4 4 4
Resharpening mode SMode 2 2 2 2 2 2 2 2 2 2 0 (off)
Sharpness Sharpness 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 1.0 0.0
Sharpness limiting SLMode 2 (temporal) 2 2 2 2 2 2 2 0 (off) 0 0
Sharpness limiting radius SLRad 3 1 1 1 1 1 1 1 1 1 1
Back blend Sbb 3 (both) 1 (before) 1 0 (off) 0 0 0 0 0 0 0
Motion search prefilter SrchClipPP 3 (Gauss + edge soften) 3 3 3 3 2 (Gauss) 2 2 1 (simple blur) 1 0 (none)
Sub-pixel accuracy SubPel 2 (1/2) 2 2 2 1 (full) 1 1 1 1 1 1
Block size BlockSize 16 16 16 16 16 16 32 32 32 32 32
Block overlap Overlap 8 8 8 8 8 8 16 8 8 8 8
Search method Search 5 (UMH) 4 (hexagon) 4 4 4 4 4 4 0 (one time) 0 0
Search range SearchParam 2 2 2 2 2 2 2 1 1 1 1
Search range at sub-pixel level PelSearch 2 2 2 2 1 1 1 1 1 1 1
Chroma in motion analysis ChromaMotion True True True False False False False False False False False
Vector coherence (from BlockSize) Lambda 400 400 400 400 400 400 1600 1600 1600 1600 1600
Precise algorithms Precise True True False False False False False False False False False
Blending of input types 1 and 2/3 (input types 2/3) ProgSADMask 10.0 10.0 10.0 10.0 10.0 0.0 0.0 0.0 0.0 0.0 0.0
Noise processing (without EZDenoise/EZKeepGrain) NoiseProcess 2 (keep grain) 2 0 (off) 0 0 0 0 0 0 0 0
Match preset (default) MatchPreset Slow Medium Fast Faster Very Fast Super Fast Ultra Fast Ultra Fast Ultra Fast Ultra Fast –
Match preset 2 (default) MatchPreset2 Fast Faster Very Fast Super Fast Ultra Fast Ultra Fast Ultra Fast Ultra Fast Ultra Fast Ultra Fast –
  • With Source matching on, Sharpness defaults to 0.2 and SLMode to 0. Draft does not support source matching.
  • Input type 1 does not interpolate, so the interpolation rows only matter for input types 2 and 3.
  • Tuning "DV-HD" (only through Addition) uses BlockSize 32 for every preset; Overlap is then 16 from Placebo to Faster.

Match preset settings

Interpolation values used by the source matching passes (Source matching). The basic pass uses Match preset, the refined passes use Match preset 2; Draft is not available here.

Setting Parameter Placebo Very Slow Slower Slow Medium Fast Faster Very Fast Super Fast Ultra Fast
Interpolation of the basic pass MatchEdi same as EdiMode of the main preset Bwdif
Interpolation of the refined passes MatchEdi2 NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 NNEDI3 Bob
NNEDI3 predictor area NNSize 1 (16x6) 1 (16x6) 1 (16x6) 1 (16x6) 5 (16x4) 5 (16x4) 4 (8x4) 4 (8x4) 4 (8x4) 4 (8x4)
NNEDI3 neurons NNeurons 2 (64) 2 (64) 1 (32) 1 (32) 1 (32) 0 (16) 0 (16) 0 (16) 0 (16) 0 (16)
EEDI3 search distance EdiMaxD 12 10 8 7 7 6 6 5 4 4

Noise preset settings

Used with EZDenoise or EZKeepGrain (Noise preset), and with the noise processing that Placebo and Very Slow switch on (then always Fast). Denoiser auto takes the value of this table.

Setting Parameter Slower Slow Medium Fast Faster
Denoiser Denoiser dfttest dfttest dfttest FFT3D FFT3D
Motion-compensated denoising DenoiseMC True True False False False
Noise analysis radius NoiseTR 2 1 1 1 0
Noise stabilization StabilizeNoise True True True False False

EZDenoise and EZKeepGrain

Parameter neither (Placebo, Very Slow) EZDenoise = d EZKeepGrain = k
NoiseProcess 2 1 (denoise) 2 (keep grain)
Sigma 2.0 d 4 × k
GrainRestore 0.3 0.0 0.3 × √k
NoiseRestore 0.1 0.0 0.1 × √k

With the other presets and neither value set, noise processing is off.

Example

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

# Denoising using QTGMC
clip = qtgmc.QTGMC(clip, Preset="Fast", InputType=1, TR2=1, SourceMatch=0, Lossless=0, tools={'mv': 'mvgpu', 'expr': 'akarin', 'nnedi3': 'znedi3', 'eedi3': 'vszip', 'dfttest': 'neo_fft', 'nlmeans': 'vszip', 'bm3d': 'bm3d', 'rg': 'zsmooth', 'median': 'zsmooth', 'fft3d': 'neo_fft', 'grain': 'noise'})

How Hybrid calls it

  • QTGMC (denoise) works on YUV and gray clips; for input types 2/3 with slow presets 8-bit is used. The clip is padded to mod 4 (or 16) and cropped back.
  • Preset, input type, final temporal smoothing, source matching and lossless are always written; the others only when set. For input types 2 and 3 Hybrid writes the field order of the source (detected or overwritten scan type): TFF=False for bottom field first, otherwise TFF=True (also for unknown or progressive sources).
  • QTGMC (denoise) also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

QTGMC

QTGMC 3.33 (by -Vit-, based on Didée's TempGaussMC) is a high-quality deinterlacer with presets, noise processing, progressive repair, source matching and shutter simulation. Its progressive modes (InputType 1–3) process frames without doubling the rate. The VapourSynth version came from havsfunc; Hybrid keeps its own copy.

Sources