monotonymonotonyMonotonyMonotonymonotony (Operator)

Name

monotonymonotonyMonotonyMonotonymonotony — Calculating the monotony operation.

Signature

monotony(Image : ImageMonotony : : )

Description

The operator monotonymonotonyMonotonyMonotonyMonotonymonotony calculates the monotony operator. Thereby the points which are strictly smaller than the current gray value 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

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

Input image.

ImageMonotonyImageMonotonyImageMonotonyImageMonotonyimageMonotonyimage_monotony (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_filterBinomialFilterBinomialFilterBinomialFilterbinomial_filter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFiltergauss_filter, median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image, mean_imagemean_imageMeanImageMeanImageMeanImagemean_image, smooth_imagesmooth_imageSmoothImageSmoothImageSmoothImagesmooth_image, invert_imageinvert_imageInvertImageInvertImageInvertImageinvert_image

Possible Successors

thresholdthresholdThresholdThresholdThresholdthreshold, exhaustive_matchexhaustive_matchExhaustiveMatchExhaustiveMatchExhaustiveMatchexhaustive_match, disp_imagedisp_imageDispImageDispImageDispImagedisp_image

Alternatives

local_maxlocal_maxLocalMaxLocalMaxLocalMaxlocal_max, topographic_sketchtopographic_sketchTopographicSketchTopographicSketchTopographicSketchtopographic_sketch, corner_responsecorner_responseCornerResponseCornerResponseCornerResponsecorner_response

Module

Foundation

Operators