Verschneiden (Identity) (Analysis Tools)

Zusammenfassung

Hiermit wird ein geometrischer Schnittpunkt der Eingabe- und Identity-Features berechnet. Die Eingabe-Features oder deren Teile, die die Identity-Features überlappen, erhalten die Attribute dieser Identity-Features.

Abbildung

Abbildung des Werkzeugs "Verschneiden (Identity)"

Verwendung

Die Werte des Parameters Eingabe-Features können Punkt-, Multipoint-, Linien- oder Polygon-Features sein. Annotations-, Bemaßungs- und Netzwerk-Features sind als Eingabe nicht zulässig.
Der Wert des Parameters Identity-Features muss ein Polygon sein oder den gleichen Geometrietyp wie der Parameterwert Eingabe-Features aufweisen.
Wenn Sie dieses Werkzeug mit Punkt-Eingabe- und Polygon-Identity-Features verwenden, werden Punkte, die direkt auf eine Polygongrenze fallen, der Ausgabe zweimal hinzugefügt: einmal für jedes Polygon, das Teil der Grenze ist. Wenn Sie das Werkzeug **Überschneiden (Intersect) **für die Ausgabe in diesem Szenario ausführen, werden die doppelten Punkte identifiziert, damit Sie entscheiden können, welche Sie beibehalten möchten.
Wenn die Geometrie des Parameterwerts Eingabe-Features eine Linie und die Geometrie des Parameterwertes Identity-Features ein Polygon ist und der Parameter Beziehungen beibehalten aktiviert wurde, verfügt die Ausgabe-Line-Feature-Class über die zwei zusätzlichen Felder LEFT_poly und RIGHT_poly. Diese Felder enthalten die Feature-ID der Identity-Features auf der rechten und linken Seite des Linien-Features.
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
Identity-Features	Die Identity-Feature-Class oder der Identity-Feature-Layer. Dabei muss es sich um Polygone oder um den gleichen Geometrietyp wie bei den Eingabe-Features handeln.	Feature Layer
Ausgabe-Feature-Class	Die erstellte Feature-Class mit den Ergebnissen.	Feature Class
Zu verbindende Attribute (Optional)	Gibt an, wie Attribute in die Ausgabe-Feature-Class übertragen werden. Alle Attribute—Alle Attribute (einschließlich FIDs) der Eingabe-Features und der Identity-Features werden in die Ausgabe-Feature-Class übertragen. Wenn kein Schnittpunkt gefunden wird, werden die Identity-Feature-Werte nicht auf die Ausgabe übertragen (deren Werte werden auf leere Zeichenfolgen oder auf 0 gesetzt) und der Wert der Identity-Feature-FID beträgt -1. Dies ist die Standardeinstellung. Alle Attribute mit Ausnahme von Feature-IDs—Alle Attribute, mit Ausnahme der FID der Eingabe-Features und der Identity-Features, werden in das Ausgabe-Feature übertragen. Wenn kein Schnittpunkt gefunden wird, werden die Identity-Feature-Werte nicht in die Ausgabe übertragen (deren Werte werden auf leere Zeichenfolgen oder auf 0 gesetzt). Nur Feature-IDs—Alle Attribute der Eingabe-Features und nur die FID der Identity-Features werden in die Ausgabe-Features übertragen. Wenn kein Schnittpunkt gefunden wird, ist der FID-Attributwert der Identity-Features in der Ausgabe -1.	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
Beziehungen beibehalten (Optional)	Gibt an, ob zusätzliche räumliche Beziehungen zwischen den Werten der Parameter Eingabe-Features und Identity-Features in die Ausgabe geschrieben werden. Dies gilt nur, wenn der Geometrietyp des Parameterwertes Eingabe-Features eine Linie und der Geometrie-Typ des Parameterwertes Identity-Features ein Polygon ist. Aktiviert—Die Ausgabe-Linien-Features enthalten die beiden zusätzlichen Felder `LEFT_poly` und `RIGHT_poly`. Diese Felder enthalten die Feature-ID des Parameterwertes `identity_features` auf der rechten und linken Seite des Linien-Features. Deaktiviert—Es wird keine zusätzliche räumliche Beziehung in die Ausgabe geschrieben.	Boolean

arcpy.analysis.Identity(in_features, identity_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {relationship})

Name	Erläuterung	Datentyp
in_features	Die Eingabe-Feature-Class oder der Eingabe-Feature-Layer.	Feature Layer
identity_features	Die Identity-Feature-Class oder der Identity-Feature-Layer. Dabei muss es sich um Polygone oder um den gleichen Geometrietyp wie bei den Eingabe-Features handeln.	Feature Layer
out_feature_class	Die erstellte Feature-Class mit den Ergebnissen.	Feature Class
join_attributes (Optional)	Gibt an, wie Attribute in die Ausgabe-Feature-Class übertragen werden. `ALL`—Alle Attribute (einschließlich FIDs) der Eingabe-Features und der Identity-Features werden in die Ausgabe-Feature-Class übertragen. Wenn kein Schnittpunkt gefunden wird, werden die Identity-Feature-Werte nicht auf die Ausgabe übertragen (deren Werte werden auf leere Zeichenfolgen oder auf 0 gesetzt) und der Wert der Identity-Feature-FID beträgt -1. Dies ist die Standardeinstellung. `NO_FID`—Alle Attribute, mit Ausnahme der FID der Eingabe-Features und der Identity-Features, werden in das Ausgabe-Feature übertragen. Wenn kein Schnittpunkt gefunden wird, werden die Identity-Feature-Werte nicht in die Ausgabe übertragen (deren Werte werden auf leere Zeichenfolgen oder auf 0 gesetzt). `ONLY_FID`—Alle Attribute der Eingabe-Features und nur die FID der Identity-Features werden in die Ausgabe-Features übertragen. Wenn kein Schnittpunkt gefunden wird, ist der FID-Attributwert der Identity-Features in der Ausgabe -1.	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
relationship (Optional)	Gibt an, ob zusätzliche räumliche Beziehungen zwischen den Parameterwerten `in_features` und `identity_features` in die Ausgabe geschrieben werden. Dies gilt nur, wenn der Geometrietyp des Parameterwertes `in_features` eine Linie und der Geometrie-Typ des Parameterwertes `identity_features` ein Polygon ist. `KEEP_RELATIONSHIPS`—Die Ausgabe-Linien-Features enthalten die beiden zusätzlichen Felder `LEFT_poly` und `RIGHT_poly`. Diese Felder enthalten die Feature-ID des Parameterwertes `identity_features` auf der rechten und linken Seite des Linien-Features. `NO_RELATIONSHIPS`—Es wird keine zusätzliche räumliche Beziehung in die Ausgabe geschrieben.	Boolean

Codebeispiel

Identity: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "c:/data/data.gdb"
arcpy.analysis.Identity("wells", "counties", "wells_w_county_info")

Identity: Beispiel 2 (eigenständiges Python-Skript)

Das folgende eigenständige Python-Skript ist ein einfaches Beispiel für die Anwendung der Funktion Identity bei der Skripterstellung.

# IdentityWells.py
# Description: Simple example showing use of Identity tool

# Import system modules
import arcpy

# Set the workspace
arcpy.env.workspace = "C:/data/data.gdb"

# Set local parameters
inFeatures = "wells"
idFeatures = "counties"
outFeatures = "wells_w_county_info"

# Process: Use the Identity function
arcpy.analysis.Identity(inFeatures, idFeatures, outFeatures)

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: Nein
Standard: Nein
Advanced: Ja