region_featuresRegionFeaturesRegionFeaturesregion_featuresregion_features

HALCON ScriptCpp++.NETPythonC

Short description

region_featuresRegionFeaturesRegionFeaturesregion_featuresregion_features — Calculate shape features of regions.

Signature

region_features( region Regions, string Features, out real Value )void RegionFeatures( const HObject& Regions, const HTuple& Features, HTuple* Value )static void HOperatorSet.RegionFeatures( HObject regions, HTuple features, out HTuple value )def region_features( regions: HObject, features: MaybeSequence[str] ) -> Sequence[float]

def region_features_s( regions: HObject, features: MaybeSequence[str] ) -> floatHerror region_features( const Hobject Regions, const char* Features, double* Value )

Herror T_region_features( const Hobject Regions, const Htuple Features, Htuple* Value )

HTuple HRegion::RegionFeatures( const HTuple& Features ) const

double HRegion::RegionFeatures( const HString& Features ) const

double HRegion::RegionFeatures( const char* Features ) const

double HRegion::RegionFeatures( const wchar_t* Features ) const (Windows only)

HTuple HRegion.RegionFeatures( HTuple features )

double HRegion.RegionFeatures( string features )

Description

The operator region_featuresRegionFeatures calculates for each input region from Regionsregionsregions the indicated features (Featuresfeaturesfeatures).

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

Possible values for Featuresfeaturesfeatures:

• 'area'"area": Area of the object

• 'row'"row": Row index of the center

• 'column'"column": Column index of the center

• 'row1'"row1": Row index of upper left corner

• 'column1'"column1": Column index of upper left corner

• 'row2'"row2": Row index of lower right corner

• 'column2'"column2": Column index of lower right corner

• 'width'"width": Width of the region (parallel to the coordinate axes)

• 'height'"height": Height of the region (parallel to the coordinate axes)

• 'ratio'"ratio": Ratio of the height and the width of the region (parallel to the coordinate axes)

• 'circularity'"circularity": Circularity (see circularityCircularity)

• 'compactness'"compactness": Compactness (see compactnessCompactness)

• 'contlength'"contlength": Total length of contour (see operator contlengthContlength)

• 'convexity'"convexity": Convexity (see convexityConvexity)

• 'rectangularity'"rectangularity": Rectangularity (see rectangularityRectangularity)

• 'ra'"ra": Main radius of the equivalent ellipse (see elliptic_axisEllipticAxis)

• 'rb'"rb": Secondary radius of the equivalent ellipse (see elliptic_axisEllipticAxis)

• 'phi'"phi": Orientation of the equivalent ellipse (see elliptic_axisEllipticAxis)

• 'anisometry'"anisometry": Anisometry (see eccentricityEccentricity)

• 'bulkiness'"bulkiness": Bulkiness (see operator eccentricityEccentricity)

• 'struct_factor'"struct_factor": Structure Factor (see operator eccentricityEccentricity)

• 'outer_radius'"outer_radius": Radius of smallest surrounding circle (see smallest_circleSmallestCircle)

• 'inner_radius'"inner_radius": Radius of largest inner circle (see inner_circleInnerCircle)

• 'inner_width'"inner_width": Width of the largest axis-parallel rectangle that fits into the region (see inner_rectangle1InnerRectangle1)

• 'inner_height'"inner_height": Height of the largest axis-parallel rectangle that fits into the region (see inner_rectangle1InnerRectangle1)

• 'dist_mean'"dist_mean": Mean distance from the region border to the center (see operator roundnessRoundness)

• 'dist_deviation'"dist_deviation": Deviation of the distance from the region border to the center (see operator roundnessRoundness)

• 'roundness'"roundness": Roundness (see operator roundnessRoundness)

• 'num_sides'"num_sides": Number of polygon sides (see operator roundnessRoundness)

• 'connect_num'"connect_num": Number of connection components (see operator connect_and_holesConnectAndHoles)

• 'holes_num'"holes_num": Number of holes (see operator connect_and_holesConnectAndHoles)

• 'area_holes'"area_holes": Area of the holes of the object (see operator area_holesAreaHoles)

• 'max_diameter'"max_diameter": Maximum diameter of the region (see operator diameter_regionDiameterRegion)

