regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldregress_contours_xld (Operator)

Name

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldregress_contours_xld — 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)

void RegressContoursXld(const HObject& Contours, HObject* RegressContours, const HTuple& Mode, const HTuple& Iterations)

HXLDCont HXLDCont::RegressContoursXld(const HString& Mode, Hlong Iterations) const

HXLDCont HXLDCont::RegressContoursXld(const char* Mode, Hlong Iterations) const

HXLDCont HXLDCont::RegressContoursXld(const wchar_t* Mode, Hlong Iterations) const   (Windows only)

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

HXLDCont HXLDCont.RegressContoursXld(string mode, int iterations)

def regress_contours_xld(contours: HObject, mode: str, iterations: int) -> HObject

Description

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

See get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldGetContourGlobalAttribXldget_contour_global_attrib_xld for further information about global contour attributes.

For ModeModeModeModemodemode = 'no'"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.

ModeModeModeModemodemode =

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

Execution Information

Parameters

ContoursContoursContoursContourscontourscontours (input_object)  xld_cont-array objectHXLDContHObjectHXLDContHobject

Input XLD contours.

RegressContoursRegressContoursRegressContoursRegressContoursregressContoursregress_contours (output_object)  xld_cont-array objectHXLDContHObjectHXLDContHobject *

Resulting XLD contours.

ModeModeModeModemodemode (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Type of outlier treatment.

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

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

IterationsIterationsIterationsIterationsiterationsiterations (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (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_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, lines_gausslines_gaussLinesGaussLinesGaussLinesGausslines_gauss, lines_facetlines_facetLinesFacetLinesFacetLinesFacetlines_facet, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix

Possible Successors

get_regress_params_xldget_regress_params_xldGetRegressParamsXldGetRegressParamsXldGetRegressParamsXldget_regress_params_xld

See also

smooth_contours_xldsmooth_contours_xldSmoothContoursXldSmoothContoursXldSmoothContoursXldsmooth_contours_xld, get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldGetContourGlobalAttribXldget_contour_global_attrib_xld, query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldquery_contour_global_attribs_xld

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