Vapoursynth QTempGaussMC

From wiki.selur.net
Revision as of 09:50, 16 November 2026 by Selur (talk | contribs) (New filter page (via create-page on MediaWiki MCP Server))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

QTempGaussMC is vs-jetpack's rewrite of QTGMC: a motion-compensated bobber that interpolates every field, removes bob shimmer with motion-compensated smoothing and resharpens the result. It is not the same filter as QTGMC; the parameters and their scales differ.

Filtering → (De-)Interlace/Telecine → Deinterlacer

QTempGaussMC controls in Hybrid
QTempGaussMC controls in Hybrid

What it does

QTempGaussMC works in stages: a prefilter for the motion search, motion analysis, optional denoising, the basic bob with a selectable interpolator, optional source matching and lossless restoration, sharpening with back blending and limiting, a final motion-compensated smoothing, and optional motion (shutter) blur. The native output has one frame per field. For progressive material (deshimmer, repair) the same filter is available as QTempGaussMC (denoise).

Requirements

  • vs-jetpack 2.3.x in Vapoursynth's Python environment; with another version or without it the entry is not offered.

Settings

Control Parameter Range / values Hybrid default Meaning
Preset – Default, Custom Default Default passes no settings, so every library default applies (and stays right when vs-jetpack changes them). Custom opens the tabs below.
Keep – Even, Odd Even Which frame of each pair is kept; disabled with Bob or an FPS divisor above 1.
Bob – on/off off Keep every frame (double rate).
FPS divisor motion_blur fps_divisor 1 – 4 1 Custom only, disabled with Bob: keeps every n-th interpolated frame (output rate = 2 × source rate / n) and blurs the motion of the dropped frames into the kept ones.
Additional arguments – text empty Custom only: further arguments, passed as written.
Tools: nnedi3 / eedi3 – znedi3, nnedi3vk; vszip, vszipcl, eedi3vk2, vszipcu – CPU or GPU implementation of the interpolators.

Custom tabs

Hybrid's custom defaults are the library defaults, so Custom with nothing changed gives the same picture as Default. Values are only written when they differ from the defaults; the bobber is always written.

Tab Controls (default) Meaning
Basic Bobber: NNEDI3, EEDI3, EEDI3+NNEDI3, BWDIF, SangNom, Catrom (NNEDI3); basic radius 0 – 25 (2) and thSAD luma/chroma (640); final radius (1) and thSAD (256) The interpolator of the basic bob, and radius and SAD limit of the basic and final motion-compensated smoothing. Higher radii are more stable and slower.
Motion prefilter radius 0 – 6 (2), scene threshold 0 – 1 (0.1), postprocess (gaussblur and edgesoften); analyze preset, block size 4 – 32 (16), overlap divisor (2), refine 0 – 3 (1), thSCD1 (180), thSCD2 in percent (38.5), thSAD recalc (library value) Prefilter and motion search. Block size, refine and overlap are corrected automatically to combinations that work. thSCD2 is a percentage, not the 0 – 255 scale of AviSynth.
Sharpen (group check box) mode unsharp / unsharp with minmax, strength 0 – 3 (1.0), edge thinning, offset, back blend (both), sharpen limit (auto), radius, clamp Resharpening of the bobbed result and how it is limited against the source. Offsets and clamps are on the 8-bit scale; the library scales them. With the group unticked there is no sharpening at all (strength 0).
Noise (group check box) identify or denoise, DFTTest or NLMeans, sigma 0 – 50 (8), radius (1), MC denoise (on), noise deinterlace (generate), stabilize (0.4), grain restore / noise restore 0 – 1 (0) Noise handling: remove noise, or take it out before processing and put (part of) it back afterwards. Unticked: nothing is written for this stage.
Misc source match off / basic / refined / twice refined, with radius (1), enhance (0.5), similarity (0.5); lossless off / before resharpening / after temporal smooth (+ anti-comb); shutter blur source/output angle 0 – 360 (180/180) Source matching corrects the result back towards the original fields; lossless puts the original lines back; shutter blur simulates a different exposure time.

Example

Default settings on an 8-bit YUV 4:2:0 interlaced source (704x576, 25 fps, top field first):

# Deinterlacing using QTempGaussMC (vs-jetpack)
clip = QTempGaussMC().deinterlace(clip, tff=True) # new fps: 50
# Making sure content is perceived as frame based
clip = core.std.SetFrameProps(clip=clip, _FieldBased=vs.FIELD_PROGRESSIVE) # scan type: progressive
clip = clip[::2] # selecting previously even frames, new fps: 25

How Hybrid calls it

  • Field order: Hybrid marks the field order on the clip after the source (detected scan type or Overwrite input scan type) and passes tff: off only for bottom field first, on for every other interlaced scan type. The interpolators read the frame property, so it must be present.
  • Output frame rate: always doubled first. Without Bob and with divisor 1 every second frame is kept (Keep), so the source rate stays; with a divisor n the rate is 2 × source / n (29.97 fps source: 59.94, 29.97, 19.98, 14.99).
  • Afterwards the clip counts as progressive. No decimation.
  • Works on 8–16-bit integer and 32-bit float YUV (4:2:0, 4:2:2, 4:4:0, 4:4:4) and gray; 4:2:0 needs a frame size that is a multiple of 4.

Background

vs-jetpack is the VapourSynth function collection of the Jaded Encoding Thaumaturgy group; QTempGaussMC lives in its vsdeinterlace module and is built up stage by stage. BM3D is not offered as denoiser because vsdenoise does not accept subsampled YUV for it. QTGMC remains Hybrid's default deinterlacer and offers some things QTempGaussMC does not (external interpolation clips, padding to mod 16, FFT3D denoising).

Sources