dual_rankdual_rankDualRankDualRankdual_rank (算子名称)

名称

dual_rankdual_rankDualRankDualRankdual_rank — Opening, Median and Closing with circle or rectangle mask.

参数签名

描述

该算子 dual_rankdual_rankDualRankDualRankDualRankdual_rank carries out a non-linear transformation of the gray values of all input images (ImageImageImageImageimageimage). Circles or squares can be used as structuring elements. 该算子 dual_rankdual_rankDualRankDualRankDualRankdual_rank effects two consecutive calls of rank_imagerank_imageRankImageRankImageRankImagerank_image. At the first call the range gray value is calculated with the indicated range (ModePercentModePercentModePercentModePercentmodePercentmode_percent). The result of this calculation is the input of a further call of rank_imagerank_imageRankImageRankImageRankImagerank_image, this time using the range value 100-ModePercentModePercentModePercentModePercentmodePercentmode_percent.

When filtering different parameters for border treatment (MarginMarginMarginMarginmarginmargin) can be chosen: gray value Pixels outside of the image edges are assumed to be constant (with the indicated gray value). 'continued' Continuation of edge pixels. 'cyclic' Cyclic continuation of image edges. 'mirrored' Reflection of pixels at the image edges. A range filtering is calculated according to the following scheme: The indicated mask is put over the image to be filtered in such a way that the center of the mask touches all pixels once. For each of these pixels all neighboring pixels covered by the mask are sorted in an ascending sequence corresponding to their gray values. Each sorted sequence of gray values contains the same number of gray values like the mask has image points. The n-th highest element, (= ModePercentModePercentModePercentModePercentmodePercentmode_percent, rank values between 0...100 in percent) is selected and set as result gray value in the corresponding result image.

If ModePercentModePercentModePercentModePercentmodePercentmode_percent is 0, then 该算子 equals to the gray value opening (gray_openinggray_openingGrayOpeningGrayOpeningGrayOpeninggray_opening). If ModePercentModePercentModePercentModePercentmodePercentmode_percent is 50, 该算子 results in the median filter, which is applied twice (median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image). The ModePercentModePercentModePercentModePercentmodePercentmode_percent 100 in dual_rankdual_rankDualRankDualRankDualRankdual_rank means that it calculates the gray value closing (gray_closinggray_closingGrayClosingGrayClosingGrayClosinggray_closing). Choosing parameter values inside this range results in a smooth transformation of these operators.

For an explanation of the concept of smoothing filters see the introduction of chapter Filters / Smoothing.

注意

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

运行信息

• 多线程类型:可重入(与非独占操作符并行运行)。
• 多线程作用域:全局(可以从任何线程调用)。
• 在元组级别自动并行化。
• 在图像通道级别自动并行化。
• Automatically parallelized on domain level.

参数表

read_image(Image,'fabrik')
dual_rank(Image,ImageOpening,'circle',10,10,'mirrored')
dev_display(ImageOpening)

read_image(&Image,"fabrik");
dual_rank(Image,&ImageOpening,"circle",10,10,"mirrored");
disp_image(ImageOpening,WindowHandle);

read_image(Image,'fabrik')
dual_rank(Image,ImageOpening,'circle',10,10,'mirrored')
dev_display(ImageOpening)

read_image(Image,'fabrik')
dual_rank(Image,ImageOpening,'circle',10,10,'mirrored')
dev_display(ImageOpening)

read_image(Image,'fabrik')
dual_rank(Image,ImageOpening,'circle',10,10,'mirrored')
dev_display(ImageOpening)

Complexity

For each pixel: with F = area of the structuring element.

结果

If the parameter values are correct 该算子 dual_rankdual_rankDualRankDualRankDualRankdual_rank 返回值 2 ( H_MSG_TRUE) . The behavior in case of empty input (no input images available) is set via 该算子 set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>). If necessary an exception is raised.

可能的前置算子

read_imageread_imageReadImageReadImageReadImageread_image

可能的后置算子

thresholdthresholdThresholdThresholdThresholdthreshold, dyn_thresholddyn_thresholdDynThresholdDynThresholdDynThresholddyn_threshold, sub_imagesub_imageSubImageSubImageSubImagesub_image, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing

可替代算子

rank_imagerank_imageRankImageRankImageRankImagerank_image, gray_closinggray_closingGrayClosingGrayClosingGrayClosinggray_closing, gray_openinggray_openingGrayOpeningGrayOpeningGrayOpeninggray_opening, median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image

参考其它

gen_circlegen_circleGenCircleGenCircleGenCirclegen_circle, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1, gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRectgray_erosion_rect, gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRectgray_dilation_rect, sigma_imagesigma_imageSigmaImageSigmaImageSigmaImagesigma_image

References

W. Eckstein, O. Munkelt “Extracting Objects from Digital Terrain Model” Remote Sensing and Reconstruction for Threedimensional Objects and Scenes, SPIE Symposium on Optical Science, Engeneering, and Instrumentation, July 1995, San Diego

模块

Foundation