Vapoursynth FluxSmooth

From wiki.selur.net
Revision as of 09:49, 16 November 2026 by Selur (talk | contribs) (Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

FluxSmooth is a temporal denoiser that only touches "fluctuating" pixels, so motion is mostly left alone.

Filtering → Vapoursynth → DeNoise

FluxSmooth controls in Hybrid
FluxSmooth controls in Hybrid

What it does

A pixel fluctuates when it is brighter than both its counterparts in the previous and the next frame, or darker than both. Only such pixels are smoothed: they are averaged with the neighbors that lie within the threshold. Moving content rarely fluctuates this way. In the spatio-temporal mode the 8 spatial neighbors of the current frame join the average.

Settings

Control Parameter Range / values Hybrid default Meaning
Temporal threshold temporal_threshold 0 – 255 7 Previous/next pixels within this distance are averaged in (8-bit scale).
Spatial threshold spatial_threshold off, 0 – 255 off, 7 With the check box the spatio-temporal version runs, and spatial neighbors within this distance join the average.
Planes planes all, chroma only, luma only all Planes that are filtered.

Example

Default settings on a 10-bit YUV 4:2:0 source:

# denoising using FluxSmooth
clip = core.zsmooth.FluxSmoothT(clip, scalep=True)

How Hybrid calls it

  • FluxSmooth works on 8–16-bit integer YUV; other formats are converted first.
  • The thresholds are on the 8-bit scale; Hybrid lets the plugin scale them to the clip's bit depth (scalep).
  • The thresholds and the planes are only written when they differ from the defaults.
  • FluxSmooth also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).

Background

zsmooth

zsmooth's FluxSmoothT and FluxSmoothST accept 8–16-bit integer and 16/32-bit float clips; a negative threshold copies a plane. The temporal radius is fixed at 1; for larger radii zsmooth points to its TemporalMedian and TemporalSoften. FluxSmoothST leaves the outer rows and columns unchanged. The older VapourSynth FluxSmooth plugin is archived in favor of zsmooth.

Sources