Vapoursynth DustDenoise

From wiki.selur.net
Revision as of 21:31, 14 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

DustDenoise is a port of Steady's AviSynth Dust filters (FaeryDust, PixieDust, GoldDust, SpaceDust). It denoises spatially and/or temporally, but no sample may move more than Limit away from the source, so detail cannot be smeared beyond that amount.

Filtering → Vapoursynth → DeNoise

DustDenoise controls in Hybrid
DustDenoise controls in Hybrid

What it does

The filter averages (or takes the median of) the pixel's neighbors in space and/or in the neighbor frames, and then clips the result to Limit around the source value. Optionally the neighbor frames are motion-compensated, edges get a lower limit, and frames from another scene are kept out of the temporal window.

Settings

Control Parameter Range / values Hybrid default Meaning
Mode mode faery, pixie, gold, space pixie faery = temporal only, pixie = temporal and spatial (weighted to temporal), gold = temporal and spatial (weighted to spatial), space = spatial only.
Limit limit 1 – 64 5 Largest change per sample, on the 8-bit scale. Hybrid uses this value for every mode (the plugin's own defaults are 2/5/8/6 for faery/pixie/gold/space).
Edge limit / Edge threshold limit_edge, edge_thresh -1 – 64 / 1 – 255 -1 (off) / 32 A separate limit on strong edges; the threshold sets the edge strength that counts as a full edge. Limit is raised to match when Edge limit is set higher.
Planes planes all, chroma only, luma only all Planes that are processed; the others are copied.
Scene change scthresh -1 – 255 20 Mean luma difference that counts as a cut; 0 = use the scene change frame properties only, -1 = no scene change handling.
Radius tr 1 – 5 1 Frames on each side; not for space.
Temporal temporal mean, median mean How the frames are combined; median rejects specks and dead pixels.
Motion compensation mc on/off on Compensates the motion of the neighbor frames.
thSAD thsad 0 – 10000 300 Blocks that match worse keep the source.
Block size / Overlap blksize, overlap 4 – 64 / 0 – 32 8 / 4 Motion search blocks; the overlap is at most half the block size.
Search / Pel / True motion search, pel, truemotion 8 algorithms / 1, 2, 4 / on/off hexagon / 2 / on Motion search settings; Search is ignored with mvgpu.
Tools: MV – mvgpu, mvutensils, mv mvgpu with a discrete GPU, otherwise mvutensils Motion vector implementation; mvgpu needs Vulkan and VapourSynth R82 (not on macOS).

The motion settings are only enabled with motion compensation and a mode other than space.

Example

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

# denoising using DustDenoise
clip = DustDenoise.DustDenoise(clip, tools={'mv': 'mvgpu'})

How Hybrid calls it

  • DustDenoise works on 8–16-bit integer YUV and gray clips; other formats are converted first. Interlaced material is handled by Hybrid's general field handling.
  • Values are only written when they differ from the defaults; Limit whenever it differs from the plugin's default for the chosen mode. All levels stay on the 8-bit scale, the plugin scales them.
  • DustDenoise also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

Dust

Dust 1.0.0 is a single engine with four presets; SpaceDust is the fastest and reads no other frames. Window positions behind a cut or past the clip end are replaced by the nearest frame of the same scene, and borders are mirrored. The SIMD versions give the same output as the C code. The project is a fork of Yuri Pronkin's DustPort and deliberately differs from its output; it runs on Windows, Linux and macOS, for VapourSynth and AviSynth+.

Sources