TBilateral - Revision history

Reel.Deal: add note

2022-11-24T20:09:43Z

add note

← Older revision		Revision as of 22:09, 24 November 2022
Line 9:		Line 9:

	== Description ==		== Description ==
	[[TBilateral]] is a spatial smoothing filter that uses the bilateral filtering algorithm. It does a nice job of smoothing while retaining picture structure. It currently supports YV12 and YUY2 colorspaces and has a GUI with preview to help with tweaking.		[[TBilateral]] is a spatial smoothing filter that uses the bilateral filtering algorithm. It does a nice job of smoothing while retaining picture structure. It currently supports YV12 and YUY2 colorspaces and has a GUI with preview to help with tweaking.
			<br>
			<br>
			<span style="color:red">'''Note: [[vsTBilateral]] is recommended as a modern replacement for TBilateral.'''</span>
	<br>		<br>
	<br>		<br>

Reel.Deal: /* Archived Downloads */

2020-06-25T08:22:11Z

Archived Downloads

← Older revision		Revision as of 10:22, 25 June 2020
Line 172:		Line 172:
	!v0.9.11(x86/x64)		!v0.9.11(x86/x64)
	\|[https://web.archive.org/web/20200522182801if_/https://files.videohelp.com/u/223002/TBilateral_0911_32_64.7z TBilateral_0911_32_64.7z]		\|[https://web.archive.org/web/20200522182801if_/https://files.videohelp.com/u/223002/TBilateral_0911_32_64.7z TBilateral_0911_32_64.7z]
	\|[https://web.archive.org/web/~~20191106173119~~/http://www.iol.ie/%7Eschubert/gas/TBilateral.7z TBilateral.7z] /// [https://www.mediafire.com/file/neia4gpkojppi8n/TBilateral.7z/file MediaFire]		\|[https://web.archive.org/web/20191106173119if_/http://www.iol.ie/%7Eschubert/gas/TBilateral.7z TBilateral.7z] /// [https://www.mediafire.com/file/neia4gpkojppi8n/TBilateral.7z/file MediaFire]
	\|-		\|-
	!v0.9.11		!v0.9.11
	\|[~~http~~://web.archive.org/web/~~20140420184500~~/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]		\|[https://web.archive.org/web/20140420184500if_/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]
	\|		\|
	\|}		\|}

Reel.Deal: /* Archived Downloads */

2020-06-25T08:21:34Z

Archived Downloads

← Older revision		Revision as of 10:21, 25 June 2020
Line 175:		Line 175:
	\|-		\|-
	!v0.9.11		!v0.9.11
	~~\|<strike>[http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]</strike>~~
	\|[http://web.archive.org/web/20140420184500/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]		\|[http://web.archive.org/web/20140420184500/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]
			\|
	\|}		\|}
	* x86/x84 version compiled by [https://forum.doom9.org/showthread.php?t=173259 Groucho2004].		* x86/x84 version compiled by [https://forum.doom9.org/showthread.php?t=173259 Groucho2004].

Reel.Deal: /* Requirements */

2020-05-24T01:44:15Z

Requirements

← Older revision		Revision as of 03:44, 24 May 2020
Line 13:		Line 13:
	<br>		<br>
	== Requirements ==		== Requirements ==
	* [x86]: [[AviSynth+]] or [~~http~~://~~forum~~.~~doom9.org~~/~~showthread.php?t=168764~~ AviSynth 2.6]		* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
	* [x64]: [[AviSynth+]]		* [x64]: [[AviSynth+]]
	* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F\|Progressive]] input only		* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F\|Progressive]] input only
	* Supported color formats: [[YUY2]], [[YV12]]		* Supported color formats: [[YUY2]], [[YV12]]
	<br>		<br>

	== [[Script variables\|Syntax and Parameters]] ==		== [[Script variables\|Syntax and Parameters]] ==
	:{{Template:FuncDef\| TBilateral (clip, int "diameterL", int "diameterC", float "sDevL", float "sDevC", float "iDevL", float "iDevC", float "csL", float "csC", bool "d2", bool "chroma", bool "gui", clip "ppClip", int "kernS", int "kernI", int "resType")}}		:{{Template:FuncDef\| TBilateral (clip, int "diameterL", int "diameterC", float "sDevL", float "sDevC", float "iDevL", float "iDevC", float "csL", float "csC", bool "d2", bool "chroma", bool "gui", clip "ppClip", int "kernS", int "kernI", int "resType")}}

