Skip to content

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldregress_contours_xldregress_contours_xldđź”—

Short descriptionđź”—

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

Signatuređź”—

regress_contours_xld( xld_cont Contours, out xld_cont RegressContours, string Mode, integer Iterations )regress_contours_xld( Contours : RegressContours : Mode, Iterations : )void RegressContoursXld( const HObject& Contours, HObject* RegressContours, const HTuple& Mode, const HTuple& Iterations )static void HOperatorSet.RegressContoursXld( HObject contours, out HObject regressContours, HTuple mode, HTuple iterations )def regress_contours_xld( contours: HObject, mode: str, iterations: int ) -> HObject

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 )

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)

HXLDCont HXLDCont.RegressContoursXld( string mode, int iterations )

Descriptionđź”—

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

  • the coordinates of the normal vector of the regression line, i.e., the least-squares approximating line, of all contour points; the normal vector always points from the origin to the line (attributes: 'regr_norm_row'"regr_norm_row", 'regr_norm_col'"regr_norm_col"),

  • the mean of the Euclidean distance of the contour points from the regression line (attribute: 'regr_mean_dist'"regr_mean_dist"),

  • the standard deviation of these distances to the regression line (attribute: 'regr_dev_dist'"regr_dev_dist"),

  • the distance of the regression line from the origin (attribute: 'regr_dist'"regr_dist").

See get_contour_global_attrib_xldGetContourGlobalAttribXld for further information about global contour attributes.

For Modemodemode = '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.

Modemodemode =

  • 'drop'"drop": All contour points further away from the contour than the mean distance to the regression line are ignored for the calculation of the undistorted regression line.

  • 'gauss'"gauss": The distances of the contour points are weighted according to their probability of occurrence in a Gaussian distribution around the normal regression line.

  • 'median'"median": Here, also a normal distribution is assumed for the distances to the normal regression line, however with the outlier-independent standard deviation \(\frac{M_{d}}{0.6745}\), with \(M_{d}\): median of all distances. Again, the distances are weighted, and points further away than a certain distance are ignored for the undistorted regression line.

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

Execution informationđź”—

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parametersđź”—

Contourscontourscontours (input_object) xld_cont-array → objectobjectHObjectHXLDContHObjectHobject

Input XLD contours.

RegressContoursregressContoursregress_contours (output_object) xld_cont-array → objectobjectHObjectHXLDContHObjectHobject *

Resulting XLD contours.

Modemodemode (input_control) string → (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Type of outlier treatment.

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

Iterationsiterationsiterations (input_control) integer → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Number of iterations for the outlier treatment.

Default: 11
Suggested values: 1, 2, 3, 5, 10, 201, 2, 3, 5, 10, 20

Combinations with other operatorsđź”—

Combinations

Possible predecessors

gen_contours_skeleton_xldGenContoursSkeletonXld, lines_gaussLinesGauss, lines_facetLinesFacet, edges_sub_pixEdgesSubPix

Possible successors

get_regress_params_xldGetRegressParamsXld

See also

smooth_contours_xldSmoothContoursXld, get_contour_global_attrib_xldGetContourGlobalAttribXld, query_contour_global_attribs_xldQueryContourGlobalAttribsXld

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