eliminate_sp (Operator)

Name

eliminate_sp — Replace values outside of thresholds with average value.

Synopsis

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

Description

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 / uint2)
Input image.

ImageFillSP (output_object)	(multichannel-)image(-array) → object (byte / uint2)
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

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
Restriction: MinThresh <= MaxThresh

Example

read_image(Image,'mreut')
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

binomial_filter, gauss_image, smooth_image, anisotropic_diffusion, sigma_image, eliminate_min_max

Module

Foundation