Temporal Degrain: Difference between revisions

From Avisynth wiki
Jump to navigationJump to search
← Older editNewer edit →

Reel.Deal (talk | contribs)

1 user group
5,521 edits
quick reformatting
Line 1: Line 1:
{{Filter|Didee, Sagekilla|1.23|[[Media:TemporalDegrain.avs|TemporalDegrain.avs]]|Denoisers|
{{FilterCat4|External_filters|Plugins|Denoisers|Spatio-temporal_denoisers}}
* YV12
{{Filter
|Didee, Sagekilla
|1.23
|[[Media:TemporalDegrain.avs|TemporalDegrain.avs]]
|Denoisers
|* YV12
|}}
|}}
{{Template:FuncDef| TemporalDegrain ( clip input, clip "denoise", bool "GPU", int "sigma", int "bw", int "bh", int "pel", int "blksize", int "ov", int "degrain", int "limit" int "SAD1", int "SAD2", int "HQ" )}}
== Description ==
 
Temporal Degrain is a very slow, multi-stage temporal denoiser originally created for killing the dancing grain present in 300. It works by generating (or having the user specify) a calm search clip with almost no noise to ruin motion vector search. Then, two stages of denoising are done using MDegrain which is limited by our denoised clip. Then, the end result has contra-sharpening applied to sharpen the image to no more than what was present before.
 
 
 


== Abstract ==
Temporal Degrain works as a simple temporal degraining function that will remove MOST grain from video sources, including dancing grain, like the grain found on 300. Is currently capable of utilizing MVDegrain 1, 2, or 3. Also note, the parameters don't need to be tweaked much as the default settings provide very good denoising. Use of TD is only recommended where highest quality filtering (least grain/noise, and highest detail retained) is needed. Otherwise, [[Fast Degrain]] can filter just as well.
Temporal Degrain is a very slow, multi-stage temporal denoiser originally created for killing the dancing grain present in 300. It works by generating (or having the user specify) a calm search clip with almost no noise to ruin motion vector search. Then, two stages of denoising are done using MDegrain which is limited by our denoised clip. Then, the end result has contra-sharpening applied to sharpen the image to no more than what was present before.
<br>
<br>
== 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: [[YV12]]


