Entfernen (Eliminate) (Data Management Tools)

Zusammenfassung

Entfernt Polygone, indem sie mit benachbarten Polygonen zusammengeführt werden, die die größte Fläche oder die längste gemeinsame Grenze besitzen. Dieses Werkzeug wird häufig verwendet, um kleine Splitterpolygone zu entfernen, die das Ergebnis eines Überlagerungsvorgangs wie z. B. beim Werkzeug Überschneiden (Intersect) oder Vereinigen (Union) sind.

Abbildung

Abbildung: Werkzeug "Entfernen (Eliminate)"

Verwendung

Die zu entfernenden Features werden durch eine Auswahl bestimmt, die auf einen Polygon-Layer angewendet wird. Die Auswahl muss zuvor festgelegt werden. Verwenden Sie dazu Layer nach Attributen auswählen bzw. Layer lagebezogen auswählen, oder fragen Sie einen Layer in einer Karte ab.
In Abhängigkeit vom Dataset werden von diesem Werkzeug ggf. nicht alle ausgewählten Features entfernt. Ausgewählte Features können nicht mit einem benachbarten, ausgewählten Feature zusammengeführt werden. Beispielsweise kann ein ausgewähltes Feature, das von anderen ausgewählten Features umgeben ist, nicht zusammengeführt werden. Dies trifft ebenfalls auf die Grenzen von anderen ausgewählten Features zu. Um die ausgewählten, aber nicht zusammengeführten Features zu entfernen, wählen Sie die Features erneut aus, und führen Sie das Werkzeug nochmals aus.

Ein ausgewähltes Feature, das keine benachbarten Features mit gemeinsamer Grenze aufweist, kann nicht zusammengeführt werden.
Der Parameter Eingabe-Layer muss eine Auswahl enthalten; andernfalls schlägt das Werkzeug fehl.
Die Parameter Ausschlussausdruck und Ausschluss-Layer schließen sich nicht gegenseitig aus und können zusammen verwendet werden, um genau zu steuern, was entfernt werden soll.

Beschriftung	Erläuterung	Datentyp
Eingabe-Layer	Der Layer mit den Polygonen, die mit angrenzenden Polygonen zusammengeführt werden	Feature Layer
Ausgabe-Feature-Class	Die zu erstellende Feature-Class.	Feature Class
Polygone an Grenze entfernen (Optional)	Gibt an, ob das ausgewählte Polygon mit dem Polygon mit der längsten gemeinsamen Grenze oder mit dem Polygon mit der größten Fläche zusammengeführt wird. Aktiviert—Das ausgewählte Polygon wird mit dem benachbarten Polygon mit der längsten gemeinsamen Grenze zusammengeführt. Dies ist die Standardeinstellung. Deaktiviert—Das ausgewählte Polygon wird mit dem benachbarten Polygon mit der größten Fläche zusammengeführt.	Boolean
Ausschlussausdruck (Optional)	Ein SQL-Ausdruck, mit dem Features identifiziert werden, die nicht geändert werden.	SQL Expression
Ausschluss-Layer (Optional)	Eingabe-Polyline- oder -Polygon-Feature-Class bzw. -Layer zur Definition von Polygongrenzen oder Teilen von Polygongrenzen, die nicht entfernt werden.	Feature Layer

arcpy.management.Eliminate(in_features, out_feature_class, {selection}, {ex_where_clause}, {ex_features})

Name	Erläuterung	Datentyp
in_features	Der Layer mit den Polygonen, die mit angrenzenden Polygonen zusammengeführt werden	Feature Layer
out_feature_class	Die zu erstellende Feature-Class.	Feature Class
selection (Optional)	Gibt an, ob das ausgewählte Polygon mit dem Polygon mit der längsten gemeinsamen Grenze oder mit dem Polygon mit der größten Fläche zusammengeführt wird. `LENGTH`—Das ausgewählte Polygon wird mit dem benachbarten Polygon mit der längsten gemeinsamen Grenze zusammengeführt. Dies ist die Standardeinstellung. `AREA`—Das ausgewählte Polygon wird mit dem benachbarten Polygon mit der größten Fläche zusammengeführt.	Boolean
ex_where_clause (Optional)	Ein SQL-Ausdruck, mit dem Features identifiziert werden, die nicht geändert werden. Weitere Informationen zur SQL-Syntax finden Sie im Hilfethema "SQL-Referenz für in Abfrageausdrücken verwendete Elemente".	SQL Expression
ex_features (Optional)	Eingabe-Polyline- oder -Polygon-Feature-Class bzw. -Layer zur Definition von Polygongrenzen oder Teilen von Polygongrenzen, die nicht entfernt werden.	Feature Layer

Codebeispiel

Eliminate: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion Eliminate im Direkt-Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Census"
arcpy.management.MakeFeatureLayer("blockgrp", "blocklayer")
arcpy.management.SelectLayerByAttribute("blocklayer", "NEW_SELECTION",
                                        '"Area_Sq_Miles" < 0.15')
arcpy.management.Eliminate("blocklayer", "C:/output/output.gdb/eliminate_output",
                           "LENGTH", '"OBJECTID" = 9')

Eliminate: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion Eliminate verwendet wird.

# Description: Eliminate features based on a selection.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Census"

# Set local variables
inFeatures = "blockgrp"
tempLayer = "blocklayer"
expression = '"Area_Sq_Miles" < 0.15'
outFeatureClass = "C:/output/output.gdb/eliminate_output"
exclusionExpression = '"OBJECTID" = 9'

# Run MakeFeatureLayer
arcpy.management.MakeFeatureLayer(inFeatures, tempLayer)

# Run SelectLayerByAttribute to define features to be eliminated
arcpy.management.SelectLayerByAttribute(tempLayer, "NEW_SELECTION", expression)

# Run Eliminate
arcpy.management.Eliminate(tempLayer, outFeatureClass, "LENGTH",
                           exclusionExpression)

Umgebungen

Aktueller Workspace, Scratch-Workspace, Ausgabe-Koordinatensystem, Ausdehnung, XY-Auflösung, XY-Toleranz, Ausgabe hat M-Werte, M-Auflösung, M-Toleranz, Ausgabe hat Z-Werte, Standard-Ausgabe-Z-Werte, Z-Auflösung, Z-Toleranz, Vollständig qualifizierte Feldnamen beibehalten, Ausgabe-CONFIG-Schlüsselwort, Auto-Commit, Ausgabe-XY-Domäne, Ausgabe-M-Domäne, Ausgabe-Z-Domäne

Lizenzierungsinformationen

Basic: Nein
Standard: Nein
Advanced: Ja