BucketMedian

Revision as of 11:47, 14 July 2014

Description

BucketMedian is an implementation of spatial median filter adapting bucket(counting) sort algorithm. Also induces BMBorderProc.avsi, a script to safely process broders with MedianBucket.

Requirements

- AviSynth 2.6.0 Alpha5 or greater

- Supported color formats: Y8, YV12, YV16, YV24, YV411

** If you're using AviSynth 2.5.8, YV12 will be the only colorspace supported.

- Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)

Syntax and Parameters

BucketMedian (clip c, int "radius", int "thresh", int "min", int "max")

clip  c =

Input clip; only planar formats are supported and only luma will be processed.

int  radius = 1

The radius of the neighborhood pixel referred to in order to calculate a median.

Higher values require heavy resources. Box size is (radius*2+1) * (radius*2+1).

Range: 1 to 255

int  thresh = 1

Threshold of which determines whether to change a pixel value into a median.

new = absolute(median - old) < thresh ? median : old

(new:filtered pixel value, old:source pixel value)

Range: 1 or higher

int  min = 0

Threshold of low pixel value.

If source's value is lower than this, the pixel is not processed.

Range: 0 to 254

int  max = 255

Threshold of high pixel value.

If source's value is higher than this, the pixel is not processed.

Range: 1 to 255

Examples

MedianBucket with default settings:

AviSource("blah.avi")
MedianBucket(radius=1, thresh=1, min=0, max=255)

Changelog

Version      Date            Changes

v0.3.0       08/21/2012      - Remove border processing and add BMBorderProc.avsi
v0.2.0       04/06/2012      - Add "thresh" parameter
v0.1.0       04/04/2012      - Initial release

License

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Archived Downloads

External Links

• GitHub - Source code repository.
• Doom10 Forum - BucketMedian discussion.
• blogspot - v0.3.0 blog post [Japanese].
• blogspot - v0.2.0 blog post [Japanese].
• blogspot - v0.1.0 blog post [Japanese].

Back to External Filters ←