select_shape_xldselect_shape_xldSelectShapeXldselect_shape_xldSelectShapeXldSelectShapeXld (Operator)

Name

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

Signatur

Beschreibung

select_shape_xldselect_shape_xldSelectShapeXldselect_shape_xldSelectShapeXldSelectShapeXld wählt Konturen bzw. Polygone anhand ihrer Form aus. Für jede Eingabekontur bzw. jedes Eingabepolygon aus XLDXLDXLDXLDXLDXLD 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 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""min" beziehungsweise 'max'"max""max""max""max""max" für MinMinMinMinMinmin und MaxMaxMaxMaxMaxmax gesetzt werden.

Bedingung: MinMinMinMinMinmin_i <= FeaturesFeaturesFeaturesFeaturesFeaturesfeatures_i(Object) <= MaxMaxMaxMaxMaxmax_i

Mögliche Werte für FeaturesFeaturesFeaturesFeaturesFeaturesfeatures:

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

'area':

Fläche des Objektes (vgl. area_center_xldarea_center_xldAreaCenterXldarea_center_xldAreaCenterXldAreaCenterXld)

'area_points':

Fläche der Konturpunkte (vgl. area_center_points_xldarea_center_points_xldAreaCenterPointsXldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld)

'row':

Zeilenindex des Schwerpunkts (vgl. area_center_xldarea_center_xldAreaCenterXldarea_center_xldAreaCenterXldAreaCenterXld)

'column':

Spaltenindex des Schwerpunkts (vgl. area_center_xldarea_center_xldAreaCenterXldarea_center_xldAreaCenterXldAreaCenterXld)

'column_points':

Spaltenindex des Schwerpunkts der Konturpunkte (vgl. area_center_points_xldarea_center_points_xldAreaCenterPointsXldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld)

'row_points':

Zeilenindex des Schwerpunkts der Konturpunkte (vgl. area_center_points_xldarea_center_points_xldAreaCenterPointsXldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld)

'width':

Breite der Kontur

'height':

Höhe der Kontur

'row1':

Zeilenindex der linken oberen Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)

'column1':

Spaltenindex der linken oberen Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)

'row2':

Zeilenindex der rechten unteren Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)

'column2':

Spaltenindex der rechten unteren Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld)

'circularity':

Kreisförmigkeit (vgl. circularity_xldcircularity_xldCircularityXldcircularity_xldCircularityXldCircularityXld)

'compactness':

Kompaktheit (vgl. compactness_xldcompactness_xldCompactnessXldcompactness_xldCompactnessXldCompactnessXld)

'contlength':

Gesamtlänge der Kontur (vgl. length_xldlength_xldLengthXldlength_xldLengthXldLengthXld)

'convexity':

Konvexität (vgl. convexity_xldconvexity_xldConvexityXldconvexity_xldConvexityXldConvexityXld)

'ra':

Hauptradius der äquivalenten Ellipse (vgl. elliptic_axis_xldelliptic_axis_xldEllipticAxisXldelliptic_axis_xldEllipticAxisXldEllipticAxisXld)

'rb':

Nebenradius der äquivalenten Ellipse (vgl. elliptic_axis_xldelliptic_axis_xldEllipticAxisXldelliptic_axis_xldEllipticAxisXldEllipticAxisXld)

'phi':

Orientierung der äquivalenten Ellipse (vgl. elliptic_axis_xldelliptic_axis_xldEllipticAxisXldelliptic_axis_xldEllipticAxisXldEllipticAxisXld)

'ra_points':

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

'rb_points':

Nebenradius der äquivalenten Ellipse Konturpunkte (vgl. elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld)

'phi_points':

Orientierung der äquivalenten Ellipse Konturpunkte (vgl. elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld)

'anisometry'

Anisometrie (vgl. eccentricity_xldeccentricity_xldEccentricityXldeccentricity_xldEccentricityXldEccentricityXld)

'anisometry_points'

Anisometrie der Konturpunkte (vgl. eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXld)

'bulkiness'

Bulkiness (vgl. eccentricity_xldeccentricity_xldEccentricityXldeccentricity_xldEccentricityXldEccentricityXld)

'struct_factor'

Strukturfaktor (vgl. eccentricity_xldeccentricity_xldEccentricityXldeccentricity_xldEccentricityXldEccentricityXld)

'outer_radius':

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

'max_diameter':

Maximale Ausdehnung der Region (vgl. diameter_xlddiameter_xldDiameterXlddiameter_xldDiameterXldDiameterXld)

'orientation':

Orientierung der Region (vgl. orientation_xldorientation_xldOrientationXldorientation_xldOrientationXldOrientationXld)

'orientation_points':

Orientierung der Konturpunkte (vgl. orientation_points_xldorientation_points_xldOrientationPointsXldorientation_points_xldOrientationPointsXldOrientationPointsXld)

'rect2_phi':

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

'rect2_len1':

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

'rect2_len2':

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

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

Geometrische Konturenmomente (vgl. moments_xldmoments_xldMomentsXldmoments_xldMomentsXldMomentsXld)

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

Geometrische Momente der Konturpunkte (vgl. moments_points_xldmoments_points_xldMomentsPointsXldmoments_points_xldMomentsPointsXldMomentsPointsXld)

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. 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_xldTestSelfIntersectionXldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld überprüfen).

Parallelisierung

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

Vorgänger

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXld, edges_sub_pixedges_sub_pixEdgesSubPixedges_sub_pixEdgesSubPixEdgesSubPix, threshold_sub_pixthreshold_sub_pixThresholdSubPixthreshold_sub_pixThresholdSubPixThresholdSubPix, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXld, test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXld

Nachfolger

shape_trans_xldshape_trans_xldShapeTransXldshape_trans_xldShapeTransXldShapeTransXld, count_objcount_objCountObjcount_objCountObjCountObj

Siehe auch

area_center_xldarea_center_xldAreaCenterXldarea_center_xldAreaCenterXldAreaCenterXld, area_center_points_xldarea_center_points_xldAreaCenterPointsXldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXld, circularity_xldcircularity_xldCircularityXldcircularity_xldCircularityXldCircularityXld, compactness_xldcompactness_xldCompactnessXldcompactness_xldCompactnessXldCompactnessXld, convexity_xldconvexity_xldConvexityXldconvexity_xldConvexityXldConvexityXld, elliptic_axis_xldelliptic_axis_xldEllipticAxisXldelliptic_axis_xldEllipticAxisXldEllipticAxisXld, elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXld, eccentricity_xldeccentricity_xldEccentricityXldeccentricity_xldEccentricityXldEccentricityXld, eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXld, smallest_circle_xldsmallest_circle_xldSmallestCircleXldsmallest_circle_xldSmallestCircleXldSmallestCircleXld, smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1Xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1Xld, smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2Xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2Xld, diameter_xlddiameter_xldDiameterXlddiameter_xldDiameterXldDiameterXld, orientation_xldorientation_xldOrientationXldorientation_xldOrientationXldOrientationXld, orientation_points_xldorientation_points_xldOrientationPointsXldorientation_points_xldOrientationPointsXldOrientationPointsXld, moments_xldmoments_xldMomentsXldmoments_xldMomentsXldMomentsXld, moments_points_xldmoments_points_xldMomentsPointsXldmoments_points_xldMomentsPointsXldMomentsPointsXld, select_objselect_objSelectObjselect_objSelectObjSelectObj

Modul

Foundation