Skip to content

eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldeccentricity_points_xldeccentricity_points_xld🔗

Short description🔗

eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldeccentricity_points_xldeccentricity_points_xld — Anisometry of contours or polygons treated as point clouds.

Signature🔗

eccentricity_points_xld( xld XLD, out real Anisometry )eccentricity_points_xld( XLD : : : Anisometry )void EccentricityPointsXld( const HObject& XLD, HTuple* Anisometry )static void HOperatorSet.EccentricityPointsXld( HObject XLD, out HTuple anisometry )def eccentricity_points_xld( xld: HObject ) -> Sequence[float]

def eccentricity_points_xld_s( xld: HObject ) -> floatHerror eccentricity_points_xld( const Hobject XLD, double* Anisometry )

Herror T_eccentricity_points_xld( const Hobject XLD, Htuple* Anisometry )

HTuple HXLD::EccentricityPointsXld( ) const

HTuple HXLD.EccentricityPointsXld( )

Description🔗

The operator eccentricity_points_xldEccentricityPointsXld calculates the shape feature Anisometryanisometryanisometry derived from the geometric moments of the point cloud given by the contour or polygon XLDXLDxld (i.e., the order of the points in the contour or polygon is not taken into account). If the contour or polygon is closed (end point = start point), the end point of the contour or polygon is not taken into account to avoid that it receives twice the weight of the other points.

Calculation: If the ellipse radii \(Ra\), \(Rb\) (elliptic_axis_points_xldEllipticAxisPointsXld) are given, the following applies:

\[\begin{eqnarray*} \textrm{Anisometry} = \frac{Ra}{Rb} \end{eqnarray*}\]

The anisometry of a circle is 1.0.

eccentricity_points_xldEccentricityPointsXld should be used if the contour XLDXLDxld intersects itself or if it is not possible to close the contour using a line from end to start point without self-intersection, because in this case eccentricity_xldEccentricityXld does not produce useful results. To test whether the contours or polygons intersect themselves, test_self_intersection_xldTestSelfIntersectionXld can be used.

If more than one contour or polygon is passed, the values of the anisometry are stored in a tuple in the same order as the respective contours or polygons in XLDXLDxld.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Automatically parallelized on tuple level.

Parameters🔗

XLDXLDxld (input_object) xld(-array) → objectobjectHObjectHXLDHObjectHobject

Contours or polygons to be examined.

Anisometryanisometryanisometry (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Anisometry of the contours or polygons.

Assertion: Anisometry >= 1.0

Result🔗

The operator eccentricity_points_xldEccentricityPointsXld returns the value 2 (H_MSG_TRUE) if the input is not empty. The behavior in case of empty input (no input contours available) is set via the operator set_system('no_object_result',<Result>). If necessary an exception is raised.

Combinations with other operators🔗

Combinations

Possible predecessors

gen_contours_skeleton_xldGenContoursSkeletonXld, edges_sub_pixEdgesSubPix, threshold_sub_pixThresholdSubPix, gen_contour_polygon_xldGenContourPolygonXld, test_self_intersection_xldTestSelfIntersectionXld

Alternatives

eccentricity_xldEccentricityXld

See also

elliptic_axis_points_xldEllipticAxisPointsXld, moments_region_2ndMomentsRegion2nd, select_shape_xldSelectShapeXld

Module🔗

Foundation