plane_deviationplane_deviationPlaneDeviationPlaneDeviation (Operator)

Name

plane_deviationplane_deviationPlaneDeviationPlaneDeviation — Calculate the deviation of the gray values from the approximating image plane.

Signature

plane_deviation(Regions, Image : : : Deviation)

Herror plane_deviation(const Hobject Regions, const Hobject Image, double* Deviation)

Herror T_plane_deviation(const Hobject Regions, const Hobject Image, Htuple* Deviation)

void PlaneDeviation(const HObject& Regions, const HObject& Image, HTuple* Deviation)

HTuple HImage::PlaneDeviation(const HRegion& Regions) const

HTuple HRegion::PlaneDeviation(const HImage& Image) const

static void HOperatorSet.PlaneDeviation(HObject regions, HObject image, out HTuple deviation)

HTuple HImage.PlaneDeviation(HRegion regions)

HTuple HRegion.PlaneDeviation(HImage image)

Description

The operator plane_deviationplane_deviationPlaneDeviationPlaneDeviationPlaneDeviation calculates the deviation of the gray values in ImageImageImageImageimage from the approximation of the gray values through a plane. Contrary to the standard deviation in case of intensityintensityIntensityIntensityIntensity slanted gray value planes also receive the value zero. The gray value plane is calculated according to gen_image_gray_rampgen_image_gray_rampGenImageGrayRampGenImageGrayRampGenImageGrayRamp. If F is the area of the region, , , and the parameters of the image plane, and (r',c') the center of the region, DeviationDeviationDeviationDeviationdeviation is defined by:

Attention

Note that the operator plane_deviationplane_deviationPlaneDeviationPlaneDeviationPlaneDeviation only considers the given RegionsRegionsRegionsRegionsregions and ignores any previously set domain of the input image ImageImageImageImageimage. It should be noted that the calculation of DeviationDeviationDeviationDeviationdeviation does not follow the usual definition. It is defined to return the value 0.0 for an image with only one pixel.

Execution Information

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHobject

Regions, of which the plane deviation is to be calculated.

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHobject (byte / cyclic)

Gray value image.

DeviationDeviationDeviationDeviationdeviation (output_control)  real(-array) HTupleHTupleHtuple (real) (double) (double) (double)

Deviation of the gray values within a region.

Complexity

If F is the area of the region the runtime complexity amounts to O(F).

Result

The operator plane_deviationplane_deviationPlaneDeviationPlaneDeviationPlaneDeviation returns the value 2 (H_MSG_TRUE) if ImageImageImageImageimage is of the type 'byte'"byte""byte""byte""byte". The behavior in case of empty input (no input images available) is set via the operator 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>), the behavior in case of empty region is set via set_system(::'empty_region_result',<Result>:)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Alternatives

intensityintensityIntensityIntensityIntensity, gen_image_gray_rampgen_image_gray_rampGenImageGrayRampGenImageGrayRampGenImageGrayRamp, sub_imagesub_imageSubImageSubImageSubImage

See also

moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane

Module

Foundation