select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape (Operator)

Name

select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape — Auswählen von Regionen mit Hilfe von Formmerkmalen.

Signatur

Beschreibung

select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape wählt Regionen anhand ihrer Form aus. Für jede Eingaberegion aus RegionsRegionsRegionsRegionsRegionsregions werden die angegebenen Merkmale (FeaturesFeaturesFeaturesFeaturesFeaturesfeatures) berechnet. Wenn jedes (OperationOperationOperationOperationOperationoperation = 'and') oder mindestens eines (OperationOperationOperationOperationOperationoperation = 'or') der so berechneten Merkmale in den vorgegebenen Grenzen (MinMinMinMinMinmin,MaxMaxMaxMaxMaxmax) liegt, wird die Region in die Ausgabe übernommen (dupliziert).

Bedingung: Min_i <= Feature_i(Object) <= Max_i

Mögliche Werte für FeaturesFeaturesFeaturesFeaturesFeaturesfeatures:

'area':

Fläche des Objektes

'row':

Zeilenindex der Schwerpunkts

'column':

Spaltenindex der Schwerpunkts

'width':

Breite der Region (parallel zur Koordinatenachse)

'height':

Höhe der Region (parallel zur Koordinatenachse)

'row1':

Zeilenindex der linken oberen Ecke

'column1':

Spaltenindex der linken oberen Ecke

'row2':

Zeilenindex der rechten unteren Ecke

'column2':

Spaltenindex der rechten unteren Ecke

'circularity':

Kreisförmigkeit (vgl. circularitycircularityCircularitycircularityCircularityCircularity)

'compactness':

Kompaktheit (vgl. compactnesscompactnessCompactnesscompactnessCompactnessCompactness)

'contlength':

Gesamtlänge der Kontur (vgl. contlengthcontlengthContlengthcontlengthContlengthContlength)

'convexity':

Konvexität (vgl. convexityconvexityConvexityconvexityConvexityConvexity)

'rectangularity':

Rechteckigkeit (vgl. rectangularityrectangularityRectangularityrectangularityRectangularityRectangularity)

'ra':

Hauptradius der äquivalenten Ellipse (vgl. elliptic_axiselliptic_axisEllipticAxiselliptic_axisEllipticAxisEllipticAxis)

'rb':

Nebenradius der äquivalenten Ellipse (vgl. elliptic_axiselliptic_axisEllipticAxiselliptic_axisEllipticAxisEllipticAxis)

'phi':

Orientierung der äquivalenten Ellipse (vgl. elliptic_axiselliptic_axisEllipticAxiselliptic_axisEllipticAxisEllipticAxis)

'anisometry'

Anisometrie (vgl. eccentricityeccentricityEccentricityeccentricityEccentricityEccentricity)

'bulkiness'

Bulkiness (vgl. Operator eccentricityeccentricityEccentricityeccentricityEccentricityEccentricity)

'struct_factor'

Struktur Faktor (vgl. Operator eccentricityeccentricityEccentricityeccentricityEccentricityEccentricity)

'outer_radius':

Radius des kleinsten umschließenden Kreises (vgl. smallest_circlesmallest_circleSmallestCirclesmallest_circleSmallestCircleSmallestCircle)

'inner_radius':

Radius des größten Inkreises (vgl. inner_circleinner_circleInnerCircleinner_circleInnerCircleInnerCircle)

'inner_width':

Breite des größten enthaltenen achsenparallelen Rechtecks (vgl. inner_rectangle1inner_rectangle1InnerRectangle1inner_rectangle1InnerRectangle1InnerRectangle1)

'inner_height':

Höhe des größten enthaltenen achsenparallelen Rechtecks (vgl. inner_rectangle1inner_rectangle1InnerRectangle1inner_rectangle1InnerRectangle1InnerRectangle1)

'dist_mean':

Mittlerer Abstand zwischen dem Rand der Region und ihrem Schwerpunkt (vgl. Operator roundnessroundnessRoundnessroundnessRoundnessRoundness)

'dist_deviation':

Standardabweichung des Abstands vom Regionenrand zum Schwerpunkt (vgl. Operator roundnessroundnessRoundnessroundnessRoundnessRoundness)

