monotonymonotonyMonotonyMonotony (Operator)

Name

monotonymonotonyMonotonyMonotony — Calculating the monotony operation.

Signature

monotony(Image : ImageMonotony : : )

Herror monotony(const Hobject Image, Hobject* ImageMonotony)

Herror T_monotony(const Hobject Image, Hobject* ImageMonotony)

void Monotony(const HObject& Image, HObject* ImageMonotony)

HImage HImage::Monotony() const

static void HOperatorSet.Monotony(HObject image, out HObject imageMonotony)

HImage HImage.Monotony()

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

Parameters

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

Input image.

ImageMonotonyImageMonotonyImageMonotonyImageMonotonyimageMonotony (output_object)  (multichannel-)image(-array) objectHImageHImageHobject * (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