Vereinigen (Union) (Analyse)
Zusammenfassung
Hiermit wird eine geometrische Vereinigung der Eingabe-Features berechnet. Alle Features und die dazugehörigen Attribute werden in die Ausgabe-Feature-Class eingetragen.
Weitere Informationen zur Funktionsweise des Werkzeugs "Vereinigen" (Union)
Bild
 |
Verwendung
-
Alle Eingabe-Feature-Classes und -Feature-Layer müssen Polygone sein.
-
Der Parameter Lücken erlaubt kann mit der Einstellung ALL oder ONLY_FID für den Parameter Attribute verbinden verwendet werden. So können Sie Bereiche im Ergebnis identifizieren, die vollständig von den sich ergebenden Polygonen eingeschlossen sind. Die FID-Attribute für diese GAP-Features lauten alle -1.
-
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. Falls die Geometrie z. B. 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 verwendet einen Kachelvorgang, um beim Verarbeiten sehr großer Datasets eine bessere Performance und Skalierbarkeit zu erzielen. Weitere Informationen finden Sie unter Geoverarbeitung mit großen Datasets.
-
Dieses Werkzeug kann selbst dann Multipart-Features in der Ausgabe erstellen, wenn es sich bei allen Eingaben um Singlepart-Features handelt. Wenn Multipart-Features nicht erwünscht sind, verwenden Sie für die Ausgabe-Feature-Class das Werkzeug "Multipart in Singlepart".
Lizenz:Für die ArcGIS for Desktop Basic- und Standard-Lizenzen ist die Anzahl der Eingabe-Feature-Classes oder Layer auf zwei beschränkt.
Syntax
| Parameter | Erläuterung | Datentyp |
in_features [[in_features, {Rank}],...] |
Eine Liste der Eingabe-Feature-Classes oder Layer. Wenn die Entfernung zwischen Features geringer als die Cluster-Toleranz ist, werden die Features mit dem niedrigeren Rang vom Feature mit dem höheren Rang gefangen. Die höchste Rangstufe ist 1. Alle Eingabe-Features müssen Polygone sein. | Value Table |
out_feature_class |
Die Feature-Class, die die Ergebnisse enthält. | Feature Class |
join_attributes (optional) |
Legt fest, welche Attribute der Eingabe-Features in die Ausgabe-Feature-Class übertragen werden.
| String |
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. | Linear unit |
gaps (optional) |
Lücken sind Bereiche in der Ausgabe-Feature-Class, die vollständig von anderen Polygonen eingeschlossen sind. Sie stellen zwar keine Probleme dar. Es kann jedoch hilfreich sein, diese Lücken für eine Analyse zu ermitteln. Wenn Sie die Lücken in der Ausgabe finden möchten, müssen Sie die Option NO_GAPS verwenden. Dann wird in diesen Bereichen ein Feature erstellt. Um diese Features zu selektieren, erstellen Sie für die Ausgabe-Feature-Class eine Abfrage, bei der die FID-Werte aller Eingabe-Features auf -1 festgelegt sind.
| Boolean |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie die Funktion "Vereinigen" (Union) im unmittelbaren Modus verwendet wird.
import arcpy
from arcpy import env
env.workspace = "C:/data/data/gdb"
arcpy.Union_analysis (["well_buff50", "stream_buff200", "waterbody_buff500"], "water_buffers", "NO_FID", 0.0003)
arcpy.Union_analysis ([["counties", 2],["parcels", 1],["state", 2]], "state_landinfo")
Das folgende eigenständige Skript veranschaulicht zwei Möglichkeiten zur Anwendung der Funktion "Vereinigen" (Union) bei der Skripterstellung.
# unions.py
# Purpose: union 3 feature classes
# Import the system modules
import arcpy
from arcpy import env
# Set the current workspace
# (to avoid having to specify the full path to the feature classes each time)
env.workspace = "c:/data/data.gdb"
# Union 3 feature classes but only carry the FID attributes to the output
inFeatures = ["well_buff50", "stream_buff200", "waterbody_buff500"]
outFeatures = "water_buffers"
clusterTol = 0.0003
arcpy.Union_analysis (inFeatures, outFeatures, "ONLY_FID", clusterTol)
# Union 3 other feature classes, but specify some ranks for each
# since parcels has better spatial accuracy
inFeatures = [["counties", 2],["parcels", 1],["state", 2]]
outFeatures = "state_landinfo"
arcpy.Union_analysis (inFeatures, outFeatures)