• 'orientation'"orientation": Orientation of the region (see operator orientation_regionOrientationRegion)

• 'euler_number'"euler_number": Euler number (see operator euler_numberEulerNumber)

• 'rect2_phi'"rect2_phi": Orientation of the smallest surrounding rectangle (see operator smallest_rectangle2SmallestRectangle2)

• 'rect2_len1'"rect2_len1": Half the length of the smallest surrounding rectangle (see operator smallest_rectangle2SmallestRectangle2)

• 'rect2_len2'"rect2_len2": Half the width of the smallest surrounding rectangle (see operator smallest_rectangle2SmallestRectangle2)

• 'moments_m11'"moments_m11": Geometric moments of the region (see operator moments_region_2ndMomentsRegion2nd)

• 'moments_m20'"moments_m20": Geometric moments of the region (see operator moments_region_2ndMomentsRegion2nd)

• 'moments_m02'"moments_m02": Geometric moments of the region (see operator moments_region_2ndMomentsRegion2nd)

• 'moments_ia'"moments_ia": Geometric moments of the region (see operator moments_region_2ndMomentsRegion2nd)

• 'moments_ib'"moments_ib": Geometric moments of the region (see operator moments_region_2ndMomentsRegion2nd)

• 'moments_m11_invar'"moments_m11_invar": Geometric moments of the region (see operator moments_region_2nd_invarMomentsRegion2ndInvar)

• 'moments_m20_invar'"moments_m20_invar": Geometric moments of the region (see operator moments_region_2nd_invarMomentsRegion2ndInvar)

• 'moments_m02_invar'"moments_m02_invar": Geometric moments of the region (see operator moments_region_2nd_invarMomentsRegion2ndInvar)

• 'moments_phi1'"moments_phi1": Geometric moments of the region (see operator moments_region_2nd_rel_invarMomentsRegion2ndRelInvar)

• 'moments_phi2'"moments_phi2": Geometric moments of the region (see operator moments_region_2nd_rel_invarMomentsRegion2ndRelInvar)

• 'moments_m21'"moments_m21": Geometric moments of the region (see operator moments_region_3rdMomentsRegion3rd)

• 'moments_m12'"moments_m12": Geometric moments of the region (see operator moments_region_3rdMomentsRegion3rd)

• 'moments_m03'"moments_m03": Geometric moments of the region (see operator moments_region_3rdMomentsRegion3rd)

• 'moments_m30'"moments_m30": Geometric moments of the region (see operator moments_region_3rdMomentsRegion3rd)

• 'moments_m21_invar'"moments_m21_invar": Geometric moments of the region (see operator moments_region_3rd_invarMomentsRegion3rdInvar)

• 'moments_m12_invar'"moments_m12_invar": Geometric moments of the region (see operator moments_region_3rd_invarMomentsRegion3rdInvar)

• 'moments_m03_invar'"moments_m03_invar": Geometric moments of the region (see operator moments_region_3rd_invarMomentsRegion3rdInvar)

• 'moments_m30_invar'"moments_m30_invar": Geometric moments of the region (see operator moments_region_3rd_invarMomentsRegion3rdInvar)

• 'moments_i1'"moments_i1": Geometric moments of the region (see operator moments_region_centralMomentsRegionCentral)

• 'moments_i2'"moments_i2": Geometric moments of the region (see operator moments_region_centralMomentsRegionCentral)

• 'moments_i3'"moments_i3": Geometric moments of the region (see operator moments_region_centralMomentsRegionCentral)

• 'moments_i4'"moments_i4": Geometric moments of the region (see operator moments_region_centralMomentsRegionCentral)

• 'moments_psi1'"moments_psi1": Geometric moments of the region (see operator moments_region_central_invarMomentsRegionCentralInvar)

• 'moments_psi2'"moments_psi2": Geometric moments of the region (see operator moments_region_central_invarMomentsRegionCentralInvar)

• 'moments_psi3'"moments_psi3": Geometric moments of the region (see operator moments_region_central_invarMomentsRegionCentralInvar)

• 'moments_psi4'"moments_psi4": Geometric moments of the region (see operator moments_region_central_invarMomentsRegionCentralInvar)

Several features are processed in the sequence in which they are entered.

Execution information

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

Regionsregionsregions (input_object) region-array → objectHObjectHRegionHObjectHobject

Regions to be examined.

Featuresfeaturesfeatures (input_control) string(-array) → (string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Shape features to be calculated.

Default: 'area'"area"
List of values: 'anisometry', 'area', 'area_holes', 'bulkiness', 'circularity', 'column', 'column1', 'column2', 'compactness', 'connect_num', 'contlength', 'convexity', 'dist_deviation', 'dist_mean', 'euler_number', 'height', 'holes_num', 'inner_height', 'inner_radius', 'inner_width', 'max_diameter', 'moments_i1', 'moments_i2', 'moments_i3', 'moments_i4', 'moments_ia', 'moments_ib', 'moments_m02', 'moments_m02_invar', 'moments_m03', 'moments_m03_invar', 'moments_m11', 'moments_m11_invar', 'moments_m12', 'moments_m12_invar', 'moments_m20', 'moments_m20_invar', 'moments_m21', 'moments_m21_invar', 'moments_m30', 'moments_m30_invar', 'moments_phi1', 'moments_phi2', 'moments_psi1', 'moments_psi2', 'moments_psi3', 'moments_psi4', 'num_sides', 'orientation', 'outer_radius', 'phi', 'ra', 'ratio', 'rb', 'rect2_len1', 'rect2_len2', 'rect2_phi', 'rectangularity', 'roundness', 'row', 'row1', 'row2', 'struct_factor', 'width'"anisometry", "area", "area_holes", "bulkiness", "circularity", "column", "column1", "column2", "compactness", "connect_num", "contlength", "convexity", "dist_deviation", "dist_mean", "euler_number", "height", "holes_num", "inner_height", "inner_radius", "inner_width", "max_diameter", "moments_i1", "moments_i2", "moments_i3", "moments_i4", "moments_ia", "moments_ib", "moments_m02", "moments_m02_invar", "moments_m03", "moments_m03_invar", "moments_m11", "moments_m11_invar", "moments_m12", "moments_m12_invar", "moments_m20", "moments_m20_invar", "moments_m21", "moments_m21_invar", "moments_m30", "moments_m30_invar", "moments_phi1", "moments_phi2", "moments_psi1", "moments_psi2", "moments_psi3", "moments_psi4", "num_sides", "orientation", "outer_radius", "phi", "ra", "ratio", "rb", "rect2_len1", "rect2_len2", "rect2_phi", "rectangularity", "roundness", "row", "row1", "row2", "struct_factor", "width"

Valuevaluevalue (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

The calculated features.

Example

(HDevelop)

read_image(Image,'monkey')
threshold(Image,S1,160,255)
connection(S1,S2)
region_features(S2,['area','anisometry'],Value)

Result

The operator region_featuresRegionFeatures returns the value 2 (H_MSG_TRUE) if the input is not empty. If necessary an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

thresholdThreshold, regiongrowingRegiongrowing, connectionConnection, runlength_featuresRunlengthFeatures

Possible successors

select_shapeSelectShape, select_graySelectGray, shape_transShapeTrans, reduce_domainReduceDomain, count_objCountObj

See also

area_centerAreaCenter, circularityCircularity, compactnessCompactness, contlengthContlength, convexityConvexity, rectangularityRectangularity, elliptic_axisEllipticAxis, eccentricityEccentricity, inner_circleInnerCircle, smallest_circleSmallestCircle, smallest_rectangle1SmallestRectangle1, smallest_rectangle2SmallestRectangle2, inner_rectangle1InnerRectangle1, roundnessRoundness, connect_and_holesConnectAndHoles, area_holesAreaHoles, diameter_regionDiameterRegion, orientation_regionOrientationRegion, moments_region_2ndMomentsRegion2nd, moments_region_2nd_invarMomentsRegion2ndInvar, moments_region_2nd_rel_invarMomentsRegion2ndRelInvar, moments_region_3rdMomentsRegion3rd, moments_region_3rd_invarMomentsRegion3rdInvar, moments_region_centralMomentsRegionCentral, moments_region_central_invarMomentsRegionCentralInvar, select_objSelectObj, select_shapeSelectShape

Module

Foundation