ClassesClassesClassesClasses | | | | Operators

deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage (Operator)

Name

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

Signature

deviation_image(Image : ImageDeviation : Width, Height : )

Herror deviation_image(const Hobject Image, Hobject* ImageDeviation, const Hlong Width, const Hlong Height)

Herror T_deviation_image(const Hobject Image, Hobject* ImageDeviation, const Htuple Width, const Htuple Height)

Herror deviation_image(Hobject Image, Hobject* ImageDeviation, const HTuple& Width, const HTuple& Height)

HImage HImage::DeviationImage(const HTuple& Width, const HTuple& Height) const

HImageArray HImageArray::DeviationImage(const HTuple& Width, const HTuple& Height) const

void DeviationImage(const HObject& Image, HObject* ImageDeviation, const HTuple& Width, const HTuple& Height)

HImage HImage::DeviationImage(Hlong Width, Hlong Height) const

void HOperatorSetX.DeviationImage(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*ImageDeviation, [in] VARIANT Width, [in] VARIANT Height)

IHImageX* HImageX.DeviationImage(
[in] Hlong Width, [in] Hlong Height)

static void HOperatorSet.DeviationImage(HObject image, out HObject imageDeviation, HTuple width, HTuple height)

HImage HImage.DeviationImage(int width, int height)

Description

deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage 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 ImageDeviationImageDeviationImageDeviationImageDeviationImageDeviationimageDeviation. 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.

Attention

deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage can be executed on OpenCL devices. As the same OpenCL code is used, the same limitations as for mean_imagemean_imageMeanImagemean_imageMeanImageMeanImage apply. Since deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage 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 Filters.

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject (byte* / int4* / real* / int2* / uint2*) *allowed for compute devices

Image for which the standard deviation is to be calculated.

ImageDeviationImageDeviationImageDeviationImageDeviationImageDeviationimageDeviation (output_object)  image(-array) objectHImageHImageHImageHImageXHobject * (byte / int4 / real / int2 / uint2)

Image containing the standard deviation.

WidthWidthWidthWidthWidthwidth (input_control)  extent.x HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

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

Default value: 11

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

Restriction: 3 <= Width && odd(Width)

HeightHeightHeightHeightHeightheight (input_control)  extent.y HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

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

Default value: 11

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

Restriction: 3 <= Height && odd(Height)

Example (HDevelop)

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

Example (C)

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

Example (HDevelop)

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

Example (HDevelop)

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

Example (HDevelop)

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

Example (HDevelop)

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

Result

deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behaviour can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Successors

disp_imagedisp_imageDispImagedisp_imageDispImageDispImage

Alternatives

entropy_imageentropy_imageEntropyImageentropy_imageEntropyImageEntropyImage, entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray

See also

convol_imageconvol_imageConvolImageconvol_imageConvolImageConvolImage, texture_lawstexture_lawsTextureLawstexture_lawsTextureLawsTextureLaws, intensityintensityIntensityintensityIntensityIntensity

Module

Foundation


ClassesClassesClassesClasses | | | | Operators