circularity_xldcircularity_xldCircularityXldCircularityXldcircularity_xld (Operator)

Name

circularity_xldcircularity_xldCircularityXldCircularityXldcircularity_xld — Shape factor for the circularity (similarity to a circle) of contours or polygons.

Signature

circularity_xld(XLD : : : Circularity)

Herror circularity_xld(const Hobject XLD, double* Circularity)

Herror T_circularity_xld(const Hobject XLD, Htuple* Circularity)

void CircularityXld(const HObject& XLD, HTuple* Circularity)

HTuple HXLD::CircularityXld() const

static void HOperatorSet.CircularityXld(HObject XLD, out HTuple circularity)

HTuple HXLD.CircularityXld()

def circularity_xld(xld: HObject) -> Sequence[float]

def circularity_xld_s(xld: HObject) -> float

Description

The operator 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.

Execution Information

Parameters

XLDXLDXLDXLDXLDxld (input_object)  xld(-array) objectHXLDHObjectHXLDHobject

Contours or polygons to be examined.

CircularityCircularityCircularityCircularitycircularitycircularity (output_control)  real(-array) HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Roundness of the input contours or polygons.

Assertion: 0 <= Circularity && Circularity <= 1.0

Result

The operator circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXldcircularity_xld returns the value 2 (H_MSG_TRUE) if the input is not empty. The behavior in case of empty input (no input contour 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>). If necessary an exception is raised.

Possible Predecessors

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

Alternatives

compactness_xldcompactness_xldCompactnessXldCompactnessXldCompactnessXldcompactness_xld, convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXldconvexity_xld, eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld, rectangularity_xldrectangularity_xldRectangularityXldRectangularityXldRectangularityXldrectangularity_xld

See also

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld, select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXldselect_shape_xld

Module

Foundation