monotonymonotonyMonotonyMonotonymonotony (Operator)

Name

monotonymonotonyMonotonyMonotonymonotony — 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()

def monotony(image: HObject) -> HObject

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

Parameters

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

Input image.

ImageMonotonyImageMonotonyImageMonotonyImageMonotonyimageMonotonyimage_monotony (output_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject * (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