select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXld (Operator)

Name

select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXld — Auswahl von Konturen oder Polygonen mit Hilfe von Formmerkmalen.

Signatur

Beschreibung

select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXld wählt Konturen bzw. Polygone anhand ihrer Form aus. Für jede Eingabekontur bzw. jedes Eingabepolygon aus XLDXLDXLDXLDXLD 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 Kontur bzw. das Polygon 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: MinMinMinMinmin_i <= FeaturesFeaturesFeaturesFeaturesfeatures_i(Object) <= MaxMaxMaxMaxmax_i

Mögliche Werte für FeaturesFeaturesFeaturesFeaturesfeatures:

(alle Features könnten auch für Polygone verwendet werden)

'area':

Fläche des Objektes (vgl. area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld)

'area_points':

Fläche der Konturpunkte (vgl. area_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXldAreaCenterPointsXld)

'row':

Zeilenindex des Schwerpunkts (vgl. area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld)

'column':

Spaltenindex des Schwerpunkts (vgl. area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld)

'column_points':

Spaltenindex des Schwerpunkts der Konturpunkte (vgl. area_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXldAreaCenterPointsXld)

'row_points':

Zeilenindex des Schwerpunkts der Konturpunkte (vgl. area_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXldAreaCenterPointsXld)

'width':

Breite der Kontur (siehe height_width_ratio_xldheight_width_ratio_xldHeightWidthRatioXldHeightWidthRatioXldHeightWidthRatioXld)

'height':

Höhe der Kontur (siehe height_width_ratio_xldheight_width_ratio_xldHeightWidthRatioXldHeightWidthRatioXldHeightWidthRatioXld)

'ratio':

Verhältnis der Höhe zur Breite der Kontur (siehe height_width_ratio_xldheight_width_ratio_xldHeightWidthRatioXldHeightWidthRatioXldHeightWidthRatioXld)

'row1':

Zeilenindex der linken oberen Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xld)

'column1':

Spaltenindex der linken oberen Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xld)

'row2':

Zeilenindex der rechten unteren Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xld)

'column2':

Spaltenindex der rechten unteren Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xld)

'circularity':

Kreisförmigkeit (vgl. circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXld)

'compactness':

Kompaktheit (vgl. compactness_xldcompactness_xldCompactnessXldCompactnessXldCompactnessXld)

'rectangularity':

Rechteckigkeit (vgl. rectangularity_xldrectangularity_xldRectangularityXldRectangularityXldRectangularityXld)

'contlength':

Gesamtlänge der Kontur (vgl. length_xldlength_xldLengthXldLengthXldLengthXld)

'convexity':

Konvexität (vgl. convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXld)

'ra':

Hauptradius der äquivalenten Ellipse (vgl. elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXld)

'rb':

Nebenradius der äquivalenten Ellipse (vgl. elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXld)

'phi':

Orientierung der äquivalenten Ellipse (vgl. elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXld)

'ra_points':

Hauptradius der äquivalenten Ellipse der Konturpunkte (vgl. elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXldEllipticAxisPointsXld)

'rb_points':

Nebenradius der äquivalenten Ellipse Konturpunkte (vgl. elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXldEllipticAxisPointsXld)

'phi_points':

Orientierung der äquivalenten Ellipse Konturpunkte (vgl. elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXldEllipticAxisPointsXld)

'anisometry'

Anisometrie (vgl. eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXld)

'anisometry_points'

Anisometrie der Konturpunkte (vgl. eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldEccentricityPointsXld)

'bulkiness'

Bulkiness (vgl. eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXld)

'struct_factor'

Strukturfaktor (vgl. eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXld)

'outer_radius':

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

'max_diameter':

Maximale Ausdehnung der Region (vgl. diameter_xlddiameter_xldDiameterXldDiameterXldDiameterXld)

'orientation':

Orientierung der Region (vgl. orientation_xldorientation_xldOrientationXldOrientationXldOrientationXld)

'orientation_points':

Orientierung der Konturpunkte (vgl. orientation_points_xldorientation_points_xldOrientationPointsXldOrientationPointsXldOrientationPointsXld)

'rect2_phi':

Orientierung des kleinsten umschließenden Rechtecks (vgl. smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2XldSmallestRectangle2Xld)

'rect2_len1':

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

'rect2_len2':

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

'moments_m11','moments_m20','moments_m02':

Geometrische Konturenmomente (vgl. moments_xldmoments_xldMomentsXldMomentsXldMomentsXld)

'moments_m11_points','moments_m20_points','moments_m02_points':

Geometrische Momente der Konturpunkte (vgl. moments_points_xldmoments_points_xldMomentsPointsXldMomentsPointsXldMomentsPointsXld)

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. Bei der Berechnung einiger Merkmale muss darauf geachtet werden, dass sich die Eingabekonturen bzw. -polygone nicht selbst schneiden, da ansonsten keine aussagekräftigen Ergebnisse zurückgeliefert werden können (Ob sich die Eingabekonturen bzw. -polygone selbst schneiden oder nicht, lässt sich mit test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXld überprüfen).

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Ergebnis

select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXld 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. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXld, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPix, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXld, test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXld

Nachfolger

shape_trans_xldshape_trans_xldShapeTransXldShapeTransXldShapeTransXld, count_objcount_objCountObjCountObjCountObj

Siehe auch

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXld, area_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXldAreaCenterPointsXld, circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXld, compactness_xldcompactness_xldCompactnessXldCompactnessXldCompactnessXld, convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXld, elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXld, elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXldEllipticAxisPointsXld, eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXld, eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldEccentricityPointsXld, rectangularity_xldrectangularity_xldRectangularityXldRectangularityXldRectangularityXld, smallest_circle_xldsmallest_circle_xldSmallestCircleXldSmallestCircleXldSmallestCircleXld, smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xld, smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2XldSmallestRectangle2Xld, diameter_xlddiameter_xldDiameterXldDiameterXldDiameterXld, orientation_xldorientation_xldOrientationXldOrientationXldOrientationXld, orientation_points_xldorientation_points_xldOrientationPointsXldOrientationPointsXldOrientationPointsXld, moments_xldmoments_xldMomentsXldMomentsXldMomentsXld, moments_points_xldmoments_points_xldMomentsPointsXldMomentsPointsXldMomentsPointsXld, select_objselect_objSelectObjSelectObjSelectObj

Modul

Foundation