Paarweise zusammenführen (Analysis Tools)

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)(../data-management/dissolve.yml).

Abbildung

Abbildung des Werkzeugs "Paarweise zusammenführen"

Verwendung

Die Attribute der Features, die im Zusammenführungsvorgang 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 ist wichtig, wenn der Parameterwert Dissolve-Felder nur wenige Einzelwerte enthält 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 als Ausgabe der Zusammenführung ein Feature mit maximaler Größe auf einem Computer erstellt wird und diese Ausgabe auf einen Computer mit weniger freiem Speicher verschoben wird. Um diese Probleme zu vermeiden, deaktivieren Sie den Parameter Multipart-Features erstellen, um potenziell größere Multipart-Features in viele kleinere Features zu unterteilen. Extrem große Features können Sie mit dem Werkzeug Würfel aufteilen, 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.
Wenn es sich beim Geometrietyp des Parameterwertes Eingabe-Features um einen Punkt oder Multipoint handelt und der Parameter Multipart-Features erstellen aktiviert ist, wird eine Multipoint-Feature-Class ausgegeben. Wenn der Parameter Multipart-Features erstellen dagegen deaktiviert ist, wird eine Point-Feature-Class ausgegeben.
Wenn der Parameter Ausgabe-Lineage-Tabelle angegeben ist, erstellt das Werkzeug eine Lineage-Tabelle, die die Eingabe-Features erfasst, die an der Erstellung jedes Ausgabe-Feature beteiligt sind. Die Tabelle enthält die folgenden Felder:
- OUTPUT_FID—Die FID der Features im Parameterwert Ausgabe-Feature-Class.
- INPUT_FID—Die FID des Features des Parameterwertes Eingabe-Features, der an der Erstellung des Ausgabe-Features mit der OUTPUT_FID beteiligt war. Wenn mehr als ein Feature an der Erstellung des Features OUTPUT_FID beteiligt war, sind mehrere Datensätze mit dieser OUTPUT_FID vorhanden, um die FID jedes Eingabe-Features zu erfassen, das an der Erstellung des Ausgabe-Features beteiligt war.
Eine Ausgabe-Lineage-Tabelle wird nur erstellt, wenn der Parameter Multipart-Features erstellen deaktiviert ist. Die Ausgabe-Lineage-Tabelle hat denselben Namen wie die Ausgabe-Feature-Class, wobei "_Tbl" an den Namen angehängt wird.

Beim Erstellen einer Lineage-Tabelle wird ein geringfügig anderer Algorithmus auf die Daten angewendet, sodass geringe Unterschiede in der Reihenfolge der Teile auftreten können.

Die Berechnung der Lineage kann je nach Größe und Komplexität der zusammengeführten Eingabedaten beträchtliche Zeit in Anspruch nehmen.
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.
Dieses Werkzeug 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, identifiziert das Werkzeug den Prozentsatz der zu verwendenden logischen Kerne, indem die Formel (Faktor für parallele Verarbeitung / 100 * logische Kerne) auf die nächste ganze Zahl aufgerundet angewendet wird. Wenn das Ergebnis dieser Formel 0 oder 1 ist, wird die parallele Verarbeitung nicht aktiviert.

Beschriftung	Erläuterung	Datentyp
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-Felder (Optional)	Die Felder, auf deren Basis die Features aggregiert werden.	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 von dem Werkzeug keine Statistiken berechnet. Numerische Attributfelder können mit jeder beliebigen Statistik zusammengefasst werden. Text-Attributfelder können nur mit den Statistiken "Minimum", "Maximum", "Anzahl", "Erster", "Letzter", "Eindeutig", "Verbinden" und "Modus" (Modalwert) zusammengefasst werden. Spalten der Wertetabelle: Field—The field containing attribute values used to calculate the specified statistic. Statistic Type—The statistic type Sum—The values for the specified field will be added together. Mean—The average for the specified field will be calculated. Minimum—The smallest value of the specified field will be identified. Maximum—The largest value of the specified field will be identified. Range—The range of values (maximum minus minimum) for the specified field will be calculated. Standard deviation—The standard deviation of values for the specified field will be calculated. Count—The number of values in the specified field will be identified. First—The specified field value of the first record in the input will be used. Last—The specified field value of the last record in the input will be used. Median—The median of the specified field will be calculated. Variance—The variance of the specified field will be calculated. Unique—The number of unique values of the specified field will be counted. Concatenate—The values for the specified field will be concatenated. Mode—The mode (the most common value) for the specified field will be identified. If more than one value is equally common, the lowest value will be returned.	Value Table
Multipart-Features erstellen (Optional)	Gibt an, ob Multipart-Features in der Ausgabe enthalten sind. Aktiviert—Multipart-Feature sind in der Ausgabe enthalten. Dies ist die Standardeinstellung. Deaktiviert—Multipart-Feature sind nicht in der Ausgabe enthalten. Für jeden Teil werden einzelne Features erstellt.	Boolean
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
Ausgabe-Lineage-Tabelle (Optional)	Eine Lineage-Tabelle, in der die Eingabe-Features erfasst werden, die an der Erstellung jedes Ausgabe-Singlepart-Features beteiligt sind. Eine Ausgabe-Lineage-Tabelle wird nur erstellt, wenn der Parameter Multipart-Features erstellen deaktiviert ist und ein gültiger Pfad für die Ausgabetabelle angegeben wurde.	Table

