select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStd (Operator)
Name
select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStd — Select regions of a given shape.
Signature
Description
The operator select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStdSelectShapeStd compares the shape of the
given regions with default shapes. If the region has a similar shape
it is adopted into the output. Possible values for ShapeShapeShapeShapeshape
are:
- 'max_area'
The largest region is selected.
- 'rectangle1'
The surrounding rectangle parallel to the coordinate axes is
determined via the operator smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1. If the
area difference in percent
is larger than PercentPercentPercentPercentpercent the region is adopted.
- 'rectangle2'
The smallest surrounding rectangle with any orientation is
determined via the operator smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2. If the
area difference in percent
is larger than PercentPercentPercentPercentpercent the region is adopted. Note that as a more
robust alternative the operator select_shapeselect_shapeSelectShapeSelectShapeSelectShape with FeatureFeatureFeatureFeaturefeature
set to 'rectangularity'"rectangularity""rectangularity""rectangularity""rectangularity" can be used instead.
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
RegionsRegionsRegionsRegionsregions (input_object) region(-array) → objectHRegionHRegionHobject
Input regions to be selected.
SelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsselectedRegions (output_object) region(-array) → objectHRegionHRegionHobject *
Regions with desired shape.
ShapeShapeShapeShapeshape (input_control) string → HTupleHTupleHtuple (string) (string) (HString) (char*)
Shape features to be checked.
Default value:
'max_area'
"max_area"
"max_area"
"max_area"
"max_area"
List of values: 'max_area'"max_area""max_area""max_area""max_area", 'rectangle1'"rectangle1""rectangle1""rectangle1""rectangle1", 'rectangle2'"rectangle2""rectangle2""rectangle2""rectangle2"
PercentPercentPercentPercentpercent (input_control) real → HTupleHTupleHtuple (real) (double) (double) (double)
Similarity measure.
Default value: 70.0
Suggested values: 10.0, 30.0, 50.0, 60.0, 70.0, 80.0, 90.0, 95.0, 100.0
Typical range of values: 0.0
≤
Percent
Percent
Percent
Percent
percent
≤
100.0 (lin)
Minimum increment: 0.1
Recommended increment: 10.0
Possible Predecessors
thresholdthresholdThresholdThresholdThreshold,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing,
connectionconnectionConnectionConnectionConnection,
smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1,
smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2
Alternatives
intersectionintersectionIntersectionIntersectionIntersection,
complementcomplementComplementComplementComplement,
area_centerarea_centerAreaCenterAreaCenterAreaCenter,
select_shapeselect_shapeSelectShapeSelectShapeSelectShape
See also
smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1,
smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2,
rectangularityrectangularityRectangularityRectangularityRectangularity
Module
Foundation