=== Required Filters ===
====Required Plugins====
* [[RemoveGrain]] 1.x
* RemoveGrain and Repair (part of the [[RemoveGrain v1.0b]] package)
* Repair (part of the [[RemoveGrain]] package)
* [[MaskTools2]]
* [[MaskTools2]]
* MVTools2
* [[MVTools]]
* FFT3DFilter or FFT3DGPU
* [http://avisynth.org.ru/fft3dfilter/fft3dfilter.html FFT3DFilter] or [http://www.avisynth.nl/users/tsp/fft3dgpu0.8.2.7z FFT3DGPU]
* HQdn3D
* [http://akuvian.org/src/avisynth/hqdn3d/ HQdn3D]
 
<br>
== Description ==
== [[Script variables|Syntax and Parameters]] ==
Works as a simple temporal degraining function that'll remove MOST grain from video sources, including dancing grain, like the grain found on 300. Is currently capable of utilizing MVDegrain 1, 2, or 3. Also note, the parameters don't need to be tweaked much as the default settings provide very good denoising. Use of TD is only recommended where highest quality filtering (least grain/noise, and highest detail retained) is needed. Otherwise, [[Fast Degrain]] can filter just as well.
:{{Template:FuncDef| TemporalDegrain (clip input, clip "denoise", bool "GPU", int "sigma", int "bw", int "bh", int "pel", int "blksize", int "ov", int "degrain", int "limit" int "SAD1", int "SAD2", int "HQ" )}}
 
<br>
{{Par|denoise|clip|null}}
::{{Par2|input|clip| }}
Denoised clip for detecting motion vectors. Defining this automatically disables FFT3DFilter.
:::Input clip.


{{Par|GPU|bool|false}}
::{{Par2|denoise|clip|null}}
Enables GPU based prefiltering
:::Denoised clip for detecting motion vectors. Defining this automatically disables FFT3DFilter.


{{Par|sigma|int|16}}
::{{Par2|GPU|bool|false}}
FFT3D filtering strength. Default works fine in most cases.
:::True enables GPU based prefiltering.


{{Par|bw|int|16}}
::{{Par2|sigma|int|16}}
FFT3D block width.
:::FFT3D filtering strength; default works fine in most cases.


{{Par|bh|int|16}}
::{{Par2|bw|int|16}}
FFT3D block height.
:::FFT3D block width.


{{Par|blksize|int|8}}
::{{Par2|bh|int|16}}
MAnalyse block size.
:::FFT3D block height.


{{Par|pel|int|2}}
::{{Par2|blksize|int|8}}
MAnalyse subpixel accuracy.
:::MAnalyse block size.


{{Par|ov|int|blksize/2}}
::{{Par2|pel|int|2}}
MAnalyse block overlap.
:::MAnalyse subpixel accuracy.


{{Par|degrain|int|2}}
::{{Par2|ov|int|blksize/2}}
MDegrain with 1, 2, or 3 vectors.
:::MAnalyse block overlap.


{{Par|SAD1|int|400}}
::{{Par2|degrain|int|2}}
MDegrain stage 1 thSAD.
:::MDegrain with 1, 2, or 3 vectors.


{{Par|SAD2|int|300}}
::{{Par2|SAD1|int|400}}
MVDegrain stage 2 thSAD.
:::MDegrain stage 1 thSAD.


{{Par|HQ|int|1}}
::{{Par2|SAD2|int|300}}
Adjusts filtering level. 0 Disables any prefiltering (not recommended), 1 adds extra prefiltering, and 2 adds a post processing step to denoising.
:::MVDegrain stage 2 thSAD.


::{{Par2|HQ|int|1}}
:::Adjusts filtering level.
:::*0 : disables any prefiltering (not recommended)
:::*1 : adds extra prefiltering
:::*2 : adds a post processing step to denoising
<br>
== Examples ==
== Examples ==
<pre>
<pre>
Line 71: Line 83:
TemporalDegrain(degrain=1, ov=2, hq=1)
TemporalDegrain(degrain=1, ov=2, hq=1)
</pre>
</pre>
 
<br>
== Links ==
==External Links ==
Download [[Media: TemporalDegrain.avs|TemporalDegrain.avs]] Current stable version. (Recommended). <br>
Download [[Media: TemporalDegrain.avs|TemporalDegrain.avs]] Current stable version. (Recommended). <br>
Download [[Media: TemporalDegrain_beta.avs|TemporalDegrain_beta.avs]] New beta version featuring a gentle MDegrain limiter. <br>
Download [[Media: TemporalDegrain_beta.avs|TemporalDegrain_beta.avs]] New beta version featuring a gentle MDegrain limiter. <br>
Line 78: Line 90:
Download [[Media: TemporalDegrain_MT.avsi|TemporalDegrain_MT.avsi]] Alias for [[MT]]()'ing TemporalDegrain but using *single-threaded* prefilter clip. Useful when [[MT|SetMTMode]]() cannot be used.[http://forum.doom9.org/showthread.php?t=147540 Thread on doom9 forum] <br>
Download [[Media: TemporalDegrain_MT.avsi|TemporalDegrain_MT.avsi]] Alias for [[MT]]()'ing TemporalDegrain but using *single-threaded* prefilter clip. Useful when [[MT|SetMTMode]]() cannot be used.[http://forum.doom9.org/showthread.php?t=147540 Thread on doom9 forum] <br>
Download [[Media: TemporalDegrain_ChromaMod.avsi|TemporalDegrain_ChromaMod.avsi]] Allows all chroma processing to be disabled for big speed bonus with greyscale sources. [http://forum.doom9.org/showthread.php?t=147548 Thread on doom9 forum]
Download [[Media: TemporalDegrain_ChromaMod.avsi|TemporalDegrain_ChromaMod.avsi]] Allows all chroma processing to be disabled for big speed bonus with greyscale sources. [http://forum.doom9.org/showthread.php?t=147548 Thread on doom9 forum]
[[Category:External filters]]

Revision as of 19:13, 18 October 2014

Abstract
Author Didee, Sagekilla
Version 1.23
Download TemporalDegrain.avs
Category Denoisers
Requirements * YV12
License
Discussion

Description

Temporal Degrain is a very slow, multi-stage temporal denoiser originally created for killing the dancing grain present in 300. It works by generating (or having the user specify) a calm search clip with almost no noise to ruin motion vector search. Then, two stages of denoising are done using MDegrain which is limited by our denoised clip. Then, the end result has contra-sharpening applied to sharpen the image to no more than what was present before.

Temporal Degrain works as a simple temporal degraining function that will remove MOST grain from video sources, including dancing grain, like the grain found on 300. Is currently capable of utilizing MVDegrain 1, 2, or 3. Also note, the parameters don't need to be tweaked much as the default settings provide very good denoising. Use of TD is only recommended where highest quality filtering (least grain/noise, and highest detail retained) is needed. Otherwise, Fast Degrain can filter just as well.

Requirements

  • AviSynth 2.5.8 or later
  • Progressive input only
  • Supported color formats: YV12

Required Plugins


Syntax and Parameters

TemporalDegrain (clip input, clip "denoise", bool "GPU", int "sigma", int "bw", int "bh", int "pel", int "blksize", int "ov", int "degrain", int "limit" int "SAD1", int "SAD2", int "HQ" )


clip  input =
Input clip.
clip  denoise = null
Denoised clip for detecting motion vectors. Defining this automatically disables FFT3DFilter.
bool  GPU = false
True enables GPU based prefiltering.
int  sigma = 16
FFT3D filtering strength; default works fine in most cases.
int  bw = 16
FFT3D block width.
int  bh = 16
FFT3D block height.
int  blksize = 8
MAnalyse block size.
int  pel = 2
MAnalyse subpixel accuracy.
int  ov = blksize/2
MAnalyse block overlap.
int  degrain = 2
MDegrain with 1, 2, or 3 vectors.
int  SAD1 = 400
MDegrain stage 1 thSAD.
int  SAD2 = 300
MVDegrain stage 2 thSAD.
int  HQ = 1
Adjusts filtering level.
  • 0 : disables any prefiltering (not recommended)
  • 1 : adds extra prefiltering
  • 2 : adds a post processing step to denoising


Examples

# Useful for denoising HD material at decent speeds
Avisource("blah.avi")
TemporalDegrain(degrain=3, ov=4, blksize=16)

# Faster processing than defaults with a manageable decrease in quality.
SetMTMode(2,2)
Avisource("blah.avi"
TemporalDegrain(degrain=1, ov=2, hq=1)


Download TemporalDegrain.avs Current stable version. (Recommended).
Download TemporalDegrain_beta.avs New beta version featuring a gentle MDegrain limiter.
Download FastDegrain.avs Quick alias for MDegrain(1|2|3) with optional sharpening
Download TemporalDegrain_MT.avsi Alias for MT()'ing TemporalDegrain but using *single-threaded* prefilter clip. Useful when SetMTMode() cannot be used.Thread on doom9 forum
Download TemporalDegrain_ChromaMod.avsi Allows all chroma processing to be disabled for big speed bonus with greyscale sources. Thread on doom9 forum

Retrieved from "http://www.avisynth.nl/index.php?title=Temporal_Degrain&oldid=4805"