eliminate_sp ( Image : ImageFillSP : MaskWidth, MaskHeight, MinThresh, MaxThresh : )

Replace values outside of thresholds with average value.

The operator eliminate_sp replaces all gray values outside the indicated gray value intervals (MinThresh to MaxThresh) with the neighboring mean values. Only those neighboring pixels which also fall within the gray value interval are used for averaging. If no such pixel is present in the vicinity the original gray value is used. The gray values in the input image falling within the gray value interval are also adopted without change.


Attention

If even values instead of odd values are given for MaskHeight or MaskWidth, the routine uses the next larger odd values instead (this way the center of the filter mask is always explicitly determined).


Parameters

Image (input_object)
(multichannel-)image(-array) -> object : byte
Input image.

ImageFillSP (output_object)
(multichannel-)image(-array) -> object : byte
Smoothed image.

MaskWidth (input_control)
extent.x -> integer
Width of filter mask.
Default value: 3
Suggested values: 3, 5, 7, 9, 11
Typical range of values: 3 <= MaskWidth <= 512 (lin)
Minimum increment: 2
Recommended increment: 2
Restriction: odd(MaskWidth)

MaskHeight (input_control)
extent.y -> integer
Height of filter mask.
Default value: 3
Suggested values: 3, 5, 7, 9, 11
Typical range of values: 3 <= MaskHeight <= 512 (lin)
Minimum increment: 2
Recommended increment: 2
Restriction: odd(MaskHeight)

MinThresh (input_control)
integer -> integer
Minimum gray value.
Default value: 1
Suggested values: 1, 5, 7, 9, 11, 15, 23, 31, 43, 61, 101
Typical range of values: 0 <= MinThresh <= 254 (lin)
Minimum increment: 1
Recommended increment: 1

MaxThresh (input_control)
integer -> integer
Maximum gray value.
Default value: 254
Suggested values: 5, 7, 9, 11, 15, 23, 31, 43, 61, 101, 200, 230, 250, 254
Typical range of values: 1 <= MaxThresh <= 255 (lin)
Minimum increment: 1
Recommended increment: 1
Restriction: MinThresh <= MaxThresh


Example
read_image(Image,'meer_rot') 
disp_image(Image,WindowHandle) 
eliminate_sp(Image,ImageMeansp,3,3,101,201) 
disp_image(ImageMeansp,WindowHandle).

Parallelization Information

eliminate_sp is reentrant and automatically parallelized (on tuple level, channel level, domain level).


Possible Successors

disp_image


Alternatives

mean_sp, mean_image, median_image, eliminate_min_max


See also

gauss_image, smooth_image, anisotrope_diff, sigma_image, eliminate_min_max


Module

Image filters



Copyright © 1996-2005 MVTec Software GmbH