Teilung der Linie aufheben (Data Management)

Zusammenfassung

Führt Linien zusammen, die lagegleiche Endpunkte und optional gemeinsame Attributwerte haben.

Abbildung

Abbildung "UnsplitLine"

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 die Statistik SUM in einem Feld mit dem Namen POP verwendet wird, verfügt die Ausgabe über ein Feld mit dem Namen SUM_POP.

  • Die Menge (und Komplexität) der Eingabe-Features, die verarbeitet und deren Teilung aufgehoben werden kann, um ein einzelnes Ausgabe-Linien-Feature zu erstellen, hängt vom verfügbaren physischen Speicher ab. Wenn für das Aufheben der Teilung mehr Speicher benötigt wird als verfügbar ist, tritt ein Fehler auf. 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:

    Bei Ausführung von Teilung der Linie aufheben auf der Ausgabe einer zuvor aufgehobenen Teilung wird die Anzahl von Features in der Ausgabe selten reduziert, wenn die Eingaben bei der ursprünglichen Verarbeitung geteilt und mit adaptivem Kacheln verarbeitet wurden. Die maximale Größe eines Ausgabe-Features wird zur Laufzeit durch den verfügbaren Speicher bestimmt. Daher ist eine Ausgabe mit Kacheln ein Indikator dafür, dass eine weitere Aufhebung einer Teilung mit den verfügbaren Ressourcen eine Situation mit ungenügendem Arbeitsspeicher verursachen oder zu einem unbrauchbaren Feature führen würde. Zudem führt eine zweite Ausführung des Werkzeugs Teilung der Linie aufheben für so erstellte Ausgaben möglicherweise zu sehr geringer Performance mit praktisch keinem Gewinn und kann einen unerwarteten Fehler verursachen.

  • NULL-Werte sind von allen statistischen Berechnungen ausgeschlossen. Beispiel: Der Mittelwert von 10, 5 und Null beträgt 7,5 ((10+5)/2). Mit "COUNT" wird die Anzahl der Werte zurückgegeben, die in der statistischen Berechnung enthalten sind, in diesem Fall 2.

Syntax

arcpy.management.UnsplitLine(in_features, out_feature_class, {dissolve_field}, {statistics_fields})
ParameterErklärungDatentyp
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, mit denen Features zusammengefasst werden.

Field
statistics_fields
[[field, {statistic_type}],...]
(optional)

Gibt das numerische Feld 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 statistischen Berechnungen ausgeschlossen.

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:

  • SUM: Der Gesamtwert für das angegebene Feld wird hinzugefügt.
  • MEAN: Der Mittelwert für das angegebene Feld wird berechnet.
  • MIN: Der kleinste Wert aller Datensätze des angegebenen Feldes wird ermittelt.
  • MAX: Der größte Wert aller Datensätze des angegebenen Feldes wird ermittelt.
  • RANGE: Der Wertebereich (MAX minus MIN) für das angegebene Feld wird ermittelt.
  • STD: Die Standardabweichung der Werte im angegebenen Feld wird ermittelt.
  • COUNT: Gibt die Anzahl der Werte zurück, die in statistischen Berechnungen enthalten sind. Zählt alle Werte außer den NULL-Werten. Um die Anzahl der NULL-Werte in einem Feld zu bestimmen, wenden Sie COUNT auf das gewünschte Feld an. Wenden Sie dann COUNT auf ein anderes Feld an, das keine NULL-Werte enthält (z. B. OID, falls vorhanden), und ermitteln Sie die Differenz.
  • FIRST: Der erste Datensatz in der Eingabe wird ermittelt, und der angegebene Feldwert wird verwendet.
  • LAST: Der letzte Datensatz in der Eingabe wird ermittelt, und der angegebene Feldwert wird verwendet.
  • MEDIAN: Der Median aller Datensätze des angegebenen Feldes wird ermittelt.
  • VARIANCE: Die Varianz aller Datensätze des angegebenen Feldes wird ermittelt.
  • UNIQUE: Die Anzahl der Einzelwerte des angegebenen Feldes wird gezählt.
Value Table

Codebeispiel

UnsplitLine: Beispiel (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie das Werkzeug UnsplitLine im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Streets"
arcpy.UnsplitLine_management("streets", "C:/output/output.gdb/streets_unsplit",
                             ["STREETNAME", "PREFIX"])
UnsplitLine: Beispiel 2 (eigenständiges Skript)

Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug 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"]
 
# Execute UnsplitLine using STREETNAME and PREFIX as Dissolve Fields
arcpy.UnsplitLine_management(inFeatures, outFeatureClass, dissolveFields)

Lizenzinformationen

  • Basic: Nein
  • Standard: Nein
  • Advanced: Ja

Verwandte Themen