select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldselect_shape_xld (Operator)

Name

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

Signatur

Beschreibung

select_shape_xldselect_shape_xldSelectShapeXldSelectShapeXldSelectShapeXldselect_shape_xld 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'"and""and""and""and""and") oder mindestens eines (OperationOperationOperationOperationoperationoperation = 'or'"or""or""or""or""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_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld)

'area_points':

Fläche der Konturpunkte (vgl. area_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXldAreaCenterPointsXldarea_center_points_xld)

'row':

Zeilenindex des Schwerpunkts (vgl. area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld)

'column':

Spaltenindex des Schwerpunkts (vgl. area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld)

'column_points':

Spaltenindex des Schwerpunkts der Konturpunkte (vgl. area_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXldAreaCenterPointsXldarea_center_points_xld)

'row_points':

Zeilenindex des Schwerpunkts der Konturpunkte (vgl. area_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXldAreaCenterPointsXldarea_center_points_xld)

'width':

Breite der Kontur (siehe height_width_ratio_xldheight_width_ratio_xldHeightWidthRatioXldHeightWidthRatioXldHeightWidthRatioXldheight_width_ratio_xld)

'height':

Höhe der Kontur (siehe height_width_ratio_xldheight_width_ratio_xldHeightWidthRatioXldHeightWidthRatioXldHeightWidthRatioXldheight_width_ratio_xld)

'ratio':

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

'row1':

Zeilenindex der linken oberen Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xldsmallest_rectangle1_xld)

'column1':

Spaltenindex der linken oberen Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xldsmallest_rectangle1_xld)

'row2':

Zeilenindex der rechten unteren Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xldsmallest_rectangle1_xld)

'column2':

Spaltenindex der rechten unteren Ecke (vgl. Operator smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xldsmallest_rectangle1_xld)

'circularity':

Kreisförmigkeit (vgl. circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXldcircularity_xld)

'compactness':

Kompaktheit (vgl. compactness_xldcompactness_xldCompactnessXldCompactnessXldCompactnessXldcompactness_xld)

'rectangularity':

Rechteckigkeit (vgl. rectangularity_xldrectangularity_xldRectangularityXldRectangularityXldRectangularityXldrectangularity_xld)

'contlength':

Gesamtlänge der Kontur (vgl. length_xldlength_xldLengthXldLengthXldLengthXldlength_xld)

'convexity':

Konvexität (vgl. convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXldconvexity_xld)

'ra':

Hauptradius der äquivalenten Ellipse (vgl. elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXldelliptic_axis_xld)

'rb':

Nebenradius der äquivalenten Ellipse (vgl. elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXldelliptic_axis_xld)

'phi':

Orientierung der äquivalenten Ellipse (vgl. elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXldelliptic_axis_xld)

'ra_points':

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

'rb_points':

Nebenradius der äquivalenten Ellipse Konturpunkte (vgl. elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXldEllipticAxisPointsXldelliptic_axis_points_xld)

'phi_points':

Orientierung der äquivalenten Ellipse Konturpunkte (vgl. elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXldEllipticAxisPointsXldelliptic_axis_points_xld)

'anisometry'

Anisometrie (vgl. eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld)

'anisometry_points'

Anisometrie der Konturpunkte (vgl. eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldEccentricityPointsXldeccentricity_points_xld)

'bulkiness'

Bulkiness (vgl. eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld)

'struct_factor'

Strukturfaktor (vgl. eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld)

'outer_radius':

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

'max_diameter':

Maximale Ausdehnung der Region (vgl. diameter_xlddiameter_xldDiameterXldDiameterXldDiameterXlddiameter_xld)

'orientation':

Orientierung der Region (vgl. orientation_xldorientation_xldOrientationXldOrientationXldOrientationXldorientation_xld)

'orientation_points':

Orientierung der Konturpunkte (vgl. orientation_points_xldorientation_points_xldOrientationPointsXldOrientationPointsXldOrientationPointsXldorientation_points_xld)

