get_regress_params_xldT_get_regress_params_xldGetRegressParamsXldGetRegressParamsXldget_regress_params_xld (Operator)
Name
get_regress_params_xldT_get_regress_params_xldGetRegressParamsXldGetRegressParamsXldget_regress_params_xld — Return XLD contour parameters.
Signature
Herror T_get_regress_params_xld(const Hobject Contours, Htuple* Length, Htuple* Nx, Htuple* Ny, Htuple* Dist, Htuple* Fpx, Htuple* Fpy, Htuple* Lpx, Htuple* Lpy, Htuple* Mean, Htuple* Deviation)
void GetRegressParamsXld(const HObject& Contours, HTuple* Length, HTuple* Nx, HTuple* Ny, HTuple* Dist, HTuple* Fpx, HTuple* Fpy, HTuple* Lpx, HTuple* Lpy, HTuple* Mean, HTuple* Deviation)
HTuple HXLDCont::GetRegressParamsXld(HTuple* Nx, HTuple* Ny, HTuple* Dist, HTuple* Fpx, HTuple* Fpy, HTuple* Lpx, HTuple* Lpy, HTuple* Mean, HTuple* Deviation) const
static void HOperatorSet.GetRegressParamsXld(HObject contours, out HTuple length, out HTuple nx, out HTuple ny, out HTuple dist, out HTuple fpx, out HTuple fpy, out HTuple lpx, out HTuple lpy, out HTuple mean, out HTuple deviation)
HTuple HXLDCont.GetRegressParamsXld(out HTuple nx, out HTuple ny, out HTuple dist, out HTuple fpx, out HTuple fpy, out HTuple lpx, out HTuple lpy, out HTuple mean, out HTuple deviation)
def get_regress_params_xld(contours: HObject) -> Tuple[Sequence[int], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float], Sequence[float]]
Description
get_regress_params_xldget_regress_params_xldGetRegressParamsXldGetRegressParamsXldget_regress_params_xld returns the following parameters for
all XLD contours given in ContoursContoursContourscontourscontours:
-
the number of contour points LengthLengthLengthlengthlength,
-
the coordinates NxNxNxnxnx and NyNyNynyny of the
normal vector of the regression line (i.e., least-squares
approximating line),
-
the distance DistDistDistdistdist of the regression line to the
origin
-
the sub-pixel precise coordinates FpxFpxFpxfpxfpx and
FpyFpyFpyfpyfpy of the perpendicular projection of the start
point of the contour onto the regression line,
-
the sub-pixel precise coordinates LpxLpxLpxlpxlpx and
LpyLpyLpylpylpy of the perpendicular projection of the end
point of the contour onto the regression line,
-
the mean of the Euclidean distance of the contour points from
the regression line,
-
the standard deviation of these distances.
Attention
Before the contour parameters can be returned by
get_regress_params_xldget_regress_params_xldGetRegressParamsXldGetRegressParamsXldget_regress_params_xld, the parameters of the regression
line to the contour must be calculated by calling
regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldregress_contours_xld.
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
ContoursContoursContourscontourscontours (input_object) xld_cont-array → objectHXLDContHObjectHObjectHobject
Input XLD contours.
LengthLengthLengthlengthlength (output_control) integer-array → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Number of contour points.
NxNxNxnxnx (output_control) point.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
X-coordinate of the normal vector of the
regression line.
NyNyNynyny (output_control) point.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Y-coordinate of the normal vector of the
regression line.
DistDistDistdistdist (output_control) number-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Distance of the regression line from the origin.
FpxFpxFpxfpxfpx (output_control) point.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
X-coordinate of the projection of the start point
of the contour onto the regression line.
FpyFpyFpyfpyfpy (output_control) point.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Y-coordinate of the projection of the start point
of the contour onto the regression line.
LpxLpxLpxlpxlpx (output_control) point.x-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
X-coordinate of the projection of the end point
of the contour onto the regression line.
LpyLpyLpylpylpy (output_control) point.y-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Y-coordinate of the projection of the end point
of the contour onto the regression line.
MeanMeanMeanmeanmean (output_control) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Mean distance of the contour points from the
regression line.
DeviationDeviationDeviationdeviationdeviation (output_control) real-array → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Standard deviation of the distances from the
regression line.
Possible Predecessors
regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldregress_contours_xld
Possible Successors
disp_linedisp_lineDispLineDispLinedisp_line,
line_orientationline_orientationLineOrientationLineOrientationline_orientation
See also
fit_line_contour_xldfit_line_contour_xldFitLineContourXldFitLineContourXldfit_line_contour_xld,
get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldget_contour_global_attrib_xld,
query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldquery_contour_global_attribs_xld,
get_contour_xldget_contour_xldGetContourXldGetContourXldget_contour_xld,
get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldget_contour_attrib_xld,
gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld,
lines_gausslines_gaussLinesGaussLinesGausslines_gauss,
lines_facetlines_facetLinesFacetLinesFacetlines_facet,
edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixedges_sub_pix
Module
Foundation