select_shapeselect_shapeSelectShapeSelectShape (Operator)

Name

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

Signatur

Beschreibung

select_shapeselect_shapeSelectShapeSelectShapeSelectShape wählt Regionen anhand ihrer Form aus. Für jede Eingaberegion aus RegionsRegionsRegionsRegionsregions werden die angegebenen Merkmale (FeaturesFeaturesFeaturesFeaturesfeatures) berechnet. Wenn jedes (OperationOperationOperationOperationoperation = 'and') oder mindestens eines (OperationOperationOperationOperationoperation = 'or') der so berechneten Merkmale in den vorgegebenen Grenzen (MinMinMinMinmin,MaxMaxMaxMaxmax) liegt, wird die Region in die Ausgabe übernommen (dupliziert). Um diese Grenzen nach unten oder oben offen zu lassen, kann statt eines Wertes auch 'min'"min""min""min""min" beziehungsweise 'max'"max""max""max""max" für MinMinMinMinmin und MaxMaxMaxMaxmax gesetzt werden.

Bedingung:

In der Dokumentation zu diesem Kapitel (Regionen / Merkmale) finden Sie Illustrationen zu den unterschiedlichen Features.

Mögliche Werte für FeaturesFeaturesFeaturesFeaturesfeatures:

'area':

Fläche des Objektes

'row':

Zeilenindex der Schwerpunkts

'column':

Spaltenindex der Schwerpunkts

'width':

Breite der Region (parallel zu den Koordinatenachsen; siehe height_width_ratioheight_width_ratioHeightWidthRatioHeightWidthRatioHeightWidthRatio)

'height':

Höhe der Region (parallel zu den Koordinatenachsen; siehe height_width_ratioheight_width_ratioHeightWidthRatioHeightWidthRatioHeightWidthRatio)

'ratio':

Verhältnis der Höhe zur Breite der Region (parallel zu den Koordinatenachsen; siehe height_width_ratioheight_width_ratioHeightWidthRatioHeightWidthRatioHeightWidthRatio)

'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. circularitycircularityCircularityCircularityCircularity)

'compactness':

Kompaktheit (vgl. compactnesscompactnessCompactnessCompactnessCompactness)

'contlength':

Gesamtlänge der Kontur (vgl. contlengthcontlengthContlengthContlengthContlength)

'convexity':

Konvexität (vgl. convexityconvexityConvexityConvexityConvexity)

'rectangularity':

Rechteckigkeit (vgl. rectangularityrectangularityRectangularityRectangularityRectangularity)

'ra':

Hauptradius der äquivalenten Ellipse (vgl. elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis)

'rb':

Nebenradius der äquivalenten Ellipse (vgl. elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis)

'phi':

Orientierung der äquivalenten Ellipse (vgl. elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis)

'anisometry'

Anisometrie (vgl. eccentricityeccentricityEccentricityEccentricityEccentricity)

'bulkiness'

Bulkiness (vgl. Operator eccentricityeccentricityEccentricityEccentricityEccentricity)

'struct_factor'

Struktur Faktor (vgl. Operator eccentricityeccentricityEccentricityEccentricityEccentricity)

'outer_radius':

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

'inner_radius':

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

'inner_width':

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

'inner_height':

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

'dist_mean':

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

'dist_deviation':

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

'roundness':

Rundheit (vgl. Operator roundnessroundnessRoundnessRoundnessRoundness)

'num_sides':

Anzahl Polygonseiten (vgl. Operator roundnessroundnessRoundnessRoundnessRoundness)

'connect_num':

Anzahl der Zusammenhangskomponenten (vgl. Operator connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHoles)

'holes_num':

Anzahl der Löcher (vgl. Operator connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHoles)

'area_holes:'

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

'max_diameter':

Maximale Ausdehnung der Region (vgl. Operator diameter_regiondiameter_regionDiameterRegionDiameterRegionDiameterRegion)

'orientation':

Orientierung der Region (vgl. Operator orientation_regionorientation_regionOrientationRegionOrientationRegionOrientationRegion)

'euler_number':

Eulerzahl (vgl. Operator euler_numbereuler_numberEulerNumberEulerNumberEulerNumber)

'rect2_phi':

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

'rect2_len1':

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

'rect2_len2':

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

'moments_m11':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m20':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m02':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_ia':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_ib':

Geometrische Regionenmomente (vgl. Operator moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd)

'moments_m11_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_m20_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_m02_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvar)

'moments_phi1':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar)

'moments_phi2':

Geometrische Regionenmomente (vgl. Operator moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar)

'moments_m21':

Geometrische Regionenmomente (vgl. Operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m12':

Geometrische Regionenmomente (vgl. Operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m03':

Geometrische Regionenmomente (vgl. Operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m30':

Geometrische Regionenmomente (vgl. Operator moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd)

'moments_m21_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m12_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m03_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_m30_invar':

Geometrische Regionenmomente (vgl. Operator moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar)

'moments_i1':

Geometrische Regionenmomente (vgl. Operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral)

'moments_i2':

Geometrische Regionenmomente (vgl. Operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral)

'moments_i3':

Geometrische Regionenmomente (vgl. Operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral)

'moments_i4':

Geometrische Regionenmomente (vgl. Operator moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral)

'moments_psi1':

Geometrische Regionenmomente (vgl. Operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi2':

Geometrische Regionenmomente (vgl. Operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi3':

Geometrische Regionenmomente (vgl. Operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar)

'moments_psi4':

Geometrische Regionenmomente (vgl. Operator moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar)

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

Ausführungsinformationen

• 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 Mandrill?
read_image(Image,'monkey')
threshold(Image,Region,128,255)
connection(Region,ConnectedRegions)
select_shape(ConnectedRegions,Eyes,['area','max_diameter'],\
             'and',[500,30.0],[1000,50.0])
dev_display(Eyes)

/* Where are the eyes of the Mandrill? */
read_image(&Image,"monkey");
threshold(Image,&Region,128.0,255.0);
connection(Region,&ConnectedRegions);
select_shape(ConnectedRegions,&SelectedRegions,"area","and",500.0,1000.0);
select_shape(SelectedRegions,&Eyes,"max_diameter","and",30.0,50.0);
disp_region(Eyes,WindowHandle);

* Where are the eyes of the Mandrill?
read_image(Image,'monkey')
threshold(Image,Region,128,255)
connection(Region,ConnectedRegions)
select_shape(ConnectedRegions,Eyes,['area','max_diameter'],\
             'and',[500,30.0],[1000,50.0])
dev_display(Eyes)

* Where are the eyes of the Mandrill?
read_image(Image,'monkey')
threshold(Image,Region,128,255)
connection(Region,ConnectedRegions)
select_shape(ConnectedRegions,Eyes,['area','max_diameter'],\
             'and',[500,30.0],[1000,50.0])
dev_display(Eyes)

* Where are the eyes of the Mandrill?
read_image(Image,'monkey')
threshold(Image,Region,128,255)
connection(Region,ConnectedRegions)
select_shape(ConnectedRegions,Eyes,['area','max_diameter'],\
             'and',[500,30.0],[1000,50.0])
dev_display(Eyes)

Ergebnis

select_shapeselect_shapeSelectShapeSelectShapeSelectShape 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>)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>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) bestimmt. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionConnectionConnection, runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeatures

Nachfolger

select_grayselect_graySelectGraySelectGraySelectGray, shape_transshape_transShapeTransShapeTransShapeTrans, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, count_objcount_objCountObjCountObjCountObj

Alternativen

select_shape_stdselect_shape_stdSelectShapeStdSelectShapeStdSelectShapeStd

Siehe auch

area_centerarea_centerAreaCenterAreaCenterAreaCenter, circularitycircularityCircularityCircularityCircularity, compactnesscompactnessCompactnessCompactnessCompactness, contlengthcontlengthContlengthContlengthContlength, convexityconvexityConvexityConvexityConvexity, rectangularityrectangularityRectangularityRectangularityRectangularity, elliptic_axiselliptic_axisEllipticAxisEllipticAxisEllipticAxis, eccentricityeccentricityEccentricityEccentricityEccentricity, inner_circleinner_circleInnerCircleInnerCircleInnerCircle, smallest_circlesmallest_circleSmallestCircleSmallestCircleSmallestCircle, smallest_rectangle1smallest_rectangle1SmallestRectangle1SmallestRectangle1SmallestRectangle1, smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2, inner_rectangle1inner_rectangle1InnerRectangle1InnerRectangle1InnerRectangle1, roundnessroundnessRoundnessRoundnessRoundness, connect_and_holesconnect_and_holesConnectAndHolesConnectAndHolesConnectAndHoles, area_holesarea_holesAreaHolesAreaHolesAreaHoles, diameter_regiondiameter_regionDiameterRegionDiameterRegionDiameterRegion, orientation_regionorientation_regionOrientationRegionOrientationRegionOrientationRegion, moments_region_2ndmoments_region_2ndMomentsRegion2ndMomentsRegion2ndMomentsRegion2nd, moments_region_2nd_invarmoments_region_2nd_invarMomentsRegion2ndInvarMomentsRegion2ndInvarMomentsRegion2ndInvar, moments_region_2nd_rel_invarmoments_region_2nd_rel_invarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvarMomentsRegion2ndRelInvar, moments_region_3rdmoments_region_3rdMomentsRegion3rdMomentsRegion3rdMomentsRegion3rd, moments_region_3rd_invarmoments_region_3rd_invarMomentsRegion3rdInvarMomentsRegion3rdInvarMomentsRegion3rdInvar, moments_region_centralmoments_region_centralMomentsRegionCentralMomentsRegionCentralMomentsRegionCentral, moments_region_central_invarmoments_region_central_invarMomentsRegionCentralInvarMomentsRegionCentralInvarMomentsRegionCentralInvar, select_objselect_objSelectObjSelectObjSelectObj

Modul

Foundation