Vapoursynth QTempGaussMC (denoise)

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

QTempGaussMC (denoise) uses vs-jetpack's QTempGaussMC – a Python rewrite of QTGMC – on progressive material: deshimmer removes horizontal shimmer, repair rebuilds badly deinterlaced frames from half of their fields. The frame rate stays the same. For deinterlacing see QTempGaussMC; QTGMC is a different filter.

Filtering → Vapoursynth → DeNoise

QTempGaussMC (denoise) controls in Hybrid
QTempGaussMC (denoise) controls in Hybrid

What it does

The clip runs through QTempGaussMC's motion-compensated chain: a prefilter, motion analysis, a basic and a final temporal Gaussian stage, optional sharpening, back blending and limiting, noise processing and source matching. In repair mode one field of each frame is dropped and interpolated again.

Settings

Mode: deshimmer (default) or repair. Preset: Default writes QTempGaussMC without arguments and hides the other controls; Custom shows them.

Group Controls Meaning
Prefilter Temporal radius (2), Scene change (0.1), Post processing, Shimmer erosion/dilation (4/0) Prefiltered clip for the motion search.
Motion analysis Preset (HQ_SAD), Block size (16), Overlap divisor (2), Refine passes (1), Scene change SAD / Changed blocks % (180 / 38.5), Recalc thSAD Motion vectors; impossible combinations are corrected automatically.
Interpolation (repair only) Interpolator (NNEDI3, EEDI3, EEDI3+NNEDI3, BWDIF, SangNom, Catrom), NNEDI3 Nsize/Neurons/Quality, EEDI3 max distance How the missing field is rebuilt.
Basic / final stage Radius (2 / 1), thSAD luma/chroma (640 / 256), Final shimmer erosion/dilation Temporal smoothing strength.
Source match off, basic, refined, 2xrefined; radius, enhance, similarity Brings the result closer to the source.
Lossless (repair only) off, before resharpening, after temporal smooth; Anti comb Keeps the original field.
Sharpening Mode, Strength (1), Edge thinning (0), Sharpen offset (1) Resharpening; unchecked = no sharpening.
Back blend and limiting Back blend (both), Blend scale (2), Limiting (auto), Limit radius (1), Limit clamp (0) Controls sharpening overshoot.
Noise identify/denoise, DFTTest/NLMeans, Sigma (8), Radius (1), Motion compensate, Stabilize (0.4), Restore after basic/final Noise processing.
Repair mask (repair only) on, Mask level (0 = library default 10) Limits the repair to combed areas.
Additional arguments text Further keywords for QTempGaussMC.

Tools: NNEDI3 (znedi3, nnedi3vk) and EEDI3 (vszip, eedi3vk2, vszipcl, vszipcu) implementations for repair.

Example

Default settings (Preset Default, mode deshimmer) on a 10-bit YUV 4:2:0 source:

# Deshimmering using QTempGaussMC (vs-jetpack)
clip = QTempGaussMC().deshimmer(clip)

How Hybrid calls it

  • QTempGaussMC (denoise) takes 8–16-bit integer YUV (not 4:1:0/4:1:1), 32-bit float YUV and gray clips; width and height must be even.
  • Nearly every keyword is only written when it differs from the library default; the interpolation, lossless and repair mask keywords only in repair mode. Repair gets 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).
  • Values on the 8-bit scale are scaled by the library.
  • QTempGaussMC (denoise) also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

vs-jetpack

QTempGaussMC is part of JET's vs-jetpack (module vsdeinterlace). Its documentation describes deshimmer for progressive sources and repair for badly deinterlaced ones; only deshimmer accepts progressive clips directly.

Sources