HALCON Reference Manual 10.0.2
Table of Contents / XLD / Transformations ClassesClassesClasses | | | Operators

regress_contours_xldregress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXld (Operator)

Name

regress_contours_xldregress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXld — Calculate the parameters of a regression line to an XLD contour.

Signature

regress_contours_xld(Contours : RegressContours : Mode, Iterations : )

Herror regress_contours_xld(const Hobject Contours, Hobject* RegressContours, const char* Mode, const Hlong Iterations)

Herror T_regress_contours_xld(const Hobject Contours, Hobject* RegressContours, const Htuple Mode, const Htuple Iterations)

Herror regress_contours_xld(Hobject Contours, Hobject* RegressContours, const HTuple& Mode, const HTuple& Iterations)

HXLDContArray HXLDContArray::RegressContoursXld(const HTuple& Mode, const HTuple& Iterations) const

void HOperatorSetX.RegressContoursXld(
[in] IHUntypedObjectX* Contours, [out] IHUntypedObjectX*RegressContours, [in] VARIANT Mode, [in] VARIANT Iterations)

IHXLDContX* HXLDContX.RegressContoursXld(
[in] BSTR Mode, [in] Hlong Iterations)

static void HOperatorSet.RegressContoursXld(HObject contours, out HObject regressContours, HTuple mode, HTuple iterations)

HXLDCont HXLDCont.RegressContoursXld(string mode, int iterations)

Description

regress_contours_xldregress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXld calculates the following parameters for the input XLD contours ContoursContoursContoursContourscontours, and stores them with the resulting contours as global attributes:

For ModeModeModeModemode = 'no'"no""no""no""no", the parameters of the regression line are calculated for all points of the contour. In addition, three different kinds of outlier treatment can be applied. Outliers are contour points which do not lie on the general contour direction in an “obvious” manner, and thus “distort” the resulting regression line.

ModeModeModeModemode =

The calculation of the undistorted regression line can be iterated several times (IterationsIterationsIterationsIterationsiterations).

Parallelization

Parameters

ContoursContoursContoursContourscontours (input_object)  xld_cont-array objectHXLDContHXLDContArrayHXLDContXHobject

Input XLD contours.

RegressContoursRegressContoursRegressContoursRegressContoursregressContours (output_object)  xld_cont-array objectHXLDContHXLDContArrayHXLDContXHobject *

Resulting XLD contours.

ModeModeModeModemode (input_control)  string HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Type of outlier treatment.

Default value: 'no' "no" "no" "no" "no"

List of values: 'no'"no""no""no""no", 'drop'"drop""drop""drop""drop", 'gauss'"gauss""gauss""gauss""gauss", 'median'"median""median""median""median"

IterationsIterationsIterationsIterationsiterations (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Number of iterations for the outlier treatment.

Default value: 1

Suggested values: 1, 2, 3, 5, 10, 20

Possible Predecessors

gen_contours_skeleton_xldgen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXld, lines_gausslines_gausslines_gaussLinesGaussLinesGauss, lines_facetlines_facetlines_facetLinesFacetLinesFacet, edges_sub_pixedges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPix

Possible Successors

get_regress_params_xldget_regress_params_xldget_regress_params_xldGetRegressParamsXldGetRegressParamsXld

See also

smooth_contours_xldsmooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXld, get_contour_global_attrib_xldget_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXld, query_contour_global_attribs_xldquery_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXld

References

H. Suesse, K. Voss: “Adaptive Ausgleichsrechnung und Ausreißerproblematik für die digitale Bildverarbeitung”; Proc. 15. DAGM Symposium, Springer Verlag, Lübeck 1993
R. Haralick, L. Shapiro: “Computer and Robot Vision” Vol. 2; Kapitel 14.9, Addison-Wesley 1992

Module

Foundation


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