Vapoursynth SmoothGrad: Difference between revisions
New filter page (via create-page on MediaWiki MCP Server) |
Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server) |
||
| Line 15: | Line 15: | ||
| Radius || radius || 2 – 9 || 9 || Size of the averaged square: radius × 2 − 1 pixels (9 = 17×17). | | Radius || radius || 2 – 9 || 9 || Size of the averaged square: radius × 2 − 1 pixels (9 = 17×17). | ||
|- | |- | ||
| Threshold || thr || 0.01 – | | Threshold || thr || 0.01 – 10.00 || 0.25 || Largest difference that is fully accepted, in 8-bit units at any bit depth. | ||
|- | |- | ||
| Elast || elast || 1.00 – 100.00 || 3 || Soft threshold: differences up to Threshold × Elast are blended; 1 = hard threshold. | | Elast || elast || 1.00 – 100.00 || 3 || Soft threshold: differences up to Threshold × Elast are blended; 1 = hard threshold. | ||
| Line 28: | Line 28: | ||
== Example == | == Example == | ||
Default settings on a 10-bit YUV 4:2:0 source (640x356): | Default settings on a 10-bit YUV 4:2:0 source (640x356): | ||
< | <pre> | ||
# adjusting color using SmoothGrad | # adjusting color using SmoothGrad | ||
clip = color.SmoothGrad(clip, tools={'expr': 'akarin', 'boxblur': 'vszip'}) | clip = color.SmoothGrad(clip, tools={'expr': 'akarin', 'boxblur': 'vszip'}) | ||
</ | </pre> | ||
== How Hybrid calls it == | == How Hybrid calls it == | ||
| Line 37: | Line 37: | ||
* The threshold is passed as entered; the script scales it from 8-bit to the clip's range. | * The threshold is passed as entered; the script scales it from 8-bit to the clip's range. | ||
* Values are only written when they differ from the defaults, which are the script's own. | * Values are only written when they differ from the defaults, which are the script's own. | ||
* In the default filter order SmoothGrad runs | * In the default filter order SmoothGrad runs next to the other debanders (after PlaceboDeband); the filter queue can change the order. | ||
* The script's ''ref'' clip is not offered; SmoothGrad compares with its own input. | |||
* SmoothGrad also offers the [[Vapoursynth common filter options|common options]] (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick). | * SmoothGrad also offers the [[Vapoursynth common filter options|common options]] (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick). | ||
Latest revision as of 09:52, 16 November 2026
SmoothGrad reduces banding in flat areas and gentle gradients with a large box blur that is only kept where it changes the picture little, so edges stay intact.
Filtering → Vapoursynth → DeBand

What it does
The picture is blurred with a box blur and compared with the original pixel by pixel. Differences up to Threshold take the blurred value; between Threshold and Threshold × Elast the blur is phased out gradually; larger differences (edges, detail) keep the original.
Settings
| Control | Parameter | Range / values | Hybrid default | Meaning |
|---|---|---|---|---|
| Radius | radius | 2 – 9 | 9 | Size of the averaged square: radius × 2 − 1 pixels (9 = 17×17). |
| Threshold | thr | 0.01 – 10.00 | 0.25 | Largest difference that is fully accepted, in 8-bit units at any bit depth. |
| Elast | elast | 1.00 – 100.00 | 3 | Soft threshold: differences up to Threshold × Elast are blended; 1 = hard threshold. |
| Planes | planes | all, chroma only, luma only | all | Planes that are filtered; the others are copied unchanged. |
| Tools: Expr | – | akarin, cranexpr, std | akarin | Expression plugin; akarin needs AVX2. |
| Tools: BoxBlur | – | vszip, std | vszip | Box blur implementation. |
Example
Default settings on a 10-bit YUV 4:2:0 source (640x356):
# adjusting color using SmoothGrad
clip = color.SmoothGrad(clip, tools={'expr': 'akarin', 'boxblur': 'vszip'})
How Hybrid calls it
- SmoothGrad works on any bit depth, integer or float, YUV or RGB; no conversion is needed.
- The threshold is passed as entered; the script scales it from 8-bit to the clip's range.
- Values are only written when they differ from the defaults, which are the script's own.
- In the default filter order SmoothGrad runs next to the other debanders (after PlaceboDeband); the filter queue can change the order.
- The script's ref clip is not offered; SmoothGrad compares with its own input.
- SmoothGrad also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).
Background
Origin
SmoothGrad comes from the Dither package for AviSynth; the VapourSynth version is based on muvsfunc's port, a box blur followed by a limiting step. For several SmoothGrad passes in a row the original recommends the source as reference clip; Hybrid does not offer a reference clip. GradFun3Mod can use SmoothGrad as its multi-stage smoothing.
Sources
- muvsfunc (SmoothGrad port)
- VapoursynthScriptsInHybrid (the script collection Hybrid uses)
- Hybrid's tooltips