Features [HALCON Operator Reference / Version 13.0.4]

Operators

Features

List of Operators ↓

This chapter contains operators that allow you to access the different features of regions.

List of Features

In the following, the available features are illustrated.

'area':

Area of the object

'row':

Row index of the center

'column':

Column index of the center

'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

'width':

Width of the region (parallel to the coordinate axis)

'height':

Height of the region (parallel to the coordinate axis)

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

'rb':

Secondary radius of the equivalent ellipse (see elliptic_axiselliptic_axisEllipticAxiselliptic_axisEllipticAxisEllipticAxis)

'phi':

Orientation of the equivalent ellipse see elliptic_axiselliptic_axisEllipticAxiselliptic_axisEllipticAxisEllipticAxis)

'anisometry:'

Anisometry (see eccentricityeccentricityEccentricityeccentricityEccentricityEccentricity)

'bulkiness:'

Bulkiness (see operator eccentricityeccentricityEccentricityeccentricityEccentricityEccentricity)

'struct_factor:'

Structur Factor (see operator eccentricityeccentricityEccentricityeccentricityEccentricityEccentricity)

'outer_radius':

Radius of smallest surrounding circle (see smallest_circlesmallest_circleSmallestCirclesmallest_circleSmallestCircleSmallestCircle)

'inner_radius':

Radius of largest inner circle (see inner_circleinner_circleInnerCircleinner_circleInnerCircleInnerCircle)

'inner_width':

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

'inner_height':

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

'dist_mean':

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

'dist_deviation:'

Deviation of the distance from the region border to 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_holesConnectAndHolesconnect_and_holesConnectAndHolesConnectAndHoles)

'holes_num':

Number of holes (see operator connect_and_holesconnect_and_holesConnectAndHolesconnect_and_holesConnectAndHolesConnectAndHoles)

'area_holes':

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

'max_diameter':

Maximum diameter of the region (see operator diameter_regiondiameter_regionDiameterRegiondiameter_regionDiameterRegionDiameterRegion)

'orientation':

Orientation of the region (see operator orientation_regionorientation_regionOrientationRegionorientation_regionOrientationRegionOrientationRegion)

'euler_number':

Euler number (see operator euler_numbereuler_numberEulerNumbereuler_numberEulerNumberEulerNumber)

'rect2_phi':

Orientation of the smallest surrounding rectangle (see operator smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2)

'rect2_len1':

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

'rect2_len2':

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

'moments_m11':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m20':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m02':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_ia':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_ib':

