convexity_xldconvexity_xldConvexityXldConvexityXldconvexity_xld (Operator)

Name

convexity_xldconvexity_xldConvexityXldConvexityXldconvexity_xld — Shape factor for the convexity of contours or polygons.

Signature

convexity_xld(XLD : : : Convexity)

Herror convexity_xld(const Hobject XLD, double* Convexity)

Herror T_convexity_xld(const Hobject XLD, Htuple* Convexity)

void ConvexityXld(const HObject& XLD, HTuple* Convexity)

HTuple HXLD::ConvexityXld() const

static void HOperatorSet.ConvexityXld(HObject XLD, out HTuple convexity)

HTuple HXLD.ConvexityXld()

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

def convexity_xld_s(xld: HObject) -> float

Description

The operator convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXldconvexity_xld calculates the convexity for each input contour or polygon. 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 is the area of the convex hull and the area enclosed by the original contour or polygon the shape factor ConvexityConvexityConvexityConvexityconvexityconvexity is defined as: The shape factor ConvexityConvexityConvexityConvexityconvexityconvexity is 1 if the contour or polygon is convex (e.g., a rectangle, circle, etc.). If there are indentations ConvexityConvexityConvexityConvexityconvexityconvexity is smaller than 1.

If more than one contour or polygon is passed, the numerical results 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.

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

Convexity of the input contours or polygons.

Assertion: Convexity <= 1

Result

The operator convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXldconvexity_xld returns the value 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

See also

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld, select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXldselect_shape_xld, shape_trans_xldshape_trans_xldShapeTransXldShapeTransXldShapeTransXldshape_trans_xld

Module

Foundation