select_shapeselect_shapeSelectShapeSelectShapeselect_shape (算子)

名称

select_shapeselect_shapeSelectShapeSelectShapeselect_shape — 借助形状特征选择区域。

签名

描述

算子 select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape chooses regions according to shape. For each input region from RegionsRegionsRegionsRegionsregionsregions the indicated features (FeaturesFeaturesFeaturesFeaturesfeaturesfeatures) are calculated. If each (OperationOperationOperationOperationoperationoperation = 'and'"and""and""and""and""and") or at least one (OperationOperationOperationOperationoperationoperation = 'or'"or""or""or""or""or") of the calculated features is within the default limits (MinMinMinMinminmin,MaxMaxMaxMaxmaxmax) the region is adapted into the output (duplicated). The parameters MinMinMinMinminmin and MaxMaxMaxMaxmaxmax can be set to 'min'"min""min""min""min""min" or 'max'"max""max""max""max""max" in order to leave bottom and top limits, respectively, open.

Condition:

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

Possible values for FeaturesFeaturesFeaturesFeaturesfeaturesfeatures:

'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_ratioHeightWidthRatioHeightWidthRatioHeightWidthRatioheight_width_ratio)

'height'：

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

'ratio'：

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

'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 circularitycircularityCircularityCircularityCircularitycircularity)

'compactness'：

Compactness (see compactnesscompactnessCompactnessCompactnessCompactnesscompactness)

'contlength'：

Total length of contour (see operator contlengthcontlengthContlengthContlengthContlengthcontlength)

'convexity'：

Convexity (see convexityconvexityConvexityConvexityConvexityconvexity)

'rectangularity'：

Rectangularity (see rectangularityrectangularityRectangularityRectangularityRectangularityrectangularity)

'ra'：

Main radius of the equivalent ellipse (see elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxiselliptic_axis)

'rb'：

Secondary radius of the equivalent ellipse (see elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxiselliptic_axis)

'phi'：

Orientation of the equivalent ellipse (see elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxiselliptic_axis)

'anisometry:'

Anisometry (see eccentricityeccentricityEccentricityEccentricityEccentricityeccentricity)

'bulkiness:'

Bulkiness (see operator eccentricityeccentricityEccentricityEccentricityEccentricityeccentricity)

'struct_factor:'

Structure Factor (see operator eccentricityeccentricityEccentricityEccentricityEccentricityeccentricity)

'outer_radius'：

Radius of smallest surrounding circle (see smallest_circlesmallest_circleSmallestCircleSmallestCircleSmallestCirclesmallest_circle)

'inner_radius'：

Radius of largest inner circle (see inner_circleinner_circleInnerCircleInnerCircleInnerCircleinner_circle)

'inner_width'：

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

'inner_height'：

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

'dist_mean'：

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

'dist_deviation:'

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

'roundness'：

Roundness (see operator roundnessroundnessRoundnessRoundnessRoundnessroundness)

'num_sides'：

Number of polygon sides (see operator roundnessroundnessRoundnessRoundnessRoundnessroundness)

'connect_num'：

Number of connection components (see operator connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHolesconnect_and_holes)

'holes_num'：

Number of holes (see operator connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHolesconnect_and_holes)

'area_holes'：

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

'max_diameter'：

Maximum diameter of the region (see operator diameter_regiondiameter_regionDiameterRegionDiameterRegionDiameterRegiondiameter_region)

'orientation'：

Orientation of the region (see operator orientation_regionorientation_regionOrientationRegionOrientationRegionOrientationRegionorientation_region)

'euler_number'：

Euler number (see operator euler_numbereuler_numberEulerNumberEulerNumberEulerNumbereuler_number)

'rect2_phi'：

Orientation of the smallest surrounding rectangle (see operator smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2smallest_rectangle2)

'rect2_len1'：

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

'rect2_len2'：

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

'moments_m11'：

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2ndmoments_region_2nd)

'moments_m20'：

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2ndmoments_region_2nd)

'moments_m02'：

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2ndmoments_region_2nd)

'moments_ia'：

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2ndmoments_region_2nd)

'moments_ib'：

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2ndmoments_region_2nd)

'moments_m11_invar'：

Geometric moments of the region (see operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvarmoments_region_2nd_invar)

'moments_m20_invar'：

Geometric moments of the region (see operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvarmoments_region_2nd_invar)

'moments_m02_invar'：

Geometric moments of the region (see operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvarmoments_region_2nd_invar)

'moments_phi1'：

Geometric moments of the region (see operator moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarmoments_region_2nd_rel_invar)

'moments_phi2'：

Geometric moments of the region (see operator moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarmoments_region_2nd_rel_invar)

'moments_m21'：

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rdmoments_region_3rd)

'moments_m12'：

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rdmoments_region_3rd)

'moments_m03'：

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rdmoments_region_3rd)

'moments_m30'：

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rdmoments_region_3rd)

'moments_m21_invar'：

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvarmoments_region_3rd_invar)

'moments_m12_invar'：

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvarmoments_region_3rd_invar)

'moments_m03_invar'：

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvarmoments_region_3rd_invar)

'moments_m30_invar'：

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvarmoments_region_3rd_invar)

'moments_i1'：

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentralmoments_region_central)

'moments_i2'：

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentralmoments_region_central)

'moments_i3'：

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentralmoments_region_central)

'moments_i4'：

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentralmoments_region_central)

'moments_psi1'：

Geometric moments of the region (see operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvarmoments_region_central_invar)

'moments_psi2'：

Geometric moments of the region (see operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvarmoments_region_central_invar)

'moments_psi3'：

Geometric moments of the region (see operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvarmoments_region_central_invar)

'moments_psi4'：

Geometric moments of the region (see operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvarmoments_region_central_invar)

If only one feature (FeaturesFeaturesFeaturesFeaturesfeaturesfeatures) is used the value of OperationOperationOperationOperationoperationoperation is meaningless. Several features are processed in the sequence in which they are entered.

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 在元组级别上自动并行化。

参数

* 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)

结果

算子 select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape 在输入不为空时返回值 2 ( H_MSG_TRUE )。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>)set_system("no_object_result",<Result>)。空区域（区域是空集）的情况下的可设置行为通过 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>)set_system("empty_region_result",<Result>)。如有必要，则抛出异常。

可能的前趋

thresholdthresholdThresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionConnectionconnection, runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeaturesrunlength_features

可能的后继

select_grayselect_graySelectGraySelectGraySelectGrayselect_gray, shape_transshape_transShapeTransShapeTransShapeTransshape_trans, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, count_objcount_objCountObjCountObjCountObjcount_obj

替代

select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStdSelectShapeStdselect_shape_std

另见

area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center, circularitycircularityCircularityCircularityCircularitycircularity, compactnesscompactnessCompactnessCompactnessCompactnesscompactness, contlengthcontlengthContlengthContlengthContlengthcontlength, convexityconvexityConvexityConvexityConvexityconvexity, rectangularityrectangularityRectangularityRectangularityRectangularityrectangularity, elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxiselliptic_axis, eccentricityeccentricityEccentricityEccentricityEccentricityeccentricity, inner_circleinner_circleInnerCircleInnerCircleInnerCircleinner_circle, smallest_circlesmallest_circleSmallestCircleSmallestCircleSmallestCirclesmallest_circle, smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1, smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2smallest_rectangle2, inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1InnerRectangle1inner_rectangle1, roundnessroundnessRoundnessRoundnessRoundnessroundness, connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHolesconnect_and_holes, area_holesarea_holesAreaHolesAreaHolesAreaHolesarea_holes, diameter_regiondiameter_regionDiameterRegionDiameterRegionDiameterRegiondiameter_region, orientation_regionorientation_regionOrientationRegionOrientationRegionOrientationRegionorientation_region, moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2ndmoments_region_2nd, moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvarmoments_region_2nd_invar, moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarmoments_region_2nd_rel_invar, moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rdmoments_region_3rd, moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvarmoments_region_3rd_invar, moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentralmoments_region_central, moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvarmoments_region_central_invar, select_objselect_objSelectObjSelectObjSelectObjselect_obj

模块

基础