deviation_imagedeviation_imageDeviationImageDeviationImagedeviation_image (Operator)
Name
deviation_imagedeviation_imageDeviationImageDeviationImagedeviation_image — Calculate the standard deviation of gray values within rectangular windows.
Signature
Description
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.
Attention
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 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
ImageImageImageImageimageimage (input_object) (multichannel-)image(-array) → objectHImageHObjectHImageHobject (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) → objectHImageHObjectHImageHobject * (byte / int4 / real / int2 / uint2)
Image containing the standard deviation.
WidthWidthWidthWidthwidthwidth (input_control) extent.x → HTupleintHTupleHtuple (integer) (int / long) (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) && Width < width(Image) * 2
HeightHeightHeightHeightheightheight (input_control) extent.y → HTupleintHTupleHtuple (integer) (int / long) (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) && Height < height(Image) * 2
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)
Result
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.
Possible Successors
disp_imagedisp_imageDispImageDispImageDispImagedisp_image
Alternatives
entropy_imageentropy_imageEntropyImageEntropyImageEntropyImageentropy_image,
entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGrayentropy_gray
See also
convol_imageconvol_imageConvolImageConvolImageConvolImageconvol_image,
texture_lawstexture_lawsTextureLawsTextureLawsTextureLawstexture_laws,
intensityintensityIntensityIntensityIntensityintensity
Module
Foundation