| Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Die Eingabe-Feature-Classes oder -Layer. Wenn die Entfernung zwischen Features geringer als die Cluster-Toleranz ist, werden die Features mit der niedrigeren Rangstufe vom Feature mit der höheren Rangstufe gefangen. Die höchste Rangstufe ist 1. Alle Eingabe-Features müssen Polygone sein. | Value Table |
Ausgabe-Feature-Class | Die Feature-Class, die die Ergebnisse enthält. | Feature Class |
Zu verbindende Attribute (optional) | Gibt an, welche Attribute der Eingabe-Features in die Ausgabe-Feature-Class übertragen werden.
| String |
XY-Toleranz (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 |
Lücken erlaubt (optional) | Gibt an, ob für Bereiche in der Ausgabe, die vollständig von anderen Polygonen eingeschlossen sind, ein Feature erstellt wird. Lücken sind Bereiche in der Ausgabe-Feature-Class, die vollständig von anderen Polygonen eingeschlossen sind (entstanden durch Überschneidung von Features oder vorhandene Löcher in den Eingabe-Polygonen). Diese Bereiche sind nicht ungültig, sondern können für die Analyse identifiziert werden. Wenn Sie die Lücken in der Ausgabe ermitteln möchten, deaktivieren Sie diesen Parameter. In diesen Bereichen wird 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 |
Zusammenfassung
Hiermit wird eine geometrische Vereinigung der Eingabe-Features berechnet. Alle Features und deren Attribute werden in die Ausgabe-Feature-Class geschrieben.
Weitere Informationen zur Funktionsweise des Werkzeugs "Vereinigen (Union)"
Abbildung
Verwendung
Alle Eingabe-Feature-Classes und -Feature-Layer müssen Polygone sein.
Der Parameter Lücken erlaubt kann mit den Einstellungen Alle Attribute oder Nur Feature-IDs im Parameter Zu verbindende Attribute 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 Lücken-Features lauten alle -1.
Die Ausgabe-Feature-Class enthält ein FID_<name>-Attribut für jede Eingabe-Feature-Class. Wenn eine der Eingabe-Feature-Classes beispielsweise den Namen Soils hat, ist ein FID_Soils-Attribut in der Ausgabe-Feature-Class vorhanden. Die FID_<name>-Werte betragen bei jedem Eingabe-Feature (oder Teil eines Eingabe-Features), das kein anderes Eingabe-Feature überschneidet, -1. Die Attributwerte für die anderen Feature-Classes in der Vereinigung, bei denen keine Überschneidung gefunden wurde, werden in diesem Fall nicht auf das Ausgabe-Feature übertragen.
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.
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.
Lizenz:
Bei ArcGIS Desktop Basic- und Desktop Standard-Lizenzen ist die Anzahl der Eingabe-Feature-Classes oder -Layer auf zwei begrenzt.
Parameter
arcpy.analysis.Union(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {gaps})| Name | Erläuterung | Datentyp |
in_features [[in_features, {rank}],...] | Die Eingabe-Feature-Classes oder -Layer. Wenn die Entfernung zwischen Features geringer als die Cluster-Toleranz ist, werden die Features mit der niedrigeren Rangstufe vom Feature mit der höheren Rangstufe 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) | Gibt an, 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. 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 |
gaps (optional) | Gibt an, ob für Bereiche in der Ausgabe, die vollständig von anderen Polygonen eingeschlossen sind, ein Feature erstellt wird. Lücken sind Bereiche in der Ausgabe-Feature-Class, die vollständig von anderen Polygonen eingeschlossen sind (entstanden durch Überschneidung von Features oder vorhandene Löcher in den Eingabe-Polygonen). Diese Bereiche sind nicht ungültig, sondern können für die Analyse identifiziert werden. Wenn Sie die Lücken in der Ausgabe ermitteln möchten, legen Sie diesen Parameter auf NO_GAPS fest. 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 für das Python-Fenster veranschaulicht, wie die Funktion Union im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data/data/gdb"
arcpy.analysis.Union(["well_buff50", "stream_buff200", "waterbody_buff500"],
"water_buffers", "NO_FID", 0.0003)
arcpy.analysis.Union([["counties", 2], ["parcels", 1], ["state", 2]],
"state_landinfo")Das folgende eigenständige Skript veranschaulicht zwei Möglichkeiten zur Anwendung der Funktion Union bei der Skripterstellung.
# unions.py
# Purpose: union 3 feature classes
# Import the system modules
import arcpy
# Set the current workspace (to avoid having to specify the full path to the
# feature classes each time)
arcpy.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"
arcpy.analysis.Union(inFeatures, outFeatures, "ONLY_FID")
# 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.analysis.Union(inFeatures, outFeatures)Umgebungen
Sonderfälle
- Faktor für parallele Verarbeitung
Dieses Werkzeug berücksichtigt die Umgebung "Faktor für parallele Verarbeitung". Wenn die Umgebung nicht festgelegt ist (Standardeinstellung) oder auf 0 festgelegt ist, ist die parallele Verarbeitung deaktiviert. Die parallele Verarbeitung wird nicht verwendet; die Verarbeitung erfolgt stattdessen sequenziell. Durch Festlegen der Umgebung auf 100 wird die parallele Verarbeitung aktiviert. Die Verarbeitung erfolgt dann parallel. Es werden bis zu 10 Kerne verwendet, wenn die parallele Verarbeitung aktiviert ist.
Die parallele Verarbeitung wird derzeit für Überlagerungsvorgänge vom Typ "Polygon auf Polygon", "Linie auf Polygon" und "Punkt auf Polygon" unterstützt.
Lizenzinformationen
- Basic: Begrenzt
- Standard: Begrenzt
- Advanced: Ja