Zusammenfassung
Berechnet eine paarweise Überschneidung der Eingabe- und 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 Radieren.
Abbildung
Verwendung
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.
Der Wert des Parameters Eingabe-Features muss ein Simple Feature sein: Punkt-, Multipoint-, Linien- oder Polygon-Features. Es können keine komplexen Features wie Annotation-Features, Bemaßungs-Features oder Netzwerk-Features sein.
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.
Vorsicht:
Geoverarbeitungswerkzeuge berücksichtigen die Teilungsmethoden von Geodatabase-Feature-Class- oder -Tabellenfeldern nicht.
Eingabe-Kurven-Features werden in der Ausgabe verdichtet.
Dieses Werkzeug basiert auf den Eingabe-Features, die einen räumlichen Index aufweisen. Verwenden Sie das Werkzeug Räumlichen Index hinzufügen, um einen neuen Index zu erstellen (insbesondere für Shapefiles) oder einen vorhandenen Index neu zu erstellen, falls Zweifel hinsichtlich seiner Korrektheit bestehen.
Wenn Ihre Eingabe-Features über M- oder Z-Werte verfügen, werden nur die M- oder Z-Werte der ersten Feature-Class auf die Ausgabe-Features übertragen. Wenn die erste Feature-Class keine M- oder Z-Werte enthält, enthält auch die Ausgabe keine M- oder Z-Werte.
Der Raumbezug der Ausgabe-Feature-Class entspricht dem der ersten Feature-Class im Parameter Eingabe-Features. Weitere Informationen finden Sie im Thema Raumbezug und Geoverarbeitung.
Standardmäßig werden Kurven-Features aus der Eingabe in der Ausgabe verdichtet. Um Kurven in der Ausgabe zu unterstützen, verwenden Sie die Umgebung Kurvensegmente beibehalten.
Dieses Werkzeug berücksichtigt die Umgebung Faktor für parallele Verarbeitung. Wenn die Umgebungsvariable nicht (Standardeinstellung) oder auf 100 festgelegt ist, wird die vollständige parallele Verarbeitung aktiviert und das Werkzeug versucht, die Arbeit auf alle logischen Kerne auf dem Computer zu verteilen. Durch Festlegen der Umgebung auf 0 wird die parallele Verarbeitung deaktiviert. Wenn ein Faktor zwischen 1 und 99 festgelegt wird, identifiziert das Werkzeug den Prozentsatz der zu verwendenden logischen Kerne, indem die Formel (Faktor für parallele Verarbeitung / 100 * logische Kerne) auf die nächste ganze Zahl aufgerundet angewendet wird. Wenn das Ergebnis dieser Formel 0 oder 1 ist, wird die parallele Verarbeitung nicht aktiviert.
Das Werkzeug Paarweise radieren ähnelt dem Werkzeug Radieren insofern, dass geometrische Schnittpunkte berechnet werden, es unterscheidet sich jedoch dadurch, dass Schnittpunkte für Feature-Paare statt Feature-Kombinationen berechnet werden. Dieses Werkzeug ist in Situationen effizient, in denen die Eingabe- oder Radieren-Feature-Classes große Mengen an dicht gepackten Features enthalten.
Syntax
arcpy.analysis.PairwiseErase(in_features, erase_features, out_feature_class, {cluster_tolerance})| Parameter | Erklärung | Datentyp |
in_features | Die Eingabe-Feature-Class oder der Eingabe-Feature-Layer. | Feature Layer |
erase_features | Die Features, die zum Ausradieren von lagegleichen Features in der Eingabe verwendet werden. | Feature Layer |
out_feature_class | Die Ausgabe-Feature-Class. | Feature Class |
cluster_tolerance (optional) | Der Mindestabstand 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. Vorsicht:Das Ändern dieses Parameterwertes kann zu einem Fehler oder zu 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
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion PairwiseErase im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = 'C:/data/gdb'
arcpy.PairwiseErase_analysis(r'redlands.gdb\rdlswells\well',
r'redlands.gdb\rdlsfloodzones\flood',
r'redlands.gdb\wellsoutside_flood')Suche nach Flächen mit geeigneter Vegetation, in denen sich keine Bereiche befinden, auf die sich die Einflüsse von Hauptstraßen auswirken.
# Name: PairwiseErase.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.Select_analysis(veg, suitableVeg, whereClause)
# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.Buffer_analysis(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.PairwiseErase_analysis(suitableVeg, roadsBuffer, eraseOutput)Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja