select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStd (Operator)

Name

select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStd — Select regions of a given shape.

Signature

select_shape_std(Regions : SelectedRegions : Shape, Percent : )

Herror select_shape_std(const Hobject Regions, Hobject* SelectedRegions, const char* Shape, double Percent)

Herror T_select_shape_std(const Hobject Regions, Hobject* SelectedRegions, const Htuple Shape, const Htuple Percent)

void SelectShapeStd(const HObject& Regions, HObject* SelectedRegions, const HTuple& Shape, const HTuple& Percent)

HRegion HRegion::SelectShapeStd(const HString& Shape, double Percent) const

HRegion HRegion::SelectShapeStd(const char* Shape, double Percent) const

HRegion HRegion::SelectShapeStd(const wchar_t* Shape, double Percent) const   (Windows only)

static void HOperatorSet.SelectShapeStd(HObject regions, out HObject selectedRegions, HTuple shape, HTuple percent)

HRegion HRegion.SelectShapeStd(string shape, double percent)

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

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