Operator Reference

deviation_ndeviation_nDeviationNDeviationNdeviation_n (Operator)

deviation_ndeviation_nDeviationNDeviationNdeviation_n — Calculate standard deviation over several channels.

Signature

deviation_n(Image : ImageDeviation : : )

Herror deviation_n(const Hobject Image, Hobject* ImageDeviation)

Herror T_deviation_n(const Hobject Image, Hobject* ImageDeviation)

void DeviationN(const HObject& Image, HObject* ImageDeviation)

HImage HImage::DeviationN() const

static void HOperatorSet.DeviationN(HObject image, out HObject imageDeviation)

HImage HImage.DeviationN()

def deviation_n(image: HObject) -> HObject

Description

deviation_ndeviation_nDeviationNDeviationNdeviation_n generates the pixel-by-pixel standard deviation of a multichannel gray value image. For each coordinate point p the expected value is defined as the arithmetic mean: where g_{c}(p) denominates the gray value at p on channel c. n is the number of channels in the image.

The standard deviation itself is then calculated as: Note that this formula produces the sample standard deviation. The factor 2 is used to make better use of the range of values of the output image format. The output image has one channel.

Attention

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

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

Parameters

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) objectHImageHObjectHObjectHobject (byte / int2 / uint2 / int4 / real)

Multichannel gray image.

ImageDeviationImageDeviationImageDeviationimageDeviationimage_deviation (output_object)  image(-array) objectHImageHObjectHObjectHobject * (byte / int2 / uint2 / int4 / real)

Result of calculation.

Possible Predecessors

compose2compose2Compose2Compose2compose2, compose3compose3Compose3Compose3compose3, compose4compose4Compose4Compose4compose4, compose5compose5Compose5Compose5compose5, add_channelsadd_channelsAddChannelsAddChannelsadd_channels

See also

mean_nmean_nMeanNMeanNmean_n

Module

Foundation