Reel.Deal: add x64 version and add archived links

2020-05-24T00:57:01Z

add x64 version and add archived links

← Older revision		Revision as of 02:57, 24 May 2020
Line 1:		Line 1:
	{{~~FilterCat4~~\|External_filters\|Plugins\|Denoisers\|Spatial_denoisers}}		{{FilterCat5\|External_filters\|Plugins\|Plugins_x64\|Denoisers\|Spatial_denoisers}}
	{{Filter3		{{Filter3
	\| {{Author/tritical}}		\| {{Author/tritical}}
	\| v0.9.11		\| v0.9.11
	\| [~~http~~://web.archive.org/web/~~20151125175557~~/~~http~~://~~bengal~~.~~missouri~~.~~edu~~/~~~kes25c/TBilateralv0911.zip TBilateralv0911.zip] [http:~~//~~www.iol~~.~~ie/~schubert/gas/gas~~.~~html TBilateralv0911 32&64 bit~~]		\| [https://web.archive.org/web/20200522182801if_/https://files.videohelp.com/u/223002/TBilateral_0911_32_64.7z TBilateral_0911_32_64.7z]
	\| Spatial Denoisers		\| Spatial Denoisers
	\| [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]		\| [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
Line 9:		Line 9:

	== Description ==		== Description ==
	TBilateral is a spatial smoothing filter that uses the bilateral filtering algorithm. It does a nice job of smoothing while retaining picture structure. It currently supports YV12 and YUY2 colorspaces and has a GUI with preview to help with tweaking.		[[TBilateral]] is a spatial smoothing filter that uses the bilateral filtering algorithm. It does a nice job of smoothing while retaining picture structure. It currently supports YV12 and YUY2 colorspaces and has a GUI with preview to help with tweaking.
	<br>		<br>
	<br>		<br>
	== Requirements ==		== Requirements ==
	*AviSynth 2.~~5.8 or later~~		* [x86]: [[AviSynth+]] or [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6]
			* [x64]: [[AviSynth+]]
	* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F\|Progressive]] input only		* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F\|Progressive]] input only
	* Supported color formats: [[YUY2]], [[YV12]]		* Supported color formats: [[YUY2]], [[YV12]]
Line 167:		Line 168:
	!!width="150px"\| Download		!!width="150px"\| Download
	!!width="150px"\| Mirror		!!width="150px"\| Mirror
			\|-
			!v0.9.11(x86/x64)
			\|[https://web.archive.org/web/20200522182801if_/https://files.videohelp.com/u/223002/TBilateral_0911_32_64.7z TBilateral_0911_32_64.7z]
			\|[https://web.archive.org/web/20191106173119/http://www.iol.ie/%7Eschubert/gas/TBilateral.7z TBilateral.7z] /// [https://www.mediafire.com/file/neia4gpkojppi8n/TBilateral.7z/file MediaFire]
	\|-		\|-
	!v0.9.11		!v0.9.11
Line 172:		Line 177:
	\|[http://web.archive.org/web/20140420184500/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]		\|[http://web.archive.org/web/20140420184500/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]
	\|}		\|}
			* x86/x84 version compiled by [https://forum.doom9.org/showthread.php?t=173259 Groucho2004].
	<br>		<br>

Groucho2004 at 09:46, 15 February 2019

2019-02-15T09:46:11Z

← Older revision		Revision as of 11:46, 15 February 2019
Line 3:		Line 3:
	\| {{Author/tritical}}		\| {{Author/tritical}}
	\| v0.9.11		\| v0.9.11
	\| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]		\| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip] [http://www.iol.ie/~schubert/gas/gas.html TBilateralv0911 32&64 bit]
	\| Spatial Denoisers		\| Spatial Denoisers
	\| [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]		\| [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]

Reel.Deal: archived link

2016-02-14T02:19:19Z

archived link

← Older revision		Revision as of 04:19, 14 February 2016
Line 3:		Line 3:
	\| {{Author/tritical}}		\| {{Author/tritical}}
	\| v0.9.11		\| v0.9.11
	\| [http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]		\| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]
	\| Spatial Denoisers		\| Spatial Denoisers
	\| [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]		\| [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
	\|6=[http://forum.doom9.org/showthread.php?t=77856 Doom9 Thread]}}		\|6=[http://forum.doom9.org/showthread.php?t=77856 Doom9 Thread]}}
	~~<br>~~
	== Description ==		== Description ==
	TBilateral is a spatial smoothing filter that uses the bilateral filtering algorithm. It does a nice job of smoothing while retaining picture structure. It currently supports YV12 and YUY2 colorspaces and has a GUI with preview to help with tweaking.		TBilateral is a spatial smoothing filter that uses the bilateral filtering algorithm. It does a nice job of smoothing while retaining picture structure. It currently supports YV12 and YUY2 colorspaces and has a GUI with preview to help with tweaking.
Line 169:		Line 169:
	\|-		\|-
	!v0.9.11		!v0.9.11
	\|[http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]		\|<strike>[http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]</strike>
	\|[http://web.archive.org/web/20140420184500/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]		\|[http://web.archive.org/web/20140420184500/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]
	\|}		\|}

Reel.Deal: /* Syntax and Parameters */ minor edits

2014-12-10T01:11:07Z

Syntax and Parameters: minor edits

← Older revision		Revision as of 03:11, 10 December 2014
Line 58:		Line 58:
	::{{Par2\|gui\|bool\|false}}		::{{Par2\|gui\|bool\|false}}
	:::If set to true, then this instance of TBilateral will start with a gui. Only one instance of TBilateral per script can have a GUI.		:::If set to true, then this instance of TBilateral will start with a gui. Only one instance of TBilateral per script can have a GUI.
	:::The GUI allows you to change the values of diameterL/diameterC/sDevL/sDevC/iDevL/iDevC/csL/csC/d2/chroma/kernS/kernI/resType (basically every setting).		:::The GUI allows you to change the values of diameterL / diameterC / sDevL / sDevC / iDevL / iDevC / csL / csC / d2 / chroma / kernS / kernI / resType (basically every setting).
	:::The GUI also has a real time updating preview which allows you to see the effect of changes as you make them.		:::The GUI also has a real time updating preview which allows you to see the effect of changes as you make them.

Line 90:		Line 90:

	:::See the following paper for a description of all the kernels and their properties:		:::See the following paper for a description of all the kernels and their properties:
	:::*[https://web.archive.org/web/20050412091058/http://dsp7.ee.uct.ac.za/~jfrancis/publicationsDir/PRASA2003.pdf ~~http://dsp7.ee.uct.ac.za/~jfrancis/publicationsDir/PRASA2003~~.pdf]		:::*[https://web.archive.org/web/20050412091058/http://dsp7.ee.uct.ac.za/~jfrancis/publicationsDir/PRASA2003.pdf The Bilateral Median Filter.pdf]
	:::Gaussian (option 2) is the kernel used by the default (first proposed) bilateral filter.		:::Gaussian (option 2) is the kernel used by the default (first proposed) bilateral filter.
	<br>		<br>
Line 104:		Line 104:
	:::Option 0 (weighted average) is the type used by the default bilateral filter.		:::Option 0 (weighted average) is the type used by the default bilateral filter.
	<br>		<br>

	== Examples ==		== Examples ==
	TBilateral with default settings:		TBilateral with default settings:

Reel.Deal: TBilateral

2014-11-23T13:54:48Z

TBilateral

New page

{{FilterCat4|External_filters|Plugins|Denoisers|Spatial_denoisers}}
{{Filter3
| {{Author/tritical}}
| v0.9.11
| [http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]
| Spatial Denoisers
| [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|6=[http://forum.doom9.org/showthread.php?t=77856 Doom9 Thread]}}
 
== Description ==
TBilateral is a spatial smoothing filter that uses the bilateral filtering algorithm. It does a nice job of smoothing while retaining picture structure. It currently supports YV12 and YUY2 colorspaces and has a GUI with preview to help with tweaking.
 
 
== Requirements ==
*AviSynth 2.5.8 or later
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
* Supported color formats: [[YUY2]], [[YV12]]
 
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef| TBilateral (clip, int "diameterL", int "diameterC", float "sDevL", float "sDevC", float "iDevL", float "iDevC", float "csL", float "csC", bool "d2", bool "chroma", bool "gui", clip "ppClip", int "kernS", int "kernI", int "resType")}}
 
::{{Par2| |clip| }}
:::Input clip.
 
::{{Par2|diameterL|int|5}}
::{{Par2|diameterC|int|5}}
:::Spatial diameters: this sets the size of the diameter of the filtering window.
:::Larger values mean more pixels will be included in the average, but are also slower. Must be an odd number greater than 1.
:::diameterL is for luma and diameterC is for chroma if it is being processed. This must be less than the width of the video and less than the height of the video.
 
::{{Par2|sDevL|float|1.4}}
::{{Par2|sDevC|float|1.4}}
:::Spatial (domain) deviations; these set the spatial deviations.
:::The larger sDev is, the less effect distance will have in the weighting of pixels in the average. That is, as you increase sDev distant pixels will have more weight. sDevL is for luma and sDevC is for chroma.
:::These must be greater than 0. To get a better idea of what these settings do try setting iDevL/iDevC to high values, and then gradually increase sDevL/sDevC from 0 on up while keeping iDevL/iDevC constant. Increasing these settings will increase the strength of the smoothing.
 
::{{Par2|iDevL|float|7.0}}
::{{Par2|iDevC|float|7.0}}
:::Pixel intensity (range) deviations; these set the pixel intensity deviations (or color deviations in the case of the chroma planes).
:::The larger iDev is, the less effect pixel difference will have in the weighting of pixels in the average. That is, as you increase iDev pixels that are very different from the current pixel will have more weight. iDevL is for luma and iDevC is for chroma.
:::These must be greater than 0. Try increasing these settings while keeping sDev/sDevC constant to get a better idea of what these do. Increasing these settings will increase the strength of the smoothing.
 
::{{Par2|csL|float|1.0}}
::{{Par2|CSC|float|1.0}}
:::Center pixel weight multipliers; these values are multiplied to the center pixel's spatial weight value.
:::A value of 1 does nothing, < 1 means the center pixel will have less weight than normal, > 1 means the center pixel will have more weight than normal, 0 gives the center pixel no weight.
:::These must be at least 0. Setting csL/csC to 0 will give you SUSAN denoising.
 
::{{Par2|d2|bool|false}}
:::Second derivative or first derivative. If set to true, this setting makes TBilateral use the second derivative instead of the first when doing the intensity calculations.
:::Using d2 should give better results on smooth gradients or anything that fits the piecewise linear model. Setting d2 to false will give better results on images that have uniformly colored areas with sharp edges (anything that fits the piecewise constant model).
:::The actual difference between the two is usually not big for most sources. The effect is rather subtle.
 
::{{Par2|chroma|bool|true}}
:::Enable/disable chroma processing.
:::If set to true the chroma planes are processed. If set to false the chroma planes from the source are simply copied to the final output frame.
 
::{{Par2|gui|bool|false}}
:::If set to true, then this instance of TBilateral will start with a gui. Only one instance of TBilateral per script can have a GUI.
:::The GUI allows you to change the values of diameterL/diameterC/sDevL/sDevC/iDevL/iDevC/csL/csC/d2/chroma/kernS/kernI/resType (basically every setting).
:::The GUI also has a real time updating preview which allows you to see the effect of changes as you make them.

:::The GUI does have some restrictions though. The diameterL/diameterC values are currently limited to a maximum of 21 when using the GUI interface.
:::Also, the Dev sliders have maximum limits associated with them to allow the use of the slider bars to tweak them. However, these maximums should be plenty high to allow even very strong filtering.

:::After you have found the settings you want you can close the GUI by hitting the "OK" button.
:::At the bottom of the advanced tab there is string which you can copy and paste in your avs script to duplicate the current settings. (NOTE: the ppClip parameter is not set in this string)
 
::{{Par2|ppClip|clip|NULL}}
:::Specifies a pre-filtered clip for TBilateral to take pixel values from when doing the luminance difference calculations.
:::The general recommendation for pre-processing is a Gaussian blur with standard deviation equal to the sDev settings being used.
:::Using a prefiltered clip should help in removing impulse noise (i.e. outliers with very large pixel differences) which standard bilateral filtering will not touch.
:::It does tend to produce artifacts sometimes, especially around very fine details. Another recommendation for pre-processing is a center-weighted median or adaptive median.
 
::{{Par2|kernS|int|2}}
::{{Par2|kernI|int|2}}
:::(domain (spatial) and range (intensity) kernels); these specify what kernel is used for the domain (kernS) weights and range (kernI) weights.
:::The possible choices are:

::::*0 - Andrews' wave
::::*1 - El Fallah Ford
::::*2 - Gaussian
::::*3 - Huber’s mini-max
::::*4 - Lorentzian
::::*5 - Tukey bi-weight
::::*6 - Linear descent
::::*7 - Cosine
::::*8 - Flat
::::*9 - Inverse

:::See the following paper for a description of all the kernels and their properties:
:::*[https://web.archive.org/web/20050412091058/http://dsp7.ee.uct.ac.za/~jfrancis/publicationsDir/PRASA2003.pdf http://dsp7.ee.uct.ac.za/~jfrancis/publicationsDir/PRASA2003.pdf]
:::Gaussian (option 2) is the kernel used by the default (first proposed) bilateral filter.
 
::{{Par2|resType|int|0}}
:::This specifies how the weights and pixel values are combined to obtain the final result.
:::Possible options:

::::*0 - Mean (weighted average)
::::*1 - Median (weighted median)
::::*2 - CW-Median (weighted median + extra center pixel weight)
::::*3 - MLR (multiple linear regression) (best fit plane)

:::Option 0 (weighted average) is the type used by the default bilateral filter.
 
== Examples ==
TBilateral with default settings:
[[AviSource]]("Blah.avi")
TBilateral (diameterL=5, diameterC=5, sDevL=1.4, sDevC=1.4, iDevL=7.0, iDevC=7.0, \
csL=1.0, csC=1.0, d2=false, chroma=true, gui=false, kernS=2, kernI=2, resType=0)
 
== Changelog ==
<pre>05/16/2006 v0.9.11
+ added resType 3, MLR (multiple linear regression)
+ some internal changes and code cleanup
- fixed a problem with the sse2 yuy2 packed to planar and planar to packed conversions
that could sometimes (very rarely) cause crashes with yuy2 input
- fixed IDC_IKERND combobox being set to dropdown instead of dropdownlist

06/23/2005 v0.9.10
+ some optimizations, roughly 15-20% speed increase

06/21/2005 v0.9.9
+ Added Inverse kernel (what was called "Linear Descent" in v0.9.8 was, in fact, "Inverse")
- Fixed a bug in the gui routine that set the sDevL/sDevC slider maximums

06/20/2005 v0.9.8
+ Added kernS, kernI, and resType
+ Redid the gui interface
- Lots of cosmetic fixes for the gui (for some options it wouldn't immediately update on change)

05/24/2005
+ Added ppClip parameter and processing
- Changed some default values
- Fixed a few thread sync/exit problems with the gui code

05/02/2005 v0.9.6
+ Added gui with preview
+ Removed all yuy2 restrictions (d2)
- Fixed iDev settings and sDev settings being switched when calculating the weight tables (doh!)

06/16/2004 v0.9.5
- Fixed iDevC having an i instead of f inside the function param list and only excepting integer values.

06/16/2004 v0.9.4
- Fixed the rounding errors with d2 = true, which could have led to +-2 change in the final pixel values
- The change needed for the rounding fix also sped up d2 = true processing 10-15%

06/15/2004 v0.9.3
- Added d2 and centerScale/centerScaleC parameters.
- Unrolled yloops, no real speed up, but it did make the code huge...

06/12/2004 v0.9.2
- Unrolled xloops in YV12 and the luma only version of YUY2. Slight speed up.

06/11/2004 v0.9.1
- Fixed a problem with boundary pixels near the edges of the picture getting incorrect spatial weights.

06/11/2004 v0.9.0
- Initial Release</pre>
 
== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v0.9.11
|[http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]
|[http://web.archive.org/web/20140420184500/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip TBilateralv0911.zip]
|}
 

==External Links ==
*[http://forum.doom9.org/showthread.php?t=77856 Doom9 Forum] - TBilateral discussion. 
 
 
-----------------------------------------------
'''Back to [[External_filters#Spatial_Denoisers|External Filters]] ←'''