Temporal Degrain

Latest revision as of 01:20, 7 June 2020

Abstract
Author	Didée, Sagekilla
Version	1.23
Download	TemporalDegrain.avs
Category	Denoisers
License
Discussion

[edit] 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, FastDegrain can filter just as well.

[edit] Requirements

AviSynth 2.5.8 or greater
Progressive input only
Supported color formats: YV12

[edit] Required Plugins

Latest versions of the following filters are recommended unless stated otherwise.

FFT3DFilter or FFT3DGPU
hqdn3d
MaskTools2
MVTools
~~RemoveGrain and Repair - part of the RemoveGrain v1.0b package.~~
RgTools - recommended drop-in replacement for RemoveGrain & Repair!

[edit] 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

[edit] 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.
AviSource("blah.avi"
TemporalDegrain(degrain=1, ov=2, hq=1)

[edit] External Links

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
Doom9 Forum - Need Suggestions for a very grainy source.
Doom9 Forum - Suggestion for "TemporalDegrain" for HD contents.

@@ Line 1: / Line 1: @@
-{{Filter|Didee, Sagekilla|1.23|[[Media:TemporalDegrain.avs|TemporalDegrain.avs]]|Denoisers|
+{{FilterCat4|External_filters|Scripts|Denoisers|Spatial-Temporal_Denoisers}}
-* YV12
+{{Filter3
+|{{Author/Didée}}, Sagekilla
+|1.23
+|[[Media:TemporalDegrain.avs|TemporalDegrain.avs]]
+|Denoisers
+|
 |}}
-{{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 [http://en.wikipedia.org/wiki/300_%28film%29 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, [[FastDegrain]] can filter just as well.
+<br>
+<br>
+== Requirements ==
+* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
+* [[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 Plugins====
+Latest versions of the following filters are recommended unless stated otherwise.<br>
+* [[FFT3DFilter]] or [[FFT3DGPU]]
+* [[hqdn3d]]
+* [[MaskTools2]]
+* [[MVTools]]
+*<strike>RemoveGrain and Repair - part of the [[RemoveGrain v1.0b]] package.</strike>
+*[[RgTools]] - recommended drop-in replacement for RemoveGrain & Repair!
+<br>
+== [[Script variables|Syntax and Parameters]] ==
+:{{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>
+::{{Par2|input|clip| }}
+:::Input clip.
-== Abstract ==
+::{{Par2|denoise|clip|null}}
-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.
+:::Denoised clip for detecting motion vectors. Defining this automatically disables FFT3DFilter.
-=== Requires Filters ===
+::{{Par2|GPU|bool|false}}
-*[[Removegrain|RemoveGrain]] 1.x
+:::True enables GPU based prefiltering.
-*[[MaskTools2]]
-*[[MVTools2]]
-*[[FFT3DFilter]] or [[FFT3DGPU]]
-*[[Repair]] (part of the Remove Grain package)
-*[[HQdn3D]]
-== Description ==
+::{{Par2|sigma|int|16}}
-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.
+:::FFT3D filtering strength; default works fine in most cases.
-{{Par|denoise|clip|null}}
+::{{Par2|bw|int|16}}
-Denoised clip for detecting motion vectors. Defining this automatically disables FFT3DFilter.
+:::FFT3D block width.
-{{Par|GPU|bool|false}}
+::{{Par2|bh|int|16}}
-Enables GPU based prefiltering
+:::FFT3D block height.
-{{Par|sigma|int|16}}
+::{{Par2|blksize|int|8}}
-FFT3D filtering strength. Default works fine in most cases.
+:::MAnalyse block size.
-{{Par|bw|int|16}}
+::{{Par2|pel|int|2}}
-FFT3D block width.
+:::MAnalyse subpixel accuracy.
-{{Par|bh|int|16}}
+::{{Par2|ov|int|blksize/2}}
-FFT3D block height.
+:::MAnalyse block overlap.
-{{Par|blksize|int|8}}
+::{{Par2|degrain|int|2}}
-MAnalyse block size.
+:::MDegrain with 1, 2, or 3 vectors.
-{{Par|pel|int|2}}
+::{{Par2|SAD1|int|400}}
-MAnalyse subpixel accuracy.
+:::MDegrain stage 1 thSAD.
-{{Par|ov|int|blksize/2}}
+::{{Par2|SAD2|int|300}}
-MAnalyse block overlap.
+:::MVDegrain stage 2 thSAD.
-{{Par|degrain|int|2}}
-MDegrain with 1, 2, or 3 vectors.
-{{Par|SAD1|int|400}}
-MDegrain stage 1 thSAD.
-{{Par|SAD2|int|300}}
-MVDegrain stage 2 thSAD.
-{{Par|HQ|int|1}}
-Adjusts filtering level. 0 Disables any prefiltering (not recommended), 1 adds extra prefiltering, and 2 adds a post processing step to denoising.
+::{{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 ==
 <pre>
 # Useful for denoising HD material at decent speeds
-Avisource("blah.avi")
+AviSource("blah.avi")
 TemporalDegrain(degrain=3, ov=4, blksize=16)
 </pre>
@@ Line 67: / Line 83: @@
 <pre>
 # Faster processing than defaults with a manageable decrease in quality.
-SetMTMode(2,2)
+AviSource("blah.avi"
-Avisource("blah.avi"
 TemporalDegrain(degrain=1, ov=2, hq=1)
 </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>
-Download [[Media: FastDegrain.avs|FastDegrain.avs]] Quick alias for MDegrain(1|2|3) with optional sharpening <br>
+*Download [[Media: FastDegrain.avs|FastDegrain.avs]] Quick alias for MDegrain(1|2|3) with optional sharpening <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_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]
+*[http://forum.doom9.org/showthread.php?t=132310 Doom9 Forum] - Need Suggestions for a very grainy source.
-[[Category:External filters]]
+*[http://forum.doom9.org/showthread.php?t=136433 Doom9 Forum] - Suggestion for "TemporalDegrain" for HD contents.

Temporal Degrain

Latest revision as of 01:20, 7 June 2020

Contents

[edit] Description

[edit] Requirements

[edit] Required Plugins

[edit] Syntax and Parameters

[edit] Examples

[edit] External Links

Views

Personal tools

Navigation

community

in other languages

Search

Tools