deviation_imagedeviation_imageDeviationImageDeviationImage (Operator)

Name

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

Signature

Description

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

Attention

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

Execution Information

• Supports OpenCL compute devices.
• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.
• Automatically parallelized on channel level.
• Automatically parallelized on domain level.

Parameters

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

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

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

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

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

Result

deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImage 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>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Possible Successors

disp_imagedisp_imageDispImageDispImageDispImage

Alternatives

entropy_imageentropy_imageEntropyImageEntropyImageEntropyImage, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray

See also

convol_imageconvol_imageConvolImageConvolImageConvolImage, texture_lawstexture_lawsTextureLawsTextureLawsTextureLaws, intensityintensityIntensityIntensityIntensity

Module

Foundation