'rect2_phi':

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

'rect2_len1':

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

'rect2_len2':

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

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

Geometrische Konturenmomente (vgl. moments_xldmoments_xldMomentsXldMomentsXldMomentsXldmoments_xld)

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

Geometrische Momente der Konturpunkte (vgl. moments_points_xldmoments_points_xldMomentsPointsXldMomentsPointsXldMomentsPointsXldmoments_points_xld)

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_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXldtest_self_intersection_xld ü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_xldSelectShapeXldSelectShapeXldSelectShapeXldselect_shape_xld 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>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

gen_contours_skeleton_xldgen_contours_skeleton_xldGenContoursSkeletonXldGenContoursSkeletonXldGenContoursSkeletonXldgen_contours_skeleton_xld, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPixedges_sub_pix, threshold_sub_pixthreshold_sub_pixThresholdSubPixThresholdSubPixThresholdSubPixthreshold_sub_pix, gen_contour_polygon_xldgen_contour_polygon_xldGenContourPolygonXldGenContourPolygonXldGenContourPolygonXldgen_contour_polygon_xld, test_self_intersection_xldtest_self_intersection_xldTestSelfIntersectionXldTestSelfIntersectionXldTestSelfIntersectionXldtest_self_intersection_xld

Nachfolger

shape_trans_xldshape_trans_xldShapeTransXldShapeTransXldShapeTransXldshape_trans_xld, count_objcount_objCountObjCountObjCountObjcount_obj

Siehe auch

area_center_xldarea_center_xldAreaCenterXldAreaCenterXldAreaCenterXldarea_center_xld, area_center_points_xldarea_center_points_xldAreaCenterPointsXldAreaCenterPointsXldAreaCenterPointsXldarea_center_points_xld, circularity_xldcircularity_xldCircularityXldCircularityXldCircularityXldcircularity_xld, compactness_xldcompactness_xldCompactnessXldCompactnessXldCompactnessXldcompactness_xld, convexity_xldconvexity_xldConvexityXldConvexityXldConvexityXldconvexity_xld, elliptic_axis_xldelliptic_axis_xldEllipticAxisXldEllipticAxisXldEllipticAxisXldelliptic_axis_xld, elliptic_axis_points_xldelliptic_axis_points_xldEllipticAxisPointsXldEllipticAxisPointsXldEllipticAxisPointsXldelliptic_axis_points_xld, eccentricity_xldeccentricity_xldEccentricityXldEccentricityXldEccentricityXldeccentricity_xld, eccentricity_points_xldeccentricity_points_xldEccentricityPointsXldEccentricityPointsXldEccentricityPointsXldeccentricity_points_xld, rectangularity_xldrectangularity_xldRectangularityXldRectangularityXldRectangularityXldrectangularity_xld, smallest_circle_xldsmallest_circle_xldSmallestCircleXldSmallestCircleXldSmallestCircleXldsmallest_circle_xld, smallest_rectangle1_xldsmallest_rectangle1_xldSmallestRectangle1XldSmallestRectangle1XldSmallestRectangle1Xldsmallest_rectangle1_xld, smallest_rectangle2_xldsmallest_rectangle2_xldSmallestRectangle2XldSmallestRectangle2XldSmallestRectangle2Xldsmallest_rectangle2_xld, diameter_xlddiameter_xldDiameterXldDiameterXldDiameterXlddiameter_xld, orientation_xldorientation_xldOrientationXldOrientationXldOrientationXldorientation_xld, orientation_points_xldorientation_points_xldOrientationPointsXldOrientationPointsXldOrientationPointsXldorientation_points_xld, moments_xldmoments_xldMomentsXldMomentsXldMomentsXldmoments_xld, moments_points_xldmoments_points_xldMomentsPointsXldMomentsPointsXldMomentsPointsXldmoments_points_xld, select_objselect_objSelectObjSelectObjSelectObjselect_obj

Modul

Foundation