Geometric moments of the region (see operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m11_invar':

Geometric moments of the region (see operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_m20_invar':

Geometric moments of the region (see operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_m02_invar':

Geometric moments of the region (see operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_phi1':

Geometric moments of the region (see operator moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar)

'moments_phi2':

'moments_m21':

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m12':

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m03':

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m30':

Geometric moments of the region (see operator moments_region_3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m21_invar':

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m12_invar':

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m03_invar':

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m30_invar':

Geometric moments of the region (see operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_i1':

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralmoments_region_centralMomentsRegionCentralMomentsRegionCentral)

'moments_i2':

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralmoments_region_centralMomentsRegionCentralMomentsRegionCentral)

'moments_i3':

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralmoments_region_centralMomentsRegionCentralMomentsRegionCentral)

'moments_i4':

Geometric moments of the region (see operator moments_region_centralmoments_region_centralMomentsRegionCentralmoments_region_centralMomentsRegionCentralMomentsRegionCentral)

'moments_psi1':

Geometric moments of the region (see operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi2':

'moments_psi3':

'moments_psi4':

List of Operators

area_centerAreaCenterAreaCenterarea_centerAreaCenterarea_center: Area and center of regions.

area_holesAreaHolesAreaHolesarea_holesAreaHolesarea_holes: Compute the area of holes of regions.

circularityCircularityCircularitycircularityCircularitycircularity: Shape factor for the circularity (similarity to a circle) of a region.

compactnessCompactnessCompactnesscompactnessCompactnesscompactness: Shape factor for the compactness of a region.

connect_and_holesConnectAndHolesConnectAndHolesconnect_and_holesConnectAndHolesconnect_and_holes: Number of connection components and holes

contlengthContlengthContlengthcontlengthContlengthcontlength: Contour length of a region.

convexityConvexityConvexityconvexityConvexityconvexity: Shape factor for the convexity of a region.

diameter_regionDiameterRegionDiameterRegiondiameter_regionDiameterRegiondiameter_region: Maximal distance between two boundary points of a region.

eccentricityEccentricityEccentricityeccentricityEccentricityeccentricity: Shape features derived from the ellipse parameters.

elliptic_axisEllipticAxisEllipticAxiselliptic_axisEllipticAxiselliptic_axis: Calculate the parameters of the equivalent ellipse.

euler_numberEulerNumberEulerNumbereuler_numberEulerNumbereuler_number: Calculate the Euler number.

find_neighborsFindNeighborsFindNeighborsfind_neighborsFindNeighborsfind_neighbors: Search direct neighbors.

get_region_indexGetRegionIndexGetRegionIndexget_region_indexGetRegionIndexget_region_index: Index of all regions containing a given pixel.

get_region_thicknessGetRegionThicknessGetRegionThicknessget_region_thicknessGetRegionThicknessget_region_thickness: Access the thickness of a region along the main axis.

hamming_distanceHammingDistanceHammingDistancehamming_distanceHammingDistancehamming_distance: Hamming distance between two regions.

hamming_distance_normHammingDistanceNormHammingDistanceNormhamming_distance_normHammingDistanceNormhamming_distance_norm: Hamming distance between two regions using normalization.

inner_circleInnerCircleInnerCircleinner_circleInnerCircleinner_circle: Largest inner circle of a region.

inner_rectangle1InnerRectangle1InnerRectangle1inner_rectangle1InnerRectangle1inner_rectangle1: Largest inner rectangle of a region.

moments_region_2ndMomentsRegion2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndmoments_region_2nd: Calculate the geometric moments of regions.

moments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarmoments_region_2nd_invarMomentsRegion2ndInvarmoments_region_2nd_invar: Geometric moments of regions.

moments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarmoments_region_2nd_rel_invar: Geometric moments of regions.

moments_region_3rdMomentsRegion3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rd: Geometric moments of regions.

moments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invar: Geometric moments of regions.

moments_region_centralMomentsRegionCentralMomentsRegionCentralmoments_region_centralMomentsRegionCentralmoments_region_central: Geometric moments of regions.

moments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarmoments_region_central_invarMomentsRegionCentralInvarmoments_region_central_invar: Geometric moments of regions.

orientation_regionOrientationRegionOrientationRegionorientation_regionOrientationRegionorientation_region: Orientation of a region.

rectangularityRectangularityRectangularityrectangularityRectangularityrectangularity: Shape factor for the rectangularity of a region.

region_featuresRegionFeaturesRegionFeaturesregion_featuresRegionFeaturesregion_features: Calculate shape features of regions.

roundnessRoundnessRoundnessroundnessRoundnessroundness: Shape factors from contour.

runlength_distributionRunlengthDistributionRunlengthDistributionrunlength_distributionRunlengthDistributionrunlength_distribution: Distribution of runs needed for runlength encoding of a region.

runlength_featuresRunlengthFeaturesRunlengthFeaturesrunlength_featuresRunlengthFeaturesrunlength_features: Characteristic values for runlength coding of regions.

select_region_pointSelectRegionPointSelectRegionPointselect_region_pointSelectRegionPointselect_region_point: Choose all regions containing a given pixel.

select_region_spatialSelectRegionSpatialSelectRegionSpatialselect_region_spatialSelectRegionSpatialselect_region_spatial: Pose relation of regions.

select_shapeSelectShapeSelectShapeselect_shapeSelectShapeselect_shape: Choose regions with the aid of shape features.

select_shape_protoSelectShapeProtoSelectShapeProtoselect_shape_protoSelectShapeProtoselect_shape_proto: Choose regions having a certain relation to each other.

select_shape_stdSelectShapeStdSelectShapeStdselect_shape_stdSelectShapeStdselect_shape_std: Select regions of a given shape.

smallest_circleSmallestCircleSmallestCirclesmallest_circleSmallestCirclesmallest_circle: Smallest surrounding circle of a region.

smallest_rectangle1SmallestRectangle1SmallestRectangle1smallest_rectangle1SmallestRectangle1smallest_rectangle1: Surrounding rectangle parallel to the coordinate axes.

smallest_rectangle2SmallestRectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2: Smallest surrounding rectangle with any orientation.

spatial_relationSpatialRelationSpatialRelationspatial_relationSpatialRelationspatial_relation: Pose relation of regions with regard to the coordinate axes.

Operators