Paarweise zusammenführen (Analysis)

Zusammenfassung

Aggregiert Features basierend auf festgelegten Attributen mittels eines parallelen Verarbeitungsansatzes.

Für Zusammenführen-Operationen gibt es ein alternatives Werkzeug Weitere Informationen finden Sie in der Dokumentation zum Werkzeug Zusammenführen (Dissolve).

Abbildung

Abbildung "Zusammenführen (Dissolve)"

Verwendung

  • Die Attribute der Features, die mit "Zusammenführen (Dissolve)" aggregiert werden, können mit verschiedenen Statistiken 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 SUM-Statistik in einem Feld mit dem Namen POP verwendet wird, verfügt die Ausgabe über ein Feld mit dem Namen SUM_POP.

  • Sehr große Features können in der Ausgabe-Feature-Class erstellt werden. Dies gilt insbesondere, wenn Dissolve-Feld(er) nur wenige Einzelwerte enthalten oder alle Features zu einem Feature zusammengeführt werden. Sehr große Features können zu Verarbeitungs- oder Anzeigeproblemen führen oder Performance-Einbußen bei der Darstellung auf einer Karte oder bei der Bearbeitung zur Folge haben. Probleme treten möglicherweise auch auf, wenn durch die Ausgabe der Zusammenführung ein Feature mit maximaler Größe auf einem Computer erstellt und dann diese Ausgabe auf einen Computer mit weniger verfügbarem Speicher verschoben wurde. Um diese Probleme zu vermeiden, deaktivieren Sie Multipart-Features erstellen, um potenziell größere Multipart-Features in viele kleinere Features zu unterteilen. Extrem große Features müssen möglicherweise mit dem Werkzeug Stückeln unterteilt werden, um Verarbeitungs-, Anzeige- oder Performance-Probleme zu lösen.

  • NULL-Werte sind von allen statistischen Berechnungen ausgeschlossen. Beispiel: Der AVERAGE von 10, 5 und NULL beträgt 7,5 ((10+5)/2). Die Statistik COUNT gibt die Anzahl der Werte zurück, die in der statistischen Berechnung berücksichtigt werden, in diesem Fall 2.

  • The Dissolve Field(s) parameter's Add Field button is used only in ModelBuilder. In ModelBuilder, where the preceding tool has not been run, or its derived data does not exist, the Dissolve Field(s) parameter may not be populated with field names. The Add Field button allows you to add expected fields so you can complete the tool's dialog box and continue to build your model.

  • Wenn es sich beim Geometrietyp der Eingabe-Features um einen Punkt oder Multipoint handelt und Multipart-Features erstellen aktiviert ist, wird eine Multipoint-Feature-Class ausgegeben. Wenn Multipart-Features erstellen dagegen deaktiviert ist ( in Python), wird eine Point-Feature-Class ausgegeben.

  • Standardmäßig werden Kurven-Features aus der Eingabe in der Ausgabe verdichtet. Um Kurven in der Ausgabe zu unterstützen, verwenden Sie die Umgebung Kurvensegmente beibehalten.

  • Das Werkzeug Paarweise zusammenführen berücksichtigt die Umgebung Faktor für parallele Verarbeitung. Wenn die Umgebungsvariable nicht (Standardeinstellung) oder auf 100 festgelegt ist, wird die vollständige parallele Verarbeitung aktiviert und das Werkzeug versucht, die Arbeit auf alle logischen Kerne auf dem Computer zu verteilen. Durch Festlegen der Umgebung auf 0 wird die parallele Verarbeitung deaktiviert. Wenn ein Faktor zwischen 1 und 99 festgelegt wird, bestimmt das Werkzeug den Prozentsatz der zu verwendenden logischen Kerne, indem die Formel (Faktor für parallele Verarbeitung / 100 * logische Kerne) auf die nächste Ganzzahl aufgerundet angewendet wird. Wenn das Ergebnis dieser Formel 0 oder 1 ist, wird die parallele Verarbeitung nicht aktiviert.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features

Die zu aggregierenden Features.

Feature Layer
Ausgabe-Feature-Class

Die zu erstellende Feature-Class, die die zusammengeführten Features enthalten soll.

Feature Class
Dissolve-Feld(er)
(optional)

Die Felder, mit denen Features zusammengefasst werden.

Field
Statistikfeld(er)
(optional)

