circularity_xldcircularity_xldCircularityXldCircularityXldcircularity_xld（算子）

名称

circularity_xldcircularity_xldCircularityXldCircularityXldcircularity_xld — 轮廓或多边形的圆形度（与圆的相似性）的形状系数。

签名

描述

算子 circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXldcircularity_xld calculates the similarity of each input contour or polygon with a circle. The input contour or polygon must not intersect itself, otherwise the resulting parameter is not meaningful (Whether the input contour or polygon intersects itself or not can be determined with test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXldtest_self_intersection_xld). If the input contour or polygon is not closed it will be closed automatically.

Calculation: If F is the enclosed area of the contour or polygon and max is the maximum distance from the center to all contour or polygon pixels, the shape factor CircularityCircularityCircularityCircularitycircularitycircularity is defined as: The shape factor CircularityCircularityCircularityCircularitycircularitycircularity of a circle is 1. If the contour or polygon encloses an elongated area CircularityCircularityCircularityCircularitycircularitycircularity is smaller than 1. The operator circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXldcircularity_xld especially responds to large bulges.

If more than one contour or polygon is passed, the numerical values of the shape factor are stored in a tuple in the same order as the respective contours or polygons in XLDXLDXLDXLDXLDxld。

执行信息

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

参数

结果

算子 circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXldcircularity_xld 在输入不为空时返回值 2 ( H_MSG_TRUE )。当输入为空（无可用输入轮廓）时，可设置行为通过算子 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

替代

compactness_xldcompactness_xldCompactnessXldCompactnessXldCompactnessXldcompactness_xld, convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXldconvexity_xld, eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld, rectangularity_xldrectangularity_xldRectangularityXldRectangularityXldRectangularityXldrectangularity_xld

另见

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld, select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXldselect_shape_xld

模块

基础