deviation_imagedeviation_imageDeviationImageDeviationImagedeviation_image (算子名称)

名称

deviation_imagedeviation_imageDeviationImageDeviationImagedeviation_image — Calculate the standard deviation of gray values within rectangular windows.

参数签名

deviation_image(Image : ImageDeviation : Width, Height : )

描述

deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImagedeviation_image calculates the standard deviation of gray values in the image ImageImageImageImageimageimage within a rectangular mask of size (HeightHeightHeightHeightheightheight, WidthWidthWidthWidthwidthwidth). The resulting image is returned in ImageDeviationImageDeviationImageDeviationImageDeviationimageDeviationimage_deviation. To better use the range of gray values available in the output image, the result is multiplied by 2. If the parameters HeightHeightHeightHeightheightheight and WidthWidthWidthWidthwidthwidth are even, they are changed to the next larger odd value. At the image borders the gray values are mirrored.

注意

deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImagedeviation_image can be executed on OpenCL devices. As the same OpenCL code is used, the same limitations as for mean_imagemean_imageMeanImageMeanImageMeanImagemean_image apply. Since deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImagedeviation_image uses single precision floating point arithmetic internally, the results may differ slightly from the CPU version.

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

运行信息

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

参数表

ImageImageImageImageimageimage (input_object) (multichannel-)image(-array) → object (byte* / int4* / real* / int2* / uint2*) *allowed for compute devices

Image for which the standard deviation is to be calculated.

ImageDeviationImageDeviationImageDeviationImageDeviationimageDeviationimage_deviation (output_object) image(-array) → object (byte / int4 / real / int2 / uint2)

Image containing the standard deviation.

WidthWidthWidthWidthwidthwidth (input_control) extent.x → (integer)

Width of the mask in which the standard deviation is calculated.

Default: 11

Suggested values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriction: 3 <= Width && odd(Width) && Width < width(Image) * 2

HeightHeightHeightHeightheightheight (input_control) extent.y → (integer)

Height of the mask in which the standard deviation is calculated.

Default: 11

Suggested values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriction: 3 <= Height && odd(Height) && Height < height(Image) * 2

例程 (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

例程 (C)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
deviation_image(Image,&Deviation,9,9);
disp_image(Deviation,WindowHandle);

例程 (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

例程 (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

例程 (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

结果

deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImagedeviation_image returns 2 ( H_MSG_TRUE) if all parameters are correct. If the input is empty the behavior can be 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.

可能的后置算子

disp_imagedisp_imageDispImageDispImageDispImagedisp_image

可替代算子

entropy_imageentropy_imageEntropyImageEntropyImageEntropyImageentropy_image, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGrayentropy_gray

参考其它

convol_imageconvol_imageConvolImageConvolImageConvolImageconvol_image, texture_lawstexture_lawsTextureLawsTextureLawsTextureLawstexture_laws, intensityintensityIntensityIntensityIntensityintensity

模块

Foundation

算子列表