arcpy.analysis.PairwiseDissolve(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part}, {concatenation_separator}, {out_lineage_table})

Name	Erläuterung	Datentyp
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, auf deren Basis die Features aggregiert werden.	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 von dem Werkzeug keine Statistiken berechnet. Numerische Attributfelder können mit jeder beliebigen Statistik zusammengefasst werden. Text-Attributfelder können nur mit den Statistiken "Minimum", "Maximum", "Anzahl", "Erster", "Letzter", "Eindeutig", "Verbinden" und "Modus" (Modalwert) zusammengefasst werden. Spalten der Wertetabelle: `Field`—The field containing attribute values used to calculate the specified statistic. `Statistic Type`—The statistic type `SUM`—The values for the specified field will be added together. `MEAN`—The average for the specified field will be calculated. `MIN`—The smallest value of the specified field will be identified. `MAX`—The largest value of the specified field will be identified. `RANGE`—The range of values (maximum minus minimum) for the specified field will be calculated. `STD`—The standard deviation of values for the specified field will be calculated. `COUNT`—The number of values in the specified field will be identified. `FIRST`—The specified field value of the first record in the input will be used. `LAST`—The specified field value of the last record in the input will be used. `MEDIAN`—The median of the specified field will be calculated. `VARIANCE`—The variance of the specified field will be calculated. `UNIQUE`—The number of unique values of the specified field will be counted. `CONCATENATE`—The values for the specified field will be concatenated. `MODE`—The mode (the most common value) for the specified field will be identified. If more than one value is equally common, the lowest value will be returned.	Value Table
multi_part (Optional)	Gibt an, ob Multipart-Features in der Ausgabe enthalten sind. `MULTI_PART`—Multipart-Feature sind in der Ausgabe enthalten. Dies ist die Standardeinstellung. `SINGLE_PART`—Multipart-Feature sind nicht in der Ausgabe enthalten. Für jeden Teil werden einzelne Features erstellt.	Boolean
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
out_lineage_table (Optional)	Eine Lineage-Tabelle, in der die Eingabe-Features erfasst werden, die an der Erstellung jedes Ausgabe-Singlepart-Features beteiligt sind. Eine Ausgabe-Lineage-Tabelle wird nur erstellt, wenn der Parameter `multi_part` auf `SINGLE_PART` festgelegt ist und ein gültiger Pfad für die Ausgabetabelle angegeben wurde.	Table

Codebeispiel

PairwiseDissolve: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion PairwiseDissolve im Direkt-Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
arcpy.analysis.PairwiseDissolve("taxlots", "C:/output/output.gdb/taxlots_dissolved",
                                ["LANDUSE", "TAXCODE"], "", "SINGLE_PART")

PairwiseDissolve: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion 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"]

# Run MakeFeatureLayer and SelectLayerByAttribute.  This is only to exclude
#  features that are not desired in the output.
arcpy.management.MakeFeatureLayer(inFeatures, tempLayer)
arcpy.analysis.SelectLayerByAttribute(tempLayer, "NEW_SELECTION", expression)

# Run Dissolve using LANDUSE and TAXCODE as Dissolve Fields
arcpy.analysis.PairwiseDissolve(tempLayer, outFeatureClass, dissolveFields, "",
                                "SINGLE_PART")

Umgebungen

Aktueller Workspace, Scratch-Workspace, Ausgabe-Koordinatensystem, Geographische Transformationen, Ausdehnung, XY-Auflösung, XY-Toleranz, Ausgabe hat M-Werte, M-Auflösung, M-Toleranz, Ausgabe hat Z-Werte, Standard-Ausgabe-Z-Werte, Z-Auflösung, Z-Toleranz, Vollständig qualifizierte Feldnamen beibehalten, Ausgabe-CONFIG-Schlüsselwort, Auto-Commit, Ausgabe-XY-Domäne, Ausgabe-M-Domäne, Ausgabe-Z-Domäne, Faktor für parallele Verarbeitung, Kurvensegmente beibehalten, Kurvenverarbeitungsmethode, Geodatabase-Feldeigenschaften übertragen

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja