select_shapeselect_shapeSelectShapeSelectShape (Operator)

Name

select_shapeselect_shapeSelectShapeSelectShape — Choose regions with the aid of shape features.

Signature

Description

The operator select_shapeselect_shapeSelectShapeSelectShapeSelectShape chooses regions according to shape. For each input region from RegionsRegionsRegionsRegionsregions the indicated features (FeaturesFeaturesFeaturesFeaturesfeatures) are calculated. If each (OperationOperationOperationOperationoperation = 'and') or at least one (OperationOperationOperationOperationoperation = 'or') of the calculated features is within the default limits (MinMinMinMinmin,MaxMaxMaxMaxmax) the region is adapted into the output (duplicated).

Condition:

For an illustration of these features, please refer to the documentation of this chapter (Regions / Features).

Possible values for FeaturesFeaturesFeaturesFeaturesfeatures:

'area':

Area of the object

'row':

Row index of the center

'column':

Column index of the center

'width':

Width of the region (parallel to the coordinate axes; see height_width_ratioheight_width_ratioHeightWidthRatioHeightWidthRatioHeightWidthRatio)

'height':

Height of the region (parallel to the coordinate axes; see height_width_ratioheight_width_ratioHeightWidthRatioHeightWidthRatioHeightWidthRatio)

'ratio':

Ratio of the height and width of the region (parallel to the coordinate axes; see height_width_ratioheight_width_ratioHeightWidthRatioHeightWidthRatioHeightWidthRatio)

'row1':

Row index of upper left corner

'column1':

Column index of upper left corner

'row2':

Row index of lower right corner

'column2':

Column index of lower right corner

'circularity':

Circularity (see circularitycircularityCircularityCircularityCircularity)

'compactness':

Compactness (see compactnesscompactnessCompactnessCompactnessCompactness)

'contlength':

Total length of contour (see operator contlengthcontlengthContlengthContlengthContlength)

'convexity':

Convexity (see convexityconvexityConvexityConvexityConvexity)

'rectangularity':

Rectangularity (see rectangularityrectangularityRectangularityRectangularityRectangularity)

'ra':

Main radius of the equivalent ellipse (see elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis)

'rb':

Secondary radius of the equivalent ellipse (see elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis)

'phi':

Orientation of the equivalent ellipse (see elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis)

'anisometry:'

Anisometry (see eccentricityeccentricityEccentricityEccentricityEccentricity)

'bulkiness:'

Bulkiness (see operator eccentricityeccentricityEccentricityEccentricityEccentricity)

'struct_factor:'

Structur Factor (see operator eccentricityeccentricityEccentricityEccentricityEccentricity)

'outer_radius':

Radius of smallest surrounding circle (see smallest_circlesmallest_circleSmallestCircleSmallestCircleSmallestCircle)

'inner_radius':

Radius of largest inner circle (see inner_circleinner_circleInnerCircleInnerCircleInnerCircle)

'inner_width':

Width of the largest axis-parallel rectangle that fits into the region (see inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1InnerRectangle1)

'inner_height':

Height of the largest axis-parallel rectangle that fits into the region (see inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1InnerRectangle1)

'dist_mean':

Mean distance from the region border to the center (see operator roundnessroundnessRoundnessRoundnessRoundness)

'dist_deviation:'

Deviation of the distance from the region border from the center (see operator roundnessroundnessRoundnessRoundnessRoundness)

'roundness':

Roundness (see operator roundnessroundnessRoundnessRoundnessRoundness)

'num_sides':

Number of polygon sides (see operator roundnessroundnessRoundnessRoundnessRoundness)

'connect_num':

Number of connection components (see operator connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHoles)

'holes_num':

Number of holes (see operator connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHoles)

'area_holes':

Area of the holes of the object (see operator area_holesarea_holesAreaHolesAreaHolesAreaHoles)

'max_diameter':

Maximum diameter of the region (see operator diameter_regiondiameter_regionDiameterRegionDiameterRegionDiameterRegion)

'orientation':

Orientation of the region (see operator orientation_regionorientation_regionOrientationRegionOrientationRegionOrientationRegion)

'euler_number':

Euler number (see operator euler_numbereuler_numberEulerNumberEulerNumberEulerNumber)

'rect2_phi':

Orientation of the smallest surrounding rectangle (see operator smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2)

'rect2_len1':

Half the length of the smallest surrounding rectangle (see operator smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2)

'rect2_len2':

Half the width of the smallest surrounding rectangle (see operator smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2)

'moments_m11':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m20':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m02':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_ia':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_ib':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m11_invar':

Geometric moments of the region (see operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_m20_invar':

Geometric moments of the region (see operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_m02_invar':

Geometric moments of the region (see operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_phi1':

Geometric moments of the region (see operator moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar)

'moments_phi2':

Geometric moments of the region (see operator moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar)

'moments_m21':

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m12':

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m03':

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m30':

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m21_invar':

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m12_invar':

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m03_invar':

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m30_invar':

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_i1':

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral)

'moments_i2':

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral)

'moments_i3':

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral)

'moments_i4':

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral)

'moments_psi1':

Geometric moments of the region (see operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi2':

Geometric moments of the region (see operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi3':

Geometric moments of the region (see operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi4':

Geometric moments of the region (see operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar)

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.

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

* Where are the eyes of the Mandrill?
read_image(Image,'monkey')
threshold(Image,Region,128,255)
connection(Region,ConnectedRegions)
select_shape(ConnectedRegions,Eyes,['area','max_diameter'],\
             'and',[500,30.0],[1000,50.0])
dev_display(Eyes)

/* Where are the eyes of the Mandrill? */
read_image(&Image,"monkey");
threshold(Image,&Region,128.0,255.0);
connection(Region,&ConnectedRegions);
select_shape(ConnectedRegions,&SelectedRegions,"area","and",500.0,1000.0);
select_shape(SelectedRegions,&Eyes,"max_diameter","and",30.0,50.0);
disp_region(Eyes,WindowHandle);

* Where are the eyes of the Mandrill?
read_image(Image,'monkey')
threshold(Image,Region,128,255)
connection(Region,ConnectedRegions)
select_shape(ConnectedRegions,Eyes,['area','max_diameter'],\
             'and',[500,30.0],[1000,50.0])
dev_display(Eyes)

* Where are the eyes of the Mandrill?
read_image(Image,'monkey')
threshold(Image,Region,128,255)
connection(Region,ConnectedRegions)
select_shape(ConnectedRegions,Eyes,['area','max_diameter'],\
             'and',[500,30.0],[1000,50.0])
dev_display(Eyes)

* Where are the eyes of the Mandrill?
read_image(Image,'monkey')
threshold(Image,Region,128,255)
connection(Region,ConnectedRegions)
select_shape(ConnectedRegions,Eyes,['area','max_diameter'],\
             'and',[500,30.0],[1000,50.0])
dev_display(Eyes)

Result

The operator select_shapeselect_shapeSelectShapeSelectShapeSelectShape 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>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). The behavior in case of empty region (the region is the empty set) is set via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionConnectionConnection, runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeatures

Possible Successors

select_grayselect_graySelectGraySelectGraySelectGray, shape_transshape_transShapeTransShapeTransShapeTrans, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, count_objcount_objCountObjCountObjCountObj

Alternatives

select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStdSelectShapeStd

See also

area_centerarea_centerAreaCenterAreaCenterAreaCenter, circularitycircularityCircularityCircularityCircularity, compactnesscompactnessCompactnessCompactnessCompactness, contlengthcontlengthContlengthContlengthContlength, convexityconvexityConvexityConvexityConvexity, rectangularityrectangularityRectangularityRectangularityRectangularity, elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis, eccentricityeccentricityEccentricityEccentricityEccentricity, inner_circleinner_circleInnerCircleInnerCircleInnerCircle, smallest_circlesmallest_circleSmallestCircleSmallestCircleSmallestCircle, smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1, smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2, inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1InnerRectangle1, roundnessroundnessRoundnessRoundnessRoundness, connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHoles, area_holesarea_holesAreaHolesAreaHolesAreaHoles, diameter_regiondiameter_regionDiameterRegionDiameterRegionDiameterRegion, orientation_regionorientation_regionOrientationRegionOrientationRegionOrientationRegion, moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd, moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvar, moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar, moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd, moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar, moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral, moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar, select_objselect_objSelectObjSelectObjSelectObj

Module

Foundation