Operator Reference

HALCON Operator Reference / Image / Features
ClassesClasses | | Operators

moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlanemoments_gray_plane (Operator)

moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlanemoments_gray_plane — Calculate gray value moments and approximation by a plane.

Signature

moments_gray_plane(Regions, Image : : : MRow, MCol, Alpha, Beta, Mean)

Herror moments_gray_plane(const Hobject Regions, const Hobject Image, double* MRow, double* MCol, double* Alpha, double* Beta, double* Mean)

Herror T_moments_gray_plane(const Hobject Regions, const Hobject Image, Htuple* MRow, Htuple* MCol, Htuple* Alpha, Htuple* Beta, Htuple* Mean)

void MomentsGrayPlane(const HObject& Regions, const HObject& Image, HTuple* MRow, HTuple* MCol, HTuple* Alpha, HTuple* Beta, HTuple* Mean)

void HImage::MomentsGrayPlane(const HRegion& Regions, HTuple* MRow, HTuple* MCol, HTuple* Alpha, HTuple* Beta, HTuple* Mean) const

void HImage::MomentsGrayPlane(const HRegion& Regions, double* MRow, double* MCol, double* Alpha, double* Beta, double* Mean) const

void HRegion::MomentsGrayPlane(const HImage& Image, HTuple* MRow, HTuple* MCol, HTuple* Alpha, HTuple* Beta, HTuple* Mean) const

void HRegion::MomentsGrayPlane(const HImage& Image, double* MRow, double* MCol, double* Alpha, double* Beta, double* Mean) const

static void HOperatorSet.MomentsGrayPlane(HObject regions, HObject image, out HTuple MRow, out HTuple MCol, out HTuple alpha, out HTuple beta, out HTuple mean)

void HImage.MomentsGrayPlane(HRegion regions, out HTuple MRow, out HTuple MCol, out HTuple alpha, out HTuple beta, out HTuple mean)

void HImage.MomentsGrayPlane(HRegion regions, out double MRow, out double MCol, out double alpha, out double beta, out double mean)

void HRegion.MomentsGrayPlane(HImage image, out HTuple MRow, out HTuple MCol, out HTuple alpha, out HTuple beta, out HTuple mean)

void HRegion.MomentsGrayPlane(HImage image, out double MRow, out double MCol, out double alpha, out double beta, out double mean)

def moments_gray_plane(regions: HObject, image: HObject) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float]]

def moments_gray_plane_s(regions: HObject, image: HObject) -> Tuple[float, float, float, float, float]

Description

The operator moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlanemoments_gray_plane calculates the gray value moments and the parameters of the approximation of the gray values by a plane. The calculation is carried out according to the following formula: where is the plane, , the center, and , , and the scaled moments of RegionsRegionsRegionsregionsregions.

The parameters AlphaAlphaAlphaalphaalpha, BetaBetaBetabetabeta and MeanMeanMeanmeanmean describe a plane above the region: Thus AlphaAlphaAlphaalphaalpha indicates the gradient in the direction of the line axis (“down”), BetaBetaBetabetabeta the gradient in the direction of the column axis (to the “right”).

Attention

Note that the operator moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlanemoments_gray_plane only considers the given RegionsRegionsRegionsregionsregions and ignores any previously set domain of the input image ImageImageImageimageimage.

Execution Information

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

Parameters

RegionsRegionsRegionsregionsregions (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Regions to be checked.

ImageImageImageimageimage (input_object)  singlechannelimage → objectHImageHObjectHObjectHobject (byte / direction / cyclic / uint2 / real)

Corresponding gray values.

MRowMRowMRowMRowmrow (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Mixed moments along a line.

MColMColMColMColmcol (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Mixed moments along a column.

AlphaAlphaAlphaalphaalpha (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Parameter Alpha of the approximating plane.

BetaBetaBetabetabeta (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Parameter Beta of the approximating plane.

MeanMeanMeanmeanmean (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Mean gray value.

Result

The operator moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlanemoments_gray_plane returns the value 2 ( H_MSG_TRUE) if an image with the defined gray values (byte) is entered and the parameters are correct. 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>)set_system("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>)set_system("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

draw_regiondraw_regionDrawRegionDrawRegiondraw_region, gen_circlegen_circleGenCircleGenCirclegen_circle, gen_ellipsegen_ellipseGenEllipseGenEllipsegen_ellipse, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1gen_rectangle1, gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2gen_rectangle2, thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing

See also

intensityintensityIntensityIntensityintensity, moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndmoments_region_2nd

References

R. Haralick, L. Shapiro; “Computer and Robot Vision”; Addison-Wesley, 1992, pp 75-76

Module

Foundation

ClassesClasses | | Operators