median_separatemedian_separateMedianSeparateMedianSeparatemedian_separate (算子名称)

名称

median_separatemedian_separateMedianSeparateMedianSeparatemedian_separate — Separated median filtering with rectangle masks.

参数签名

median_separate(Image : ImageSMedian : MaskWidth, MaskHeight, Margin : )

Herror median_separate(const Hobject Image, Hobject* ImageSMedian, const Hlong MaskWidth, const Hlong MaskHeight, const char* Margin)

Herror T_median_separate(const Hobject Image, Hobject* ImageSMedian, const Htuple MaskWidth, const Htuple MaskHeight, const Htuple Margin)

void MedianSeparate(const HObject& Image, HObject* ImageSMedian, const HTuple& MaskWidth, const HTuple& MaskHeight, const HTuple& Margin)

HImage HImage::MedianSeparate(Hlong MaskWidth, Hlong MaskHeight, const HTuple& Margin) const

HImage HImage::MedianSeparate(Hlong MaskWidth, Hlong MaskHeight, const HString& Margin) const

HImage HImage::MedianSeparate(Hlong MaskWidth, Hlong MaskHeight, const char* Margin) const

HImage HImage::MedianSeparate(Hlong MaskWidth, Hlong MaskHeight, const wchar_t* Margin) const   ( Windows only)

static void HOperatorSet.MedianSeparate(HObject image, out HObject imageSMedian, HTuple maskWidth, HTuple maskHeight, HTuple margin)

HImage HImage.MedianSeparate(int maskWidth, int maskHeight, HTuple margin)

HImage HImage.MedianSeparate(int maskWidth, int maskHeight, string margin)

def median_separate(image: HObject, mask_width: int, mask_height: int, margin: Union[int, float, str]) -> HObject

描述

The operator median_separatemedian_separateMedianSeparateMedianSeparateMedianSeparatemedian_separate carries out a variation of the median filtering: First two auxiliary images are created. The first one originates from a median filtering with a horizontal mask having a height of one pixel and the width MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width followed by filtering with a vertical mask having the height MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height and width of one pixel. The second auxiliary image is created by filtering with the same masks, but with a reversed sequence of the operation: first the vertical, then the horizontal mask. The output image results from averaging the two auxiliary images pixel by pixel.

The operator median_separatemedian_separateMedianSeparateMedianSeparateMedianSeparatemedian_separate is clearly faster than the normal operator median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image because both masks are one pixel wide, facilitating a very efficient processing. The runtime is practically independent of the size of the mask. For example, the operator median_separatemedian_separateMedianSeparateMedianSeparateMedianSeparatemedian_separate can be well used after texture filters, where large masks are needed.

The filter can also be used several times in a row in order to enhance the smoothing.

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 过滤器.

Due to performance reasons, the input ImageImageImageImageimageimage is not checked whether it contains NaNs. Using an input image with NaNs crashes HALCON.

运行信息

参数表

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

Image to be filtered.

ImageSMedianImageSMedianImageSMedianImageSMedianimageSMedianimage_smedian (output_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject * (byte / int2 / uint2 / int4 / real)

Median filtered image.

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width (input_control)  extent.x HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Width of rank mask.

Default: 25

Suggested values: 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 27, 43, 51, 67, 91, 121, 151

Value range: 1 ≤ MaskWidth MaskWidth MaskWidth MaskWidth maskWidth mask_width ≤ 401

Minimum increment: 2

Recommended increment: 2

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height (input_control)  extent.y HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of rank mask.

Default: 25

Suggested values: 1, 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 27, 43, 51, 67, 91, 121, 151

Value range: 1 ≤ MaskHeight MaskHeight MaskHeight MaskHeight maskHeight mask_height ≤ 401

Minimum increment: 2

Recommended increment: 2

MarginMarginMarginMarginmarginmargin (input_control)  string HTupleUnion[int, float, str]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Border treatment.

Default: 'mirrored' "mirrored" "mirrored" "mirrored" "mirrored" "mirrored"

Suggested values: 'mirrored'"mirrored""mirrored""mirrored""mirrored""mirrored", 'cyclic'"cyclic""cyclic""cyclic""cyclic""cyclic", 'continued'"continued""continued""continued""continued""continued", 0, 30, 60, 90, 120, 150, 180, 210, 240, 255

例程 (HDevelop)

read_image(Image,'fabrik')
median_separate(Image,MedianSeparate,5,5,3)
dev_display(MedianSeparate)

例程 (C)

read_image(&Image,"fabrik");
median_separate(Image,&MedianSeparate,5,5,3);
disp_image(MedianSeparate,WindowHandle);

例程 (HDevelop)

read_image(Image,'fabrik')
median_separate(Image,MedianSeparate,5,5,3)
dev_display(MedianSeparate)

例程 (HDevelop)

read_image(Image,'fabrik')
median_separate(Image,MedianSeparate,5,5,3)
dev_display(MedianSeparate)

例程 (HDevelop)

read_image(Image,'fabrik')
median_separate(Image,MedianSeparate,5,5,3)
dev_display(MedianSeparate)

Complexity

For each pixel: O(40).

可能的前置算子

texture_lawstexture_lawsTextureLawsTextureLawsTextureLawstexture_laws, sobel_ampsobel_ampSobelAmpSobelAmpSobelAmpsobel_amp, deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImagedeviation_image

可能的后置算子

learn_ndim_normlearn_ndim_normLearnNdimNormLearnNdimNormLearnNdimNormlearn_ndim_norm, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, auto_thresholdauto_thresholdAutoThresholdAutoThresholdAutoThresholdauto_threshold

可替代算子

median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image

参考其它

rank_imagerank_imageRankImageRankImageRankImagerank_image

References

R. Haralick, L. Shapiro; “Computer and Robot Vision”; Addison-Wesley, 1992, Seite 319

模块

Foundation