ClassesClassesClassesClasses | | | | Operators

plane_deviationplane_deviationPlaneDeviationplane_deviationPlaneDeviationPlaneDeviation (Operator)

Name

plane_deviationplane_deviationPlaneDeviationplane_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)

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

Herror plane_deviation(Hobject Regions, Hobject Image, HTuple* Deviation)

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

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

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

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

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

void HOperatorSetX.PlaneDeviation(
[in] IHUntypedObjectX* Regions, [in] IHUntypedObjectX* Image, [out] VARIANT* Deviation)

VARIANT HImageX.PlaneDeviation([in] IHRegionX* Regions)

VARIANT HRegionX.PlaneDeviation([in] IHImageX* Image)

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_deviationPlaneDeviationplane_deviationPlaneDeviationPlaneDeviation calculates the deviation of the gray values in ImageImageImageImageImageimage from the approximation of the gray values through a plane. Contrary to the standard deviation in case of intensityintensityIntensityintensityIntensityIntensity slanted gray value planes also receive the value zero. The gray value plane is calculated according to gen_image_gray_rampgen_image_gray_rampGenImageGrayRampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp.

If F is the plane, alpha, beta, mean are the parameters of the image
plane and (r',c') is the center, Deviation is defined by:

  Deviation = sqrt(sum(((alpha*(r-r')+beta*(c-c')+mean)-Image(r,c))^2)/F) .

Attention

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

Parallelization

Parameters

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

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

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / cyclic)

Gray value image.

DeviationDeviationDeviationDeviationDeviationdeviation (output_control)  real(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (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_deviationPlaneDeviationplane_deviationPlaneDeviationPlaneDeviation returns the value 2 (H_MSG_TRUE) if ImageImageImageImageImageimage is of the type 'byte'"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>)set_system("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>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Alternatives

intensityintensityIntensityintensityIntensityIntensity, gen_image_gray_rampgen_image_gray_rampGenImageGrayRampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp, sub_imagesub_imageSubImagesub_imageSubImageSubImage

See also

moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane

Module

Foundation


ClassesClassesClassesClasses | | | | Operators