<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.selur.net/index.php?action=history&amp;feed=atom&amp;title=Vapoursynth_BM3D</id>
	<title>Vapoursynth BM3D - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.selur.net/index.php?action=history&amp;feed=atom&amp;title=Vapoursynth_BM3D"/>
	<link rel="alternate" type="text/html" href="https://wiki.selur.net/index.php?title=Vapoursynth_BM3D&amp;action=history"/>
	<updated>2026-11-19T08:19:26Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.46.2</generator>
	<entry>
		<id>https://wiki.selur.net/index.php?title=Vapoursynth_BM3D&amp;diff=469&amp;oldid=prev</id>
		<title>Selur: Update to current Hybrid behaviour; code as &lt;pre&gt; (via update-page on MediaWiki MCP Server)</title>
		<link rel="alternate" type="text/html" href="https://wiki.selur.net/index.php?title=Vapoursynth_BM3D&amp;diff=469&amp;oldid=prev"/>
		<updated>2026-11-16T08:47:37Z</updated>

		<summary type="html">&lt;p&gt;Update to current Hybrid behaviour; code as &amp;lt;pre&amp;gt; (via update-page on MediaWiki MCP Server)&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw-interface=&quot;&quot;&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;en&quot;&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;← Older revision&lt;/td&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;Revision as of 09:47, 16 November 2026&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l61&quot;&gt;Line 61:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Line 61:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== Example ==&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== Example ==&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Default settings on a 10-bit YUV 4:2:0 source:&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;Default settings on a 10-bit YUV 4:2:0 source:&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;lt;&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;syntaxhighlight lang=&quot;python&quot;&lt;/del&gt;&amp;gt;&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;lt;&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;pre&lt;/ins&gt;&amp;gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;# adjusting color space from YUV420P10 to YUV420PS for vsBM3D&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;# adjusting color space from YUV420P10 to YUV420PS for vsBM3D&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;clip = core.resize.Bicubic(clip=clip, format=vs.YUV420PS)&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;clip = core.resize.Bicubic(clip=clip, format=vs.YUV420PS)&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;# denoising using BM3D&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;# denoising using BM3D&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;clip = denoise.BM3D(clip, tools={&amp;#039;bm3d&amp;#039;: &amp;#039;vszip&amp;#039;})&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;clip = denoise.BM3D(clip, tools={&amp;#039;bm3d&amp;#039;: &amp;#039;vszip&amp;#039;})&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;lt;/&lt;del style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;syntaxhighlight&lt;/del&gt;&amp;gt;&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;lt;/&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;pre&lt;/ins&gt;&amp;gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== How Hybrid calls it ==&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;== How Hybrid calls it ==&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>Selur</name></author>
	</entry>
	<entry>
		<id>https://wiki.selur.net/index.php?title=Vapoursynth_BM3D&amp;diff=203&amp;oldid=prev</id>
		<title>Selur: New filter page (via create-page on MediaWiki MCP Server)</title>
		<link rel="alternate" type="text/html" href="https://wiki.selur.net/index.php?title=Vapoursynth_BM3D&amp;diff=203&amp;oldid=prev"/>
		<updated>2026-11-14T20:09:40Z</updated>

		<summary type="html">&lt;p&gt;New filter page (via create-page on MediaWiki MCP Server)&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;&amp;lt;div style=&amp;quot;float:right; margin:0 0 1em 1em;&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;BM3D&amp;#039;&amp;#039;&amp;#039; (Block-Matching and 3D filtering) is a strong, slow denoiser that keeps texture well. It groups similar blocks of the picture and filters each group together; with a radius above 0 it also searches the neighbor frames (V-BM3D).&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;Filtering → Vapoursynth → DeNoise&amp;#039;&amp;#039;&lt;br /&gt;
