Radieren (Analysis Tools)

Zusammenfassung

Dieses Werkzeug erstellt eine Feature-Class durch Überlagerung der Eingabe-Features mit den Radieren-Features. Nur die Bereiche der Eingabe-Features, die außerhalb der Radieren-Features liegen, werden in die Ausgabe-Feature-Class kopiert.

Für Radieren-Operationen gibt es ein alternatives Werkzeug Weitere Informationen finden Sie in der Dokumentation zum Werkzeug Paarweise radieren.

Abbildung

Abbildung zum Werkzeug "Radieren"

Verwendung

Geometrien, bei denen die Parameterwerte Eingabe-Features und Radieren-Features lagegleich sind, werden entfernt.
Der Wert des Parameters Radieren-Features kann vom Typ Punkt, Linie oder Polygon sein, solange der Wert des Parameters Eingabe-Features den gleichen oder einen niedrigeren Feature-Typ aufweist. Ein Polygon-Radieren-Feature kann zum Ausradieren von Polygonen, Linien oder Punkten aus Eingabe-Features verwendet werden, ein Linien-Radieren-Feature kann zum Ausradieren von Linien oder Punkten aus Eingabe-Features verwendet werden, und ein Punkt-Radieren-Feature kann zum Ausradieren von Punkten aus Eingabe-Features verwendet werden.
Die Attributwerte der Eingabe-Feature-Classes werden in die Ausgabe-Feature-Class kopiert. Wenn es sich bei der Eingabe jedoch um Layer handelt, die mit dem Werkzeug "Feature-Layer erstellen" erstellt wurden, und die Option Verhältnismethode verwenden eines Feldes aktiviert ist, wird ein Verhältnis zum Eingabe-Attributwert berechnet. Ist die Option Verhältnismethode verwenden aktiviert, stellen die Attribute des resultierenden Features bei jeder Teilung eines Features in einem Überlagerungsvorgang ein Verhältnis des Attributwertes des Eingabe-Features dar. Der Ausgabewert basiert auf dem Verhältnis, in dem die Eingabe-Feature-Geometrie geteilt wurde. Wenn die Geometrie beispielsweise in gleiche Teile geteilt wurde, wird dem Attributwert jedes neuen Features der halbe Wert des Attributwertes des Eingabe-Features zugewiesen. Verhältnismethode verwenden gilt nur für numerische Feldtypen.

Achtung:

Geoverarbeitungswerkzeuge berücksichtigen die Teilungsmethoden von Geodatabase-Feature-Class- oder -Tabellenfeldern nicht.
Dieses Werkzeug wendet einen Kachelungsvorgang an, um beim Verarbeiten großer Datasets eine bessere Performance und Skalierbarkeit zu erzielen. Weitere Informationen finden Sie unter "Gekachelte Verarbeitung großer Datasets".
Dieses Werkzeug kann selbst dann Multipart-Features in der Ausgabe erstellen, wenn es sich bei allen Eingaben um Singlepart-Features handelt. Wenn Sie keine Multipart-Features erhalten möchten, verwenden Sie für die Ausgabe-Feature-Class das Werkzeug Multipart in Singlepart.

Beschriftung	Erläuterung	Datentyp
Eingabe-Features	Die Eingabe-Feature-Class oder der Eingabe-Feature-Layer.	Feature Layer
Radieren-Features	Die Features, die zum Radieren lagegleicher Features in der Eingabe verwendet werden.	Feature Layer
Ausgabe-Feature-Class	Die Feature-Class, in die nur die Eingabe-Features aufgenommen werden, die nicht lagegleich mit den Radieren-Features sind.	Feature Class
XY-Toleranz (Optional)	Die Mindestentfernung zwischen allen Feature-Koordinaten (Knoten und Stützpunkte) sowie die Strecke, die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) verschoben werden kann. Achtung: Eine Änderung des Wertes dieses Parameters kann zu Fehlern oder unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft "XY-Toleranz" des Raumbezugs der Eingabe-Feature-Class verwendet.	Linear Unit

arcpy.analysis.Erase(in_features, erase_features, out_feature_class, {cluster_tolerance})

Name	Erläuterung	Datentyp
in_features	Die Eingabe-Feature-Class oder der Eingabe-Feature-Layer.	Feature Layer
erase_features	Die Features, die zum Radieren lagegleicher Features in der Eingabe verwendet werden.	Feature Layer
out_feature_class	Die Feature-Class, in die nur die Eingabe-Features aufgenommen werden, die nicht lagegleich mit den Radieren-Features sind.	Feature Class
cluster_tolerance (Optional)	Die Mindestentfernung zwischen allen Feature-Koordinaten (Knoten und Stützpunkte) sowie die Strecke, die eine Koordinate auf der X- bzw. Y-Achse (oder beiden) verschoben werden kann. Achtung: Eine Änderung des Wertes dieses Parameters kann zu Fehlern oder unerwarteten Ergebnissen führen. Es wird empfohlen, diesen Parameter nicht zu ändern. Er wurde im Werkzeug-Dialogfeld aus der Ansicht entfernt. Standardmäßig wird die Eigenschaft "XY-Toleranz" des Raumbezugs der Eingabe-Feature-Class verwendet.	Linear Unit

Codebeispiel

Erase: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = 'C:/data/gdb'
arcpy.analysis.Erase(r'redlands.gdb\rdlswells\well',
                     r'redlands.gdb\rdlsfloodzones\flood',
                     r'redlands.gdb\wellsoutside_flood')

Erase: Beispiel 2 (eigenständiges Skript)

Suche nach Flächen mit geeigneter Vegetation, in denen sich keine Bereiche befinden, auf die sich die Einflüsse von Hauptstraßen auswirken.

# Name: Erase.py
# Description: Find areas of suitable vegetation that exclude areas heavily
#              impacted by major roads

# Import system modules
import arcpy

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

# Select suitable vegetation patches from all vegetation
veg = "vegtype"
suitableVeg = "C:/output/Output.gdb/suitable_vegetation"
whereClause = "HABITAT = 1"
arcpy.analysis.Select(veg, suitableVeg, whereClause)

# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.analysis.Buffer(roads, roadsBuffer, distanceField, "FULL", "ROUND",
                      "LIST", dissolveField)

# Erase areas of impact around major roads from the suitable vegetation patches
eraseOutput = "C:/output/Output.gdb/suitable_vegetation_minus_roads"
arcpy.analysis.Erase(suitableVeg, roadsBuffer, eraseOutput)

Umgebungen

Auto-Commit, Vollständig qualifizierte Feldnamen beibehalten, Standard-Ausgabe-Z-Werte, M-Auflösung, M-Toleranz, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-M-Domäne, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Ausgabe-Koordinatensystem, Geographische Transformationen, Ausdehnung, Ausgabe hat M-Werte, Ausgabe hat Z-Werte, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz, Faktor für parallele Verarbeitung, Geodatabase-Feldeigenschaften übertragen

Sonderfälle

Faktor für parallele Verarbeitung

This tool honors the Parallel Processing Factor environment. If the environment is not set (the default) or is set to 0, parallel processing will be disabled; parallel processing will not be used and processing will be done sequentially. Setting the environment to 100 will enable parallel processing; parallel processing will be used and processing will be done in parallel. Up to 10 cores will be used when parallel processing is enabled.

Parallel processing is currently supported for polygon-on-polygon, line-on-polygon, and point-on-polygon overlay operations.

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja