Beschriftung | Erläuterung | Datentyp |
Eingabe-Features | Die Linien-Features, die aggregiert werden sollen. | Feature Layer |
Ausgabe-Feature-Class | Die zu erstellende Feature-Class, die die zusammengeführten Features enthalten soll. | Feature Class |
Dissolve-Felder (optional) | Die Felder, auf deren Basis die Features aggregiert werden. Werden keine Felder angegeben, führt das Werkzeug alle Features zusammen. | Field |
Statistikfelder (optional) | Gibt das Feld oder die Felder mit den Attributwerten an, mit denen die angegebene Statistik berechnet wird. Es können mehrere Statistik- und Feldkombinationen angegeben werden. NULL-Werte sind von allen Berechnungen ausgeschlossen. Standardmäßig werden mit dem Werkzeug keine Statistiken berechnet. Textattributfelder können mit den Statistiken FIRST oder LAST zusammengefasst werden. Numerische Attributfelder können mit jeder beliebigen Statistik zusammengefasst werden. Die folgenden Statistiktypen stehen zur Verfügung:
| Value Table |
Verbindungstrennzeichen (optional) | Zeichen, die zum Verbinden von Werten verwendet werden, wenn die Option Verbindung für den Parameter Statistikfelder verwendet wird. Standardmäßig verbindet das Werkzeug Werte ohne Trennzeichen. | String |
Zusammenfassung
Aggregiert Linien-Features, die lagegleiche Endpunkte und optional gemeinsame Attributwerte haben.
Abbildung
Verwendung
Die Attribute der Features, die mit diesem Werkzeug aggregiert werden, können mit verschiedenen Statistiktypen zusammengefasst oder beschrieben werden. Die Statistik zum Zusammenfassen von Attributen wird der Ausgabe-Feature-Class als einzelnes Feld hinzugefügt, wobei die Benennungskonvention "Statistiktyp + Unterstrich + Name des Eingabefeldes" verwendet wird. Wenn beispielsweise der SUM-Statistiktyp in einem Feld mit dem Namen POP verwendet wird, enthält die Ausgabe ein Feld mit dem Namen SUM_POP.
Die Menge (und Komplexität) der Eingabe-Features, die verarbeitet und in ein einzelnes Ausgabe-Linien-Feature aggregiert werden kann, hängt vom verfügbaren physischen Speicher ab. Wenn für das Aufheben der Teilung mehr Speicher benötigt wird, als verfügbar ist, kann ein Fehler auftreten. Um dies zu vermeiden, können die Eingabe-Features mit Teilung der Linie aufheben geteilt und mit einem anpassbaren Kachelalgorithmus verarbeitet werden. Um zu ermitteln, welche Features gekachelt wurden, führen Sie das Werkzeug Häufigkeit (Frequency) für das Ergebnis dieses Werkzeugs aus. Geben Sie dabei für den Parameter Dissolve-Feld(er) dieselben Felder an wie für den Parameter Häufigkeitsfeld(er). Alle Datensätze mit einem Häufigkeitswert von 2 wurden gekachelt. Die Kachelgrenzen bleiben in den Ausgabe-Features erhalten, um zu verhindern, dass Features erstellt werden, die für die Verwendung in ArcGIS zu groß sind.
Vorsicht:
Die Ausführung von Teilung der Linie aufheben für die Ausgabe einer früheren Aufhebung der Teilung reduziert selten die Anzahl der Features in der Ausgabe, wenn bei der ursprünglichen Verarbeitung die Eingaben mithilfe von adaptiver Kachelung geteilt und verarbeitet wurden. Die maximale Größe eines Ausgabe-Features wird zur Laufzeit durch den verfügbaren Speicher bestimmt. Die Ausgabe mit Kacheln ist ein Indikator dafür, dass eine weitere Aggregation mit den verfügbaren Ressourcen eine Situation mit ungenügendem Arbeitsspeicher verursacht oder zu einem unbrauchbaren Feature führt. Die zweite Ausführung des Werkzeugs Teilung der Linie aufheben für eine Ausgabe, die auf diese Weise erstellt wurde, kann mit minimalen oder keinen Vorteilen zu einer schlechten Performance und unerwarteten Fehlern führen.
NULL-Werte sind von allen statistischen Berechnungen ausgeschlossen. Beispiel: Der Mittelwert von 10, 5 und NULL beträgt 7,5 ((10+5)/2). Mit "Anzahl" wird die Anzahl der Werte zurückgegeben, die in der statistischen Berechnung enthalten sind, in diesem Fall 2.
Parameter
arcpy.management.UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {concatenation_separator})
Name | Erläuterung | Datentyp |
in_features | Die Linien-Features, die aggregiert werden sollen. | Feature Layer |
out_feature_class | Die zu erstellende Feature-Class, die die zusammengeführten Features enthalten soll. | Feature Class |
dissolve_field [dissolve_field,...] (optional) | Die Felder, auf deren Basis die Features aggregiert werden. Werden keine Felder angegeben, führt das Werkzeug alle Features zusammen. | Field |
statistics_fields [[field, {statistic_type}],...] (optional) | Gibt das Feld oder die Felder mit den Attributwerten an, mit denen die angegebene Statistik berechnet wird. Es können mehrere Statistik- und Feldkombinationen angegeben werden. NULL-Werte sind von allen Berechnungen ausgeschlossen. Standardmäßig werden mit dem Werkzeug keine Statistiken berechnet. Textattributfelder können mit den Statistiken FIRST oder LAST zusammengefasst werden. Numerische Attributfelder können mit jeder beliebigen Statistik zusammengefasst werden. Die folgenden Statistiktypen stehen zur Verfügung:
| Value Table |
concatenation_separator (optional) | Zeichen, die zum Verbinden von Werten verwendet werden, wenn die Option CONCATENATION für den Parameter statistics_fields verwendet wird. Standardmäßig verbindet das Werkzeug Werte ohne Trennzeichen. | String |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion UnsplitLine im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.management.UnsplitLine("streets", "C:/output/output.gdb/streets_unsplit",
["STREETNAME", "PREFIX"])
Das folgende eigenständige Skript veranschaulicht, wie die Funktion UnsplitLine verwendet wird.
# Name: UnsplitLine_Example2.py
# Description: Unsplit line features based on common attributes
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
# Set local variables
inFeatures = "streets"
outFeatureClass = "C:/output/output.gdb/streets_unsplit"
dissolveFields = ["STREETNAME", "PREFIX"]
# Run UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.management.UnsplitLine(inFeatures, outFeatureClass, dissolveFields)