HALCON Reference Manual 10.0.2
Table of Contents / Image / Features ClassesClassesClasses | | | Operators

plane_deviationplane_deviationplane_deviationPlaneDeviationPlaneDeviation (Operator)

Name

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

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 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_deviationplane_deviationPlaneDeviationPlaneDeviation 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_rampgen_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

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.

Parallelization

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionXHobject

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

ImageImageImageImageimage (input_object)  image objectHImageHImageHImageXHobject (byte / cyclic)

Gray value image.

DeviationDeviationDeviationDeviationdeviation (output_control)  real(-array) HTupleHTupleVARIANTHtuple (real) (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_deviationplane_deviationPlaneDeviationPlaneDeviation 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>)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>)set_system("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_rampgen_image_gray_rampGenImageGrayRampGenImageGrayRamp, sub_imagesub_imagesub_imageSubImageSubImage

See also

moments_gray_planemoments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane

Module

Foundation


Table of Contents / Image / Features ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH