select_shape_xldSelectShapeXldSelectShapeXldselect_shape_xldselect_shape_xld🔗

Short description🔗

select_shape_xldSelectShapeXldSelectShapeXldselect_shape_xldselect_shape_xld — Select contours or polygons using shape features.

Signature🔗

select_shape_xld( xld XLD, out xld SelectedXLD, string Features, string Operation, real Min, real Max )

Description🔗

The operator select_shape_xldSelectShapeXld selects contours or polygons according to their shape. For each input contour or polygon in XLDXLDxld the indicated features (Featuresfeaturesfeatures) are calculated. If each (Operationoperationoperation = 'and'"and") or at least one (Operationoperationoperation = 'or'"or") of the calculated features is within the limits (Minminmin,Maxmaxmax) the contour respectively polygon is copied into the output. The parameters Minminmin and Maxmaxmax can be set to 'min'"min" or 'max'"max" in order to leave bottom and top limits, respectively, open.

Condition:

\[\begin{eqnarray*} \textrm{Min}_{i} \leq \textrm{Features}_{i}(Object) \leq \textrm{Max}_{i} \end{eqnarray*}\]

Possible values for Featuresfeaturesfeatures:

(all features can be used with polygons as well)

‘area’: Area of the contour (see area_center_xldAreaCenterXld)
‘area_points’: Area of the contour points (see area_center_points_xldAreaCenterPointsXld)
‘row’: Row index of the center of gravity (see area_center_xldAreaCenterXld)
‘column’: Column index of the center of gravity (see area_center_xldAreaCenterXld)
‘row_points’: Row index of the center of gravity of the contour points (see area_center_points_xldAreaCenterPointsXld)
‘column_points’: Column index of the center of gravity of the contour points (see area_center_points_xldAreaCenterPointsXld)
‘width’: Width of the contour (see height_width_ratio_xldHeightWidthRatioXld)
‘height’: Height of the contour (see height_width_ratio_xldHeightWidthRatioXld)
‘ratio’: Ratio of the height and the width of the contour (see height_width_ratio_xldHeightWidthRatioXld)
‘row1’: Row coordinate of upper left corner (see smallest_rectangle1_xldSmallestRectangle1Xld)
‘column1’: Column coordinate of upper left corner (see smallest_rectangle1_xldSmallestRectangle1Xld)
‘row2’: Row coordinate of lower right corner (see smallest_rectangle1_xldSmallestRectangle1Xld)
‘column2’: Column coordinate of lower right corner (see smallest_rectangle1_xldSmallestRectangle1Xld)
‘circularity’: Circularity (see circularity_xldCircularityXld)
‘compactness’: Compactness (see compactness_xldCompactnessXld)
‘rectangularity’: Rectangularity (see rectangularity_xldRectangularityXld)
‘contlength’: Total length of contour (see length_xldLengthXld)
‘convexity’: Convexity (see convexity_xldConvexityXld)
‘ra’: Major radius of the equivalent ellipse (see elliptic_axis_xldEllipticAxisXld)
‘rb’: Minor radius of the equivalent ellipse (see elliptic_axis_xldEllipticAxisXld)
‘phi’: Orientation of the equivalent ellipse (see elliptic_axis_xldEllipticAxisXld)
‘ra_points’: Major radius of the equivalent ellipse of the contour points (see elliptic_axis_points_xldEllipticAxisPointsXld)
‘rb_points’: Minor radius of the equivalent ellipse of the contour points (see elliptic_axis_points_xldEllipticAxisPointsXld)
‘phi_points’: Orientation of the equivalent ellipse of the contour points (see elliptic_axis_points_xldEllipticAxisPointsXld)
‘anisometry:’ Anisometry (see eccentricity_xldEccentricityXld)
‘anisometry_points:’ Anisometry of the contour points (see eccentricity_points_xldEccentricityPointsXld)
‘bulkiness:’ Bulkiness (see eccentricity_xldEccentricityXld)
‘struct_factor:’ Structure factor (see eccentricity_xldEccentricityXld)
‘outer_radius’: Radius of smallest enclosing circle (see smallest_circle_xldSmallestCircleXld)
‘max_diameter’: Maximum diameter of the contour (see diameter_xldDiameterXld)
‘orientation’: Orientation of the contour (see orientation_xldOrientationXld)
‘orientation_points’: Orientation of the contour points (see orientation_points_xldOrientationPointsXld)
‘rect2_phi’: Orientation of the smallest surrounding rectangle (see smallest_rectangle2_xldSmallestRectangle2Xld)
‘rect2_len1’: Half the length of the smallest surrounding rectangle (see smallest_rectangle2_xldSmallestRectangle2Xld)
‘rect2_len2’: Half the width of the smallest surrounding rectangle (see smallest_rectangle2_xldSmallestRectangle2Xld)
‘moments_m11’, ‘moments_m20’, ‘moments_m02’: Geometric moments of the contour (see moments_region_2ndMomentsRegion2nd)
‘moments_m11_points’, ‘moments_m20_points’, ‘moments_m02_points’: Geometric moments of the contour points (see moments_points_xldMomentsPointsXld)

