Vapoursynth QTGMC (denoise)
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

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
- VapoursynthScriptsInHybrid (the script collection Hybrid uses)
- havsfunc
- Hybrid's tooltips