Gibt das numerische Feld bzw. die numerischen 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 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:

  • Summe: Die Werte für das angegebene Feld werden addiert.
  • Mittelwert: Der Durchschnitt für das angegebene Feld wird berechnet.
  • Minimum: Der kleinste Wert aller Datensätze des angegebenen Feldes wird ermittelt.
  • Maximum: Der größte Wert aller Datensätze des angegebenen Felds wird ermittelt.
  • Bereich: Der Wertebereich (Maximum minus Minimum) für das angegebene Feld wird berechnet.
  • Standardabweichung: Die Standardabweichung der Werte im angegebenen Feld wird berechnet.
  • Anzahl: Die Anzahl der Werte, die in den statistischen Berechnungen enthalten sind, wird ermittelt. Alle Werte außer den NULL-Werten werden gezählt. Um die Anzahl der NULL-Werte in einem Feld zu bestimmen, wenden Sie "Anzahl" auf das gewünschte Feld an. Wenden Sie dann "Anzahl" auf ein anderes Feld an, das keine NULL-Werte enthält (z. B. OID, falls vorhanden), und ermitteln Sie die Differenz.
  • Erster: Der angegebene Feldwert des ersten Datensatzes in der Eingabe wird verwendet.
  • Letzter: Der angegebene Feldwert des letzten Datensatzes in der Eingabe wird verwendet.
  • Medianwert: Der Medianwert aller Datensätze des angegebenen Feldes wird berechnet.
  • Varianz: Die Varianz aller Datensätze des angegebenen Feldes wird berechnet.
  • Eindeutig: Die Anzahl der Einzelwerte für das angegebene Feld wird gezählt.
Value Table
Multipart-Features erstellen
(optional)

Gibt an, ob Multipart-Features in der Ausgabe-Feature-Class zugelassen werden.

  • Aktiviert: Multipart-Features sind zulässig. Dies ist die Standardeinstellung.
  • Deaktiviert: Multipart-Features sind nicht zulässig. Anstelle von Multipart-Features wird für jedes Teil jeweils ein einzelnes Feature erstellt.
Boolean

arcpy.analysis.PairwiseDissolve(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part})
NameErläuterungDatentyp
in_features

Die zu aggregierenden Features.

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 bzw. die numerischen 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 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: Die Werte für das angegebene Feld werden addiert.
  • MEAN: Es wird der Mittelwert für den angegebenen Bereich berechnet.
  • MIN: Der kleinste Wert aller Datensätze des angegebenen Feldes wird ermittelt.
  • MAX: Der größte Wert aller Datensätze des angegebenen Felds wird ermittelt.
  • RANGE: Der Wertebereich (Maximum minus Minimum) für das angegebene Feld wird berechnet.
  • STD: Die Standardabweichung der Werte im angegebenen Feld wird berechnet.
  • COUNT: Die Anzahl der Werte, die in den statistischen Berechnungen enthalten sind, wird ermittelt. Alle Werte außer den NULL-Werten werden gezählt. Um die Anzahl der NULL-Werte in einem Feld zu bestimmen, wenden Sie "Anzahl" auf das gewünschte Feld an. Wenden Sie dann "Anzahl" auf ein anderes Feld an, das keine NULL-Werte enthält (z. B. OID, falls vorhanden), und ermitteln Sie die Differenz.
  • FIRST: Der angegebene Feldwert des ersten Datensatzes in der Eingabe wird verwendet.
  • LAST: Der angegebene Feldwert des letzten Datensatzes in der Eingabe wird verwendet.
  • MEDIAN: Der Medianwert aller Datensätze des angegebenen Feldes wird berechnet.
  • VARIANCE: Die Varianz aller Datensätze des angegebenen Feldes wird berechnet.
  • UNIQUE: Die Anzahl der Einzelwerte für das angegebene Feld wird gezählt.
Value Table
multi_part
(optional)

Gibt an, ob Multipart-Features in der Ausgabe-Feature-Class zugelassen werden.

  • MULTI_PARTMultipart-Features sind zulässig. Dies ist die Standardeinstellung.
  • SINGLE_PARTMultipart-Features sind nicht zulässig. Anstelle von Multipart-Features wird für jedes Teil jeweils ein einzelnes Feature erstellt.
Boolean

Codebeispiel

PairwiseDissolve: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
arcpy.PairwiseDissolve_analysis("taxlots", "C:/output/output.gdb/taxlots_dissolved",
                                ["LANDUSE", "TAXCODE"], "", "SINGLE_PART")
PairwiseDissolve: Beispiel 2 (eigenständiges Skript)

Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug PairwiseDissolve verwendet wird.

# Name: PairwiseDissolve_Example2.py
# Description: Dissolve features based on common attributes
 
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
 
# Set local variables
inFeatures = "taxlots"
tempLayer = "taxlotsLyr"
expression = arcpy.AddFieldDelimiters(inFeatures, "LANDUSE") + " <> ''"
outFeatureClass = "C:/output/output.gdb/taxlots_dissolved"
dissolveFields = ["LANDUSE", "TAXCODE"]
 
# Execute MakeFeatureLayer and SelectLayerByAttribute.  This is only to exclude 
#  features that are not desired in the output.
arcpy.MakeFeatureLayer_management(inFeatures, tempLayer)
arcpy.SelectLayerByAttribute_management(tempLayer, "NEW_SELECTION", expression)
 
# Execute Dissolve using LANDUSE and TAXCODE as Dissolve Fields
arcpy.PairwiseDissolve_analysis(tempLayer, outFeatureClass, dissolveFields, "", 
                                "SINGLE_PART")

Lizenzinformationen

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

Verwandte Themen