MosquitoNR

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m (Requirements)
m (minor reformatting, category)
Line 1: Line 1:
{{FilterCat|External_filters|Restoration_filters|Deringing & Mosquito Noise}}
+
{{FilterCat4|External_filters|Plugins|Restoration_filters|Deringing & Mosquito Noise}}
{{Filter2
+
{{Filter3
 
|{{Author/b_inary}}
 
|{{Author/b_inary}}
 
|v0.10
 
|v0.10
Line 6: Line 6:
 
|Deringing & Mosquito Noise
 
|Deringing & Mosquito Noise
 
|[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=167582 Doom9 Thread]}}
 
== Description ==
 
== Description ==
:MosquitoNR is a noise reduction filter designed for mosquito noise, which is often caused by lossy compression such as MPEG.  
+
MosquitoNR is a noise reduction filter designed for mosquito noise, which is often caused by lossy compression such as MPEG.<br>
:This filter works as follows:
+
This filter works as follows:
  
::1. Compute low frequency components of the image.
+
:1. Compute low frequency components of the image.
::2. Apply direction-aware blur (smoothing). This blur effectively reduces compression artifacts, but also breaks detail.
+
:2. Apply direction-aware blur (smoothing). This blur effectively reduces compression artifacts, but also breaks detail.
::3. Restore the low frequency components to the blurred image.
+
:3. Restore the low frequency components to the blurred image.
  
:MosquitoNR processes luma only, to correctly process chroma take a look at the [[MosquitoNR#Examples|example]] below.
+
MosquitoNR processes luma only, to correctly process chroma take a look at the [[MosquitoNR#Examples|example]] below.<br>
 
<br>
 
<br>
 
== Requirements ==
 
== Requirements ==
:- AviSynth 2.5.8 or [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6.0 Alpha5] or greater
+
* AviSynth 2.5.8 or [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6.0 Alpha5] or greater
:- [[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]], [[YV16]], [[YV24]], [[YV411]], [[Y8]]
+
* Supported color formats: [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], [[Y8]]
:: <span style="color:red">**</span> If you're using AviSynth 2.5.8, [[YUY2]] and [[YV12]] will be the only colorspaces supported.
+
: <span style="color:red">**</span> If you're using AviSynth 2.5.8, [[YUY2]] and [[YV12]] will be the only colorspaces supported.
  
:- CPU with [[SSE2]] support
+
* CPU with [[SSE2]] support
 
<br>
 
<br>
  
 
== [[Script variables|Syntax and Parameters]] ==
 
== [[Script variables|Syntax and Parameters]] ==
 
:{{Template:FuncDef|MosquitoNR (''clip'', ''int'' "strength", ''int'' "restore", ''int'' "radius", ''int'' "threads")}}
 
:{{Template:FuncDef|MosquitoNR (''clip'', ''int'' "strength", ''int'' "restore", ''int'' "radius", ''int'' "threads")}}
 +
<br>
 +
::{{Par2| |clip| }}
 +
:::Input clip
 
<br>
 
<br>
 
::{{Par2|strength|int|16}}
 
::{{Par2|strength|int|16}}
 
:::Range: 0 - 32
 
:::Range: 0 - 32
 
::::Sets the strength of the blur.
 
::::Sets the strength of the blur.
:::::Setting this value higher brings stronger noise reduction effect, but side effect will also become stronger.
+
::::Setting this value higher brings stronger noise reduction effect, but side effect will also become stronger.
 
<br>
 
<br>
 
::{{Par2|restore|int|128}}
 
::{{Par2|restore|int|128}}
 
:::Range: 0 - 128
 
:::Range: 0 - 128
 
::::Sets the rate of restoring.  
 
::::Sets the rate of restoring.  
:::::If set to 0, no restoring is performed.  
+
::::If set to 0, no restoring is performed.  
:::::If set to 128, low frequency components of the blurred image is completely replaced with those of the original image, and runs slightly faster.
+
::::If set to 128, low frequency components of the blurred image is completely replaced with those of the original image, and runs slightly faster.
 
<br>
 
<br>
 
::{{Par2|radius|int|2}}
 
::{{Par2|radius|int|2}}
 
:::Range: 1 - 2
 
:::Range: 1 - 2
 
::::Sets the radius of the blur.  
 
::::Sets the radius of the blur.  
:::::1 is faster, but will have insufficient effect in some cases.
+
::::1 is faster, but will have insufficient effect in some cases.
 
<br>
 
<br>
 
::{{Par2|threads|int|0}}
 
::{{Par2|threads|int|0}}
 
:::Range: 0 - 32
 
:::Range: 0 - 32
 
::::Controls how many threads are used.
 
::::Controls how many threads are used.
:::::By default, threads is set equal to automatically detected number of processors.
+
::::By default, threads is set equal to automatically detected number of processors.
:::::Since this filter needs a lot of memory access, thread efficiency is not very good. Setting this value lower might improve overall processing speed.
+
::::Since this filter needs a lot of memory access, thread efficiency is not very good. Setting this value lower might improve overall processing speed.
 
<br>
 
<br>
 
== Examples ==
 
== Examples ==
Line 81: Line 84:
  
  
== Links ==
+
==Extenal Links ==
 
*[http://forum.doom9.org/showthread.php?t=167582 Doom9 Forum] - MosquitoNR discussion.
 
*[http://forum.doom9.org/showthread.php?t=167582 Doom9 Forum] - MosquitoNR discussion.
<br>
 
 
<br>
 
<br>
 
<br>
 
<br>
 
-----------------------------------------------
 
-----------------------------------------------
 
'''Back to [[External_filters#Deringing_.26_Mosquito_Noise|External Filters]] &larr;'''
 
'''Back to [[External_filters#Deringing_.26_Mosquito_Noise|External Filters]] &larr;'''

Revision as of 15:31, 20 September 2014

Abstract
Author b_inary
Version v0.10
Download mosquito_nr_avisynth.zip
Category Deringing & Mosquito Noise
License GPLv2
Discussion Doom9 Thread

Contents

Description

MosquitoNR is a noise reduction filter designed for mosquito noise, which is often caused by lossy compression such as MPEG.
This filter works as follows:

1. Compute low frequency components of the image.
2. Apply direction-aware blur (smoothing). This blur effectively reduces compression artifacts, but also breaks detail.
3. Restore the low frequency components to the blurred image.

MosquitoNR processes luma only, to correctly process chroma take a look at the example below.

Requirements

** If you're using AviSynth 2.5.8, YUY2 and YV12 will be the only colorspaces supported.
  • CPU with SSE2 support


Syntax and Parameters

MosquitoNR (clip, int "strength", int "restore", int "radius", int "threads")


clip   =
Input clip


int  strength = 16
Range: 0 - 32
Sets the strength of the blur.
Setting this value higher brings stronger noise reduction effect, but side effect will also become stronger.


int  restore = 128
Range: 0 - 128
Sets the rate of restoring.
If set to 0, no restoring is performed.
If set to 128, low frequency components of the blurred image is completely replaced with those of the original image, and runs slightly faster.


int  radius = 2
Range: 1 - 2
Sets the radius of the blur.
1 is faster, but will have insufficient effect in some cases.


int  threads = 0
Range: 0 - 32
Controls how many threads are used.
By default, threads is set equal to automatically detected number of processors.
Since this filter needs a lot of memory access, thread efficiency is not very good. Setting this value lower might improve overall processing speed.


Examples

MosquitoNR with default settings:

AviSource("Blah.avi")
MosquitoNR(strength=16, restore=128, radius=2, threads=0)


MosquitoNR processes only luma. If you want to process chroma too, you can write a script like the following, but there might be no noticeable change.

AviSource("Blah.avi")
MosquitoNR()
u = UtoY().MosquitoNR()  # In AviSynth 2.6, UtoY8() may be faster
v = VtoY().MosquitoNR()
YtoUV(u, v, last)


Changelog

Version      Date            Changes
v0.10 2013/03/14 - fixed a crash with AviSynth MT - added support for YV16, YV24, Y411, Y8 - some speed optimizations - added English documentation
v120210 2012/02/10 - initial release


Acknowledgments

This filter is a combination of flash3kyuu's AviUtl plugin "smoothing filter" and nilpo's AviUtl plugin "low frequency components protection filter".
This combination was proposed by POP@4bit. I thank all of them very much.


Extenal Links




Back to External Filters

Personal tools