DIPlib Documentation - ©1995-2008 Quantitative Imaging Group, Delft University of Technology.

BiasedSigma

Adaptive edge sharpening & contrast enhancing filter

SYNOPSIS

#include "dip_filtering.h"

dip_Error dip_BiasedSigma ( in, out, se, boundary, filterSize, shape, sigma, outputCount )

DATA TYPES

integer, float

FUNCTION

The Biased Sigma filter is an adaptive edge sharpening and contrast enhancing filter. Its operation differs from the Sigma filter by separating the averaging the pixels with an intensities higher than the pixel being filtered, from the pixels with lower intensities. The absolute difference of these two averages with the value of the pixel being filtered. The value of this pixel is being replaced by the average with the smallest difference. If outputCount is DIP_TRUE, the output values represent the number of pixel over which the average has been calculated. When threshold is DIP_TRUE, the pixel intensities are being thresholded at +/- 2 sigma, when it is set to DIP_FALSE, the intensities are weighted with the Gaussian difference with the intensity of the central pixel.

If shape is not equal to DIP_FLT_SHAPE_STRUCTURING_ELEMENT, se is allowed to be set to zero. When shape is set to DIP_FLT_SHAPE_STRUCTURING_ELEMENT, filterParam is ignored, (and can be set to zero).

ARGUMENTS

Data typeNameDescription
dip_ImageinInput image
dip_ImageoutOutput image
dip_ImageseStructuring element
dip_BoundaryArrayboundaryBoundary conditions
dip_FloatArrayfilterSizeFilter sizes
dip_FilterShapeshapeFilter shape
dip_floatsigmaSigma
dip_BooleanoutputCountOutput the Count

The enumerator dip_FilterShape contains the following constants:

NameDescription
DIP_FLT_SHAPE_DEFAULTdefault structuring element, same as DIP_FLT_SHAPE_RECTANGULAR
DIP_FLT_SHAPE_RECTANGULARrectangular structuring element
DIP_FLT_SHAPE_ELLIPTICelliptic structuring element
DIP_FLT_SHAPE_DIAMONDdiamond shaped structuring element
DIP_FLT_SHAPE_PARABOLICparabolic structuring element
DIP_FLT_SHAPE_STRUCTURING_ELEMENTuse se as structuring element

NOTE

The filter shape DIP_FLT_SHAPE_PARABOLIC, as well as custom grey-value shapes, are not supported.

LITERATURE

John-Sen Lee, Digital Image Smoothing and the Sigma Filter, Computer Vision, Graphics and Image Processing, 24, 255-269, 1983

SEE ALSO

Sigma, GaussianSigma

DIPlib on-line documentation | Function reference | Global function index