monotonymonotonyMonotonyMonotony (Operator)

Name

monotonymonotonyMonotonyMonotony — Calculating the monotony operation.

Signature

monotony(Image : ImageMonotony : : )

Description

The operator monotonymonotonyMonotonyMonotonyMonotony calculates the monotony operator. Thereby the points which are strictly smaller than the current grayvalue will be counted in the 8 neighborhood. This number will be entered into the output imaged.

If there is a strict maximum, the value 8 is returned; in case of a minimum or a plateau, the value 0 will be returned. A ridge or a slope will return the corresponding intermediate values.

The monotony operator is often used to prepare matching operations as it is invariant with regard to lightness modifications.

Attention

Note that filter operators may return unexpected results if an image with a reduced domain is used as input. Please refer to the chapter Filters.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on tuple level.
Automatically parallelized on channel level.
Automatically parallelized on domain level.

Parameters

ImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte / int2 / uint2)

Input image.

ImageMonotonyImageMonotonyImageMonotonyImageMonotonyimageMonotony (output_object) (multichannel-)image(-array) → object (byte / int2 / uint2)

Result of the monotony operator.

Number of elements: ImageMonotony == Image

Example (C)

/* searching the strict maximums */
gauss_filter(Image,&Gauss,5);
monotony(Gauss,&Monotony);
threshold(Monotony,Maxima,8.0,8.0);

Possible Predecessors

binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFilter, median_imagemedian_imageMedianImageMedianImageMedianImage, mean_imagemean_imageMeanImageMeanImageMeanImage, smooth_imagesmooth_imageSmoothImageSmoothImageSmoothImage, invert_imageinvert_imageInvertImageInvertImageInvertImage

Possible Successors

thresholdthresholdThresholdThresholdThreshold, exhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatchExhaustiveMatch, disp_imagedisp_imageDispImageDispImageDispImage

Alternatives

local_maxlocal_maxLocalMaxLocalMaxLocalMax, topographic_sketchtopographic_sketchTopographicSketchTopographicSketchTopographicSketch, corner_responsecorner_responseCornerResponseCornerResponseCornerResponse

Module

Foundation

Operators