'roundness':

Rundheit (vgl. Operator roundnessroundnessRoundnessroundnessRoundnessRoundness)

'num_sides':

Anzahl Polygonseiten (vgl. Operator roundnessroundnessRoundnessroundnessRoundnessRoundness)

'connect_num':

Anzahl der Zusammenhangskomponenten (vgl. Operator connect_and_holesconnect_and_holesConnectAndHolesconnect_and_holesConnectAndHolesConnectAndHoles)

'holes_num':

Anzahl der Löcher (vgl. Operator connect_and_holesconnect_and_holesConnectAndHolesconnect_and_holesConnectAndHolesConnectAndHoles)

'area_holes:'

Fläche der Löcher des Objektes (vgl. Operator area_holesarea_holesAreaHolesarea_holesAreaHolesAreaHoles)

'max_diameter':

Maximale Ausdehnung der Region (vgl. Operator diameter_regiondiameter_regionDiameterRegiondiameter_regionDiameterRegionDiameterRegion)

'orientation':

Orientierung der Region (vgl. Operator orientation_regionorientation_regionOrientationRegionorientation_regionOrientationRegionOrientationRegion)

'euler_number':

Eulerzahl (vgl. Operator euler_numbereuler_numberEulerNumbereuler_numberEulerNumberEulerNumber)

'rect2_phi':

Orientierung des kleinsten umschließenden Rechtecks (vgl. Operator smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2)

'rect2_len1':

Halbe Länge des kleinsten umschließenden Rechtecks (vgl. Operator smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2)

'rect2_len2':

Halbe Breite des kleinsten umschließenden Rechtecks (vgl. Operator smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2)

'moments_m11':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m20':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m02':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_ia':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_ib':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m11_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_m20_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_m02_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_phi1':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar)

'moments_phi2':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar)

'moments_m21':