&lt;br /&gt;
[[File:Vapoursynth_BM3D.png|none|BM3D controls in Hybrid]]&lt;br /&gt;
&lt;br /&gt;
== What it does ==&lt;br /&gt;
# &amp;#039;&amp;#039;&amp;#039;Basic estimate&amp;#039;&amp;#039;&amp;#039;: for every block, similar blocks are searched and stacked; the stack is transformed, small coefficients are removed, and the blocks are put back.&lt;br /&gt;
# &amp;#039;&amp;#039;&amp;#039;Final estimate&amp;#039;&amp;#039;&amp;#039; (&amp;#039;&amp;#039;Refine&amp;#039;&amp;#039; passes): the same search on the basic estimate, now with Wiener filtering, which gives a cleaner result.&lt;br /&gt;
RGB can be filtered in the opponent color space (OPP), which separates brightness from color and denoises better.&lt;br /&gt;
&lt;br /&gt;
== Settings ==&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;General&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Control !! Parameter !! Range / values !! Hybrid default !! Meaning&lt;br /&gt;
|-&lt;br /&gt;
| Color space || – || YUV, OPP || YUV || Working format: OPP filters RGB in the opponent color space.&lt;br /&gt;
|-&lt;br /&gt;
| CBM3D || chroma || on/off || off || Reuses the luma block matching for U and V; only with vszip, bm3dvk, vsfeel and bm3dmetal.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Basic&amp;#039;&amp;#039;&amp;#039; (0 = automatic: the profile value with bm3d and bm3dvk2, the plugin default otherwise)&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Control !! Parameter !! Range / values !! Hybrid default !! Meaning&lt;br /&gt;
|-&lt;br /&gt;
| Sigma Y/U/V || sigma || 0 – 100 || 5 / 5 / 5 || Strength per plane on the 8-bit scale; 0 leaves the plane unchanged.&lt;br /&gt;
|-&lt;br /&gt;
| Radius || radius1 || 0 – 16 || 0 || Frames on each side (V-BM3D); needs much more time and memory.&lt;br /&gt;
|-&lt;br /&gt;
| Profile || profile1 || fast, lc, np, high, vn || fast || Parameter preset; bm3d and bm3dvk2 only.&lt;br /&gt;
|-&lt;br /&gt;
| Block size / Group size || block_size1, group_size1 || 0 – 64 / 0 – 256 || 0 || Block size and blocks per group; bm3d and bm3dvk2 only.&lt;br /&gt;
|-&lt;br /&gt;
| Block step || block_step1 || 0 – 64 || 0 || Distance between processed blocks; smaller is better and slower.&lt;br /&gt;
|-&lt;br /&gt;
| BM range / BM step || bm_range1, bm_step1 || 0 – 64 || 0 || Search range and step of the block matching (BM step: bm3d and bm3dvk2 only).&lt;br /&gt;
|-&lt;br /&gt;
| PS num / PS range / PS step || ps_num1, ps_range1, ps_step1 || 0 – 64 || 0 || Predictive search in the neighbor frames; only with a radius above 0 (PS step: bm3d and bm3dvk2 only).&lt;br /&gt;
|-&lt;br /&gt;
| th_mse || th_mse1 || 0 – 65535 || 0 || Similarity threshold of the block matching; bm3d and bm3dvk2 only.&lt;br /&gt;
|-&lt;br /&gt;
| hard_thr || hard_thr || 0 – 100 || 0 || Hard threshold of the basic estimate; bm3d and bm3dvk2 only.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Final&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Control !! Parameter !! Range / values !! Hybrid default !! Meaning&lt;br /&gt;
|-&lt;br /&gt;
| Refine || refine || 0 – 5 || 1 || Number of final passes; 0 = basic estimate only (the other final controls are disabled).&lt;br /&gt;
|-&lt;br /&gt;
| Own sigma, Sigma Y/U/V || sigma2 || 0 – 100 || off, 5 / 5 / 5 || Separate strength for the final passes.&lt;br /&gt;
|-&lt;br /&gt;
| Radius || radius2 || -1 – 16 || -1 (= Basic) || Temporal radius of the final passes.&lt;br /&gt;
|-&lt;br /&gt;
| Profile, block and search values || profile2, …2 || as in Basic || = Basic || 0 (or &amp;quot;same as Basic&amp;quot;) takes the Basic value; th_mse keeps its own automatic value.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Tools&amp;#039;&amp;#039;&amp;#039;: the BM3D implementation – vszip (CPU, default on Windows and Linux), bm3d (CPU), bm3dvk2 (Vulkan, VapourSynth R81, default on macOS), bm3dvk (Vulkan), vsfeel (Vulkan), bm3dmetal (macOS) – and a Device field for the GPU implementations. The GPU implementations are offered when a Vulkan 1.4 GPU is found.&lt;br /&gt;
&lt;br /&gt;
== Example ==&lt;br /&gt;
Default settings on a 10-bit YUV 4:2:0 source:&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;python&amp;quot;&amp;gt;&lt;br /&gt;
# adjusting color space from YUV420P10 to YUV420PS for vsBM3D&lt;br /&gt;
clip = core.resize.Bicubic(clip=clip, format=vs.YUV420PS)&lt;br /&gt;
# denoising using BM3D&lt;br /&gt;
clip = denoise.BM3D(clip, tools={&amp;#039;bm3d&amp;#039;: &amp;#039;vszip&amp;#039;})&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== How Hybrid calls it ==&lt;br /&gt;
* The clip is converted to 32-bit float: RGB for OPP; YUV 4:4:4 when U/V are filtered with bm3d or bm3dvk2; otherwise the float version of the current subsampling.&lt;br /&gt;
* Only values that differ from the defaults are written; the sigmas stay on the 8-bit scale. Final values left at 0 take the Basic value, final options are only written with Refine above 0, and the PS values only with a radius above 0.&lt;br /&gt;
* With bm3d and bm3dvk2 the color matrix of a YUV clip is passed.&lt;br /&gt;
* An implementation that cannot start (for example a GPU port without a usable GPU) is skipped with a warning, and the next one is used.&lt;br /&gt;
* BM3D also offers the [[Vapoursynth common filter options|common options]] (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).&lt;br /&gt;
&lt;br /&gt;
== Background ==&lt;br /&gt;
=== VapourSynth-BM3D ===&lt;br /&gt;
The original plugin implements the basic and final estimates as separate filters, the V-BM3D variants for several frames, and the conversion to and from the opponent color space. It recommends OPP for the best quality, needs 4:4:4 to filter chroma, and uses a lot of memory for V-BM3D. Its own default strength is sigma 10.&lt;br /&gt;
&lt;br /&gt;
=== Ports ===&lt;br /&gt;
vszip offers a CPU version with the parameter set of the BM3DCUDA family (32-bit float, CBM3D with &amp;#039;&amp;#039;chroma&amp;#039;&amp;#039;); its output is close to the GPU versions but not identical. bm3dvk2 is a Vulkan port that runs basic and final estimate in one call, takes Gray or RGB, and knows the full parameter set of the original including the profiles.&lt;br /&gt;
&lt;br /&gt;
== Sources ==&lt;br /&gt;
* [https://github.com/HomeOfVapourSynthEvolution/VapourSynth-BM3D VapourSynth-BM3D README]&lt;br /&gt;
* [https://github.com/dnjulek/vapoursynth-zip/wiki/BM3D vapoursynth-zip wiki: BM3D]&lt;br /&gt;
* [https://github.com/HolyWu/VapourSynth-bm3dvk2 VapourSynth-bm3dvk2 README]&lt;br /&gt;
* [https://github.com/Selur/VapoursynthScriptsInHybrid VapoursynthScriptsInHybrid] (the script collection Hybrid uses)&lt;br /&gt;
* Hybrid&amp;#039;s tooltips&lt;br /&gt;
&lt;br /&gt;
[[Category:Vapoursynth Filters]]&lt;/div&gt;</summary>
		<author><name>Selur</name></author>
	</entry>
</feed>