If only one feature (Featuresfeaturesfeatures) is used the value of Operationoperationoperation is meaningless. Several features are processed in the sequence in which they are entered.The use of some features requires that the input contour respectively polygon must not intersect itself, otherwise the results are not meaningful (Whether the input contour or polygon intersects itself or not can be determined with test_self_intersection_xldTestSelfIntersectionXld).

Execution information🔗

Execution information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters🔗

XLDXLDxld (input_object) xld-array → objectHObjectHXLDHObjectHobject

Contours or polygons to be examined.

SelectedXLDselectedXLDselected_xld (output_object) xld-array → objectHObjectHXLDHObjectHobject *

Contours or polygons fulfilling the condition(s).

Featuresfeaturesfeatures (input_control) string(-array) → (string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Shape features to be checked.

Default: 'area'"area"
List of values: 'anisometry', 'anisometry_points', 'area', 'area_points', 'bulkiness', 'circularity', 'column', 'column1', 'column2', 'column_points', 'compactness', 'contlength', 'convexity', 'height', 'max_diameter', 'moments_m02', 'moments_m02_points', 'moments_m11', 'moments_m11_points', 'moments_m20', 'moments_m20_points', 'orientation', 'orientation_points', 'outer_radius', 'phi', 'phi_points', 'ra', 'ra_points', 'ratio', 'rb', 'rb_points', 'rect2_len1', 'rect2_len2', 'rect2_phi', 'rectangularity', 'row', 'row1', 'row2', 'row_points', 'struct_factor', 'width'

Operationoperationoperation (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Operation type between the individual features.

Default: 'and'"and"
List of values: 'and', 'or'"and", "or"

Minminmin (input_control) real(-array) → (real / integer / string)HTuple (double / Hlong / HString)HTuple (double / int / long / string)MaybeSequence[Union[int, float, str]]Htuple (double / Hlong / char*)

Lower limits of the features or ‘min’.

Default: 150.0150.0
Minimum increment: 0.001
Recommended increment: 1.0

Maxmaxmax (input_control) real(-array) → (real / integer / string)HTuple (double / Hlong / HString)HTuple (double / int / long / string)MaybeSequence[Union[int, float, str]]Htuple (double / Hlong / char*)

Upper limits of the features or ‘max’.

Default: 99999.099999.0
Minimum increment: 0.001
Recommended increment: 1.0
Restriction: Max >= Min

Result🔗

The operator select_shape_xldSelectShapeXld returns the value 2 (H_MSG_TRUE) if the input is not empty. The behavior in case of empty input (no input objects 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

Possible successors

shape_trans_xldShapeTransXld, count_objCountObj

Module🔗

Foundation