Geometrische Regionenmomente (vgl. Operator moments_region_3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m12':

Geometrische Regionenmomente (vgl. Operator moments_region_3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m03':

Geometrische Regionenmomente (vgl. Operator moments_region_3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m30':

Geometrische Regionenmomente (vgl. Operator moments_region_3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m21_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m12_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m03_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m30_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_i1':

Geometrische Regionenmomente (vgl. Operator moments_region_centralmoments_region_centralMomentsRegionCentralmoments_region_centralMomentsRegionCentralMomentsRegionCentral)

'moments_i2':

Geometrische Regionenmomente (vgl. Operator moments_region_centralmoments_region_centralMomentsRegionCentralmoments_region_centralMomentsRegionCentralMomentsRegionCentral)

'moments_i3':

Geometrische Regionenmomente (vgl. Operator moments_region_centralmoments_region_centralMomentsRegionCentralmoments_region_centralMomentsRegionCentralMomentsRegionCentral)

'moments_i4':

Geometrische Regionenmomente (vgl. Operator moments_region_centralmoments_region_centralMomentsRegionCentralmoments_region_centralMomentsRegionCentralMomentsRegionCentral)

'moments_psi1':

Geometrische Regionenmomente (vgl. Operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi2':

Geometrische Regionenmomente (vgl. Operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi3':

Geometrische Regionenmomente (vgl. Operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi4':

Geometrische Regionenmomente (vgl. Operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvar)

Wird nur ein Merkmal (FeaturesFeaturesFeaturesFeaturesFeaturesfeatures) verwendet, dann ist der Wert von OperationOperationOperationOperationOperationoperation bedeutungslos. Mehrere Merkmale werden in der Reihenfolge abgearbeitet, in der sie eingegeben werden.

Parallelisierung

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Automatisch parallelisiert auf Tupelebene.

Parameter

* where are the eyes of the ape ?
read_image(Image,'monkey')
threshold(Image,S1,160,255)
connection(S1,S2)
select_shape(S2,Eyes,['area','anisometry'],'and',[500,1.0],[50000,1.7])
disp_region(Eyes,WindowHandle)

/* where are the eyes of the ape ? */
read_image(&Image,"monkey");
threshold(Image,&S1,128.0,255.0);
connection(S1,&S2);
select_shape(S2,&S3,"area","and",500.0,50000.0);
select_shape(S3,&Eyes,"anisometry","and",1.0,1.7);
disp_region(Eyes,WindowHandle);

* where are the eyes of the ape ?
read_image(Image,'monkey')
threshold(Image,S1,160,255)
connection(S1,S2)
select_shape(S2,Eyes,['area','anisometry'],'and',[500,1.0],[50000,1.7])
disp_region(Eyes,WindowHandle)

#include "HIOStream.h"
#if !defined(USE_IOSTREAM_H)
using namespace std;
#endif
#include "HalconCpp.h"
using namespace Halcon;

int main ()
{
  HImage        img ("monkey");
  HWindow       w;

  HRegionArray  reg  = img.Regiongrowing (3, 3, 5, 0);
  HRegion       circ = HRegion::GenCircle (100, 100, MinRadius);
  HRegionArray  seg  = reg.SelectShapeProto (circ, "fits", 0, 0);

  seg.Display (w);
  w.Click ();

  return(0);
}

* where are the eyes of the ape ?
read_image(Image,'monkey')
threshold(Image,S1,160,255)
connection(S1,S2)
select_shape(S2,Eyes,['area','anisometry'],'and',[500,1.0],[50000,1.7])
disp_region(Eyes,WindowHandle)

* where are the eyes of the ape ?
read_image(Image,'monkey')
threshold(Image,S1,160,255)
connection(S1,S2)
select_shape(S2,Eyes,['area','anisometry'],'and',[500,1.0],[50000,1.7])
disp_region(Eyes,WindowHandle)

Ergebnis

select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe nicht leer ist. Das Verhalten bei leerer Eingabe (keine Eingabeobjekte vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Das Verhalten bei einer leeren Region (Region ist die leere Menge) wird mit set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) bestimmt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection, runlength_featuresrunlength_featuresRunlengthFeaturesrunlength_featuresRunlengthFeaturesRunlengthFeatures

Nachfolger

select_grayselect_graySelectGrayselect_graySelectGraySelectGray, shape_transshape_transShapeTransshape_transShapeTransShapeTrans, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, count_objcount_objCountObjcount_objCountObjCountObj

Alternativen

select_shape_stdselect_shape_stdSelectShapeStdselect_shape_stdSelectShapeStdSelectShapeStd

Siehe auch

area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter, circularitycircularityCircularitycircularityCircularityCircularity, compactnesscompactnessCompactnesscompactnessCompactnessCompactness, contlengthcontlengthContlengthcontlengthContlengthContlength, convexityconvexityConvexityconvexityConvexityConvexity, rectangularityrectangularityRectangularityrectangularityRectangularityRectangularity, elliptic_axiselliptic_axisEllipticAxiselliptic_axisEllipticAxisEllipticAxis, eccentricityeccentricityEccentricityeccentricityEccentricityEccentricity, inner_circleinner_circleInnerCircleinner_circleInnerCircleInnerCircle, smallest_circlesmallest_circleSmallestCirclesmallest_circleSmallestCircleSmallestCircle, smallest_rectangle1smallest_rectangle1SmallestRectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1, smallest_rectangle2smallest_rectangle2SmallestRectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2, inner_rectangle1inner_rectangle1InnerRectangle1inner_rectangle1InnerRectangle1InnerRectangle1, roundnessroundnessRoundnessroundnessRoundnessRoundness, connect_and_holesconnect_and_holesConnectAndHolesconnect_and_holesConnectAndHolesConnectAndHoles, area_holesarea_holesAreaHolesarea_holesAreaHolesAreaHoles, diameter_regiondiameter_regionDiameterRegiondiameter_regionDiameterRegionDiameterRegion, orientation_regionorientation_regionOrientationRegionorientation_regionOrientationRegionOrientationRegion, moments_region_2ndmoments_region_2ndMomentsRegion2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2nd, moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvar, moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar, moments_region_3rdmoments_region_3rdMomentsRegion3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rd, moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvar, moments_region_centralmoments_region_centralMomentsRegionCentralmoments_region_centralMomentsRegionCentralMomentsRegionCentral, moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvar, select_objselect_objSelectObjselect_objSelectObjSelectObj

Modul

Foundation