eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldeccentricity_xld (算子)

名称

eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldeccentricity_xld — 从轮廓或多边形的椭圆参数中导出的形状特征。

签名

描述

算子 eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld calculates the three shape features AnisometryAnisometryAnisometryAnisometryanisometryanisometry, BulkinessBulkinessBulkinessBulkinessbulkinessbulkiness, and StructureFactorStructureFactorStructureFactorStructureFactorstructureFactorstructure_factor derived from the geometric moments for each input contour or polygon. If the input contour or polygon is not closed it will be closed automatically.

Calculation: If the ellipse radii Ra, Rb (elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXldelliptic_axis_xld) and the enclosed area A of the contour or polygon are given, the following applies: The anisometry of a circle is 1.0.

需要注意的是，eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld 仅在轮廓或多边形在平面上包围区域时才会返回有效结果。特别需要注意的是，轮廓或多边形不得自相交。当传递开放轮廓或多边形时，这一点尤为重要，因为它们会被自动闭合，从而可能产生自相交的情况。可使用 test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXldtest_self_intersection_xld 检测轮廓或多边形是否自相交。 If the contour or polygon intersects itself, a useful value for the anisometry can be calculated with eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldEccentricityPointsXldeccentricity_points_xld。

If more than one contour is passed the results are stored in tuples, the index of a value in the tuple corresponding to the index of a contour in the input.

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 在元组级别上自动并行化。

参数

结果

算子 eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld 在输入不为空时返回值 2 ( H_MSG_TRUE )。The behavior in case of empty input (no input contours 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>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)。如有必要，则抛出异常。

可能的前趋

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPixthreshold_sub_pix, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld, test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXldtest_self_intersection_xld

替代

eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldEccentricityPointsXldeccentricity_points_xld

另见

elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXldelliptic_axis_xld, moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2ndmoments_region_2nd, select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXldselect_shape_xld, area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld

模块

基础