select_shape_xldselect_shape_xldselect_shape_xldSelectShapeXldSelectShapeXld (Operator)

Name

select_shape_xldselect_shape_xldselect_shape_xldSelectShapeXldSelectShapeXld — Select contours or polygons using shape features.

Signature

Description

The operator select_shape_xldselect_shape_xldselect_shape_xldSelectShapeXldSelectShapeXld selects contours or polygons according to their shape. For each input contour or polygon in XLDXLDXLDXLDXLD the indicated features (FeaturesFeaturesFeaturesFeaturesfeatures) are calculated. If each (OperationOperationOperationOperationoperation = 'and') or at least one (OperationOperationOperationOperationoperation = 'or') of the calculated features is within the limits (MinMinMinMinmin,MaxMaxMaxMaxmax) the contour respectively polygon is copied into the output.

Condition: MinMinMinMinmin_i <= FeaturesFeaturesFeaturesFeaturesfeatures_i(Object) <= MaxMaxMaxMaxmax_i

Possible values for FeaturesFeaturesFeaturesFeaturesfeatures:

(all features can be used with polygons as well)

'area':

Area of the contour (see area_center_xldarea_center_xldarea_center_xldAreaCenterXldAreaCenterXld)

'area_points':

Area of the contour points (see area_center_points_xldarea_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld)

'row':

Row index of the center of gravity (see area_center_xldarea_center_xldarea_center_xldAreaCenterXldAreaCenterXld)

'column':

Column index of the center of gravity (see area_center_xldarea_center_xldarea_center_xldAreaCenterXldAreaCenterXld)

'row_points':

Row index of the center of gravity of the contour points (see area_center_points_xldarea_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld)

'column_points':

Column index of the center of gravity of the contour points (see area_center_points_xldarea_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld)

'width':

Width of the contour

'height':

Height of the contour

'row1':

Row coordinate of upper left corner (see smallest_rectangle1_xldsmallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)

'column1':

Column coordinate of upper left corner (see smallest_rectangle1_xldsmallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)

'row2':

Row coordinate of lower right corner (see smallest_rectangle1_xldsmallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)

'column2':

Column coordinate of lower right corner (see smallest_rectangle1_xldsmallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)

'circularity':

Circularity (see circularity_xldcircularity_xldcircularity_xldCircularityXldCircularityXld)

'compactness':

Compactness (see compactness_xldcompactness_xldcompactness_xldCompactnessXldCompactnessXld)

'contlength':

Total length of contour (see length_xldlength_xldlength_xldLengthXldLengthXld)

'convexity':

Convexity (see convexity_xldconvexity_xldconvexity_xldConvexityXldConvexityXld)

'ra':

Major radius of the equivalent ellipse (see elliptic_axis_xldelliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXld)

'rb':

Minor radius of the equivalent ellipse (see elliptic_axis_xldelliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXld)

'phi':

Orientation of the equivalent ellipse (see elliptic_axis_xldelliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXld)

'ra_points':

Major radius of the equivalent ellipse of the contour points (see elliptic_axis_points_xldelliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld)

'rb_points':

Minor radius of the equivalent ellipse of the contour points (see elliptic_axis_points_xldelliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld)

'phi_points':

Orientation of the equivalent ellipse of the contour points (see elliptic_axis_points_xldelliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld)

'anisometry:'

Anisometry (see eccentricity_xldeccentricity_xldeccentricity_xldEccentricityXldEccentricityXld)

'anisometry_points:'

Anisometry of the contour points (see eccentricity_points_xldeccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXld)

'bulkiness:'

Bulkiness (see eccentricity_xldeccentricity_xldeccentricity_xldEccentricityXldEccentricityXld)

'struct_factor:'

Structure factor (see eccentricity_xldeccentricity_xldeccentricity_xldEccentricityXldEccentricityXld)

'outer_radius':

Radius of smallest enclosing circle (see smallest_circle_xldsmallest_circle_xldsmallest_circle_xldSmallestCircleXldSmallestCircleXld)

'max_diameter':

Maximum diameter of the contour (see diameter_xlddiameter_xlddiameter_xldDiameterXldDiameterXld)

'orientation':

Orientation of the contour (see orientation_xldorientation_xldorientation_xldOrientationXldOrientationXld)

'orientation_points':

Orientation of the contour points (see orientation_points_xldorientation_points_xldorientation_points_xldOrientationPointsXldOrientationPointsXld)

'rect2_phi':

Orientation of the smallest surrounding rectangle (see smallest_rectangle2_xldsmallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld)

'rect2_len1':

Half the length of the smallest surrounding rectangle (see smallest_rectangle2_xldsmallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld)

'rect2_len2':

Half the width of the smallest surrounding rectangle (see smallest_rectangle2_xldsmallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld)

'moments_m11', 'moments_m20', 'moments_m02':

Geometric moments of the contour (see moments_region_2ndmoments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m11_points', 'moments_m20_points', 'moments_m02_points':

Geometric moments of the contour points (see moments_points_xldmoments_points_xldmoments_points_xldMomentsPointsXldMomentsPointsXld)

If only one feature (FeaturesFeaturesFeaturesFeaturesfeatures) is used the value of OperationOperationOperationOperationoperation 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_xldtest_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld).

Parallelization

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

Parameters

Result

The operator select_shape_xldselect_shape_xldselect_shape_xldSelectShapeXldSelectShapeXld 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>)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

gen_contours_skeleton_xldgen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXld, edges_sub_pixedges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPix, threshold_sub_pixthreshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPix, gen_contour_polygon_xldgen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXld, test_self_intersection_xldtest_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld

Possible Successors

shape_trans_xldshape_trans_xldshape_trans_xldShapeTransXldShapeTransXld, count_objcount_objcount_objCountObjCountObj

See also

area_center_xldarea_center_xldarea_center_xldAreaCenterXldAreaCenterXld, area_center_points_xldarea_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld, circularity_xldcircularity_xldcircularity_xldCircularityXldCircularityXld, compactness_xldcompactness_xldcompactness_xldCompactnessXldCompactnessXld, convexity_xldconvexity_xldconvexity_xldConvexityXldConvexityXld, elliptic_axis_xldelliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXld, elliptic_axis_points_xldelliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld, eccentricity_xldeccentricity_xldeccentricity_xldEccentricityXldEccentricityXld, eccentricity_points_xldeccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXld, smallest_circle_xldsmallest_circle_xldsmallest_circle_xldSmallestCircleXldSmallestCircleXld, smallest_rectangle1_xldsmallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld, smallest_rectangle2_xldsmallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld, diameter_xlddiameter_xlddiameter_xldDiameterXldDiameterXld, orientation_xldorientation_xldorientation_xldOrientationXldOrientationXld, orientation_points_xldorientation_points_xldorientation_points_xldOrientationPointsXldOrientationPointsXld, moments_xldmoments_xldmoments_xldMomentsXldMomentsXld, moments_points_xldmoments_points_xldmoments_points_xldMomentsPointsXldMomentsPointsXld, select_objselect_objselect_objSelectObjSelectObj

Module

Foundation