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). Um diese Grenzen nach unten oder oben offen zu lassen, kann statt eines Wertes auch 'min'"min""min""min""min""min" beziehungsweise 'max'"max""max""max""max""max" für MinMinMinMinMinmin und MaxMaxMaxMaxMaxmax gesetzt werden.

Bedingung:

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

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

* 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_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