Symmetrische Differenz (Analysis Tools)

Zusammenfassung

Berechnet eine geometrische Verschneidung der Eingabe- und Update-Features. Nicht überlappende Eingabe- und Update-Features werden ausgegeben. Features oder Teile von Features in den Eingabe-Features und Update-Features, die sich nicht überlappen, werden in die Ausgabe-Feature-Class geschrieben.

Abbildung

Abbildung des Werkzeugs "Symmetrische Differenz"

Verwendung

Die Eingabe- und die Update-Feature-Class bzw. der -Feature-Layer müssen den gleichen Geometrietyp aufweisen.
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(../data-management/make-feature-layer.yml) 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
Update-Features	Die Update-Feature-Class oder der -Layer. Der Geometrietyp muss dem Geometrietyp der Eingabe-Feature-Class bzw. des -Layers entsprechen.	Feature Layer
Ausgabe-Feature-Class	Die Feature-Class mit den Ergebnissen.	Feature Class
Zu verbindende Attribute (Optional)	Gibt an, welche Attribute in die Ausgabe-Feature-Class übertragen werden. Die `FID_<name>`-Werte betragen bei jedem Eingabe-Feature (oder Teil eines Eingabe-Features), das kein anderes Aktualisierungs-Feature überschneidet, -1. Die Attributwerte für die anderen Feature-Classes in der symmetrischen Differenz, bei denen kein Schnittpunkt festgestellt wurde, werden nicht in das Ausgabe-Feature übertragen und ihre Werte werden auf leere Zeichenfolgen oder 0 festgelegt. Alle Attribute—Alle Attribute der Eingabe-Features werden in die Ausgabe-Feature-Class übertragen. Dies ist die Standardeinstellung. Alle Attribute mit Ausnahme von Feature-IDs—Alle Attribute der Eingabe-Features mit Ausnahme der FID werden in die Ausgabe-Feature-Class übertragen. Nur Feature-IDs—Nur das FID-Feld der Eingabe-Features wird auf die Ausgabe-Feature-Class übertragen.	String
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.SymDiff(in_features, update_features, out_feature_class, {join_attributes}, {cluster_tolerance})

Name	Erläuterung	Datentyp
in_features	Die Eingabe-Feature-Class oder der Eingabe-Feature-Layer.	Feature Layer
update_features	Die Update-Feature-Class oder der -Layer. Der Geometrietyp muss dem Geometrietyp der Eingabe-Feature-Class bzw. des -Layers entsprechen.	Feature Layer
out_feature_class	Die Feature-Class mit den Ergebnissen.	Feature Class
join_attributes (Optional)	Gibt an, welche Attribute in die Ausgabe-Feature-Class übertragen werden. Die `FID_<name>`-Werte betragen bei jedem Eingabe-Feature (oder Teil eines Eingabe-Features), das kein anderes Aktualisierungs-Feature überschneidet, -1. Die Attributwerte für die anderen Feature-Classes in der symmetrischen Differenz, bei denen kein Schnittpunkt festgestellt wurde, werden nicht in das Ausgabe-Feature übertragen und ihre Werte werden auf leere Zeichenfolgen oder 0 festgelegt. `ALL`—Alle Attribute der Eingabe-Features werden in die Ausgabe-Feature-Class übertragen. Dies ist die Standardeinstellung. `NO_FID`—Alle Attribute der Eingabe-Features mit Ausnahme der FID werden in die Ausgabe-Feature-Class übertragen. `ONLY_FID`—Nur das FID-Feld der Eingabe-Features wird auf die Ausgabe-Feature-Class übertragen.	String
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

SymDiff: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.SymDiff("climate.shp", "elevlt250.shp", "C:/output/symdiff.shp",
                       "ALL", 0.001)

SymDiff: Beispiel 2 (eigenständiges Skript)

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

# Description: Create symmetrical difference between input and update features

# Import system modules
import arcpy

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

# Set local variables
inFeatures = "climate.shp"
updateFeatures = "elevlt250.shp"
outFeatureClass = "C:/output/symdiff.shp"
clusterTolerance = 0.001

# Run SymDiff
arcpy.analysis.SymDiff(inFeatures, updateFeatures, outFeatureClass, "ALL",
                       clusterTolerance)

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, Faktor für parallele Verarbeitung, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz, 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.

Lizenzierungsinformationen

Basic: Nein
Standard: Nein
Advanced: Ja