Operator Reference

HALCON Operator Reference / Regions / Features
ClassesClasses | | Operators

select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStdselect_shape_std (Operator)

select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStdselect_shape_std — 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)

def select_shape_std(regions: HObject, shape: str, percent: float) -> HObject

Description

The operator select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStdselect_shape_std 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'"max_area""max_area""max_area""max_area"

The largest region is selected.

'rectangle1'"rectangle1""rectangle1""rectangle1""rectangle1"

The surrounding rectangle parallel to the coordinate axes is determined via the operator smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1. If the area difference in percent is larger than PercentPercentPercentpercentpercent the region is adopted.

'rectangle2'"rectangle2""rectangle2""rectangle2""rectangle2"

The smallest surrounding rectangle with any orientation is determined via the operator smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2smallest_rectangle2. 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_shapeSelectShapeSelectShapeselect_shape 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) → objectHRegionHObjectHObjectHobject

Input regions to be selected.

SelectedRegionsSelectedRegionsSelectedRegionsselectedRegionsselected_regions (output_object)  region(-array) → objectHRegionHObjectHObjectHobject *

Regions with desired shape.

ShapeShapeShapeshapeshape (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Shape features to be checked.

Default: '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 → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Similarity measure.

Default: 70.0

Suggested values: 10.0, 30.0, 50.0, 60.0, 70.0, 80.0, 90.0, 95.0, 100.0

Value range: 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_rectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1, smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2smallest_rectangle2

Alternatives

intersectionintersectionIntersectionIntersectionintersection, complementcomplementComplementComplementcomplement, area_centerarea_centerAreaCenterAreaCenterarea_center, select_shapeselect_shapeSelectShapeSelectShapeselect_shape

See also

smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1, smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2smallest_rectangle2, rectangularityrectangularityRectangularityRectangularityrectangularity

Module

Foundation

ClassesClasses | | Operators