| Beschriftung | Erläuterung | Datentyp |
Eingabe-Layer | Die Punkt-, Linien- oder Polygon-Features, die gruppiert werden. | Feature Layer |
Ausgabe | Die Ausgabe-Feature-Class mit den gruppierten Features, dargestellt durch ein neues Feld namens group_id. | Feature Class |
Räumliche Beziehung | Gibt den Beziehungstyp an, nach dem Features gruppiert werden.
| String |
Räumliche Near-Entfernung (optional) |
Die zum Gruppieren von Near-Features verwendete Entfernung. Dieser Parameter wird nur verwendet, wenn der Parameter Räumliche Beziehung auf Nahe (planar) oder Nahe (geodätisch) festgelegt ist. | Linear Unit |
Zeitliche Beziehung (optional) | Gibt die zeitlichen Kriterien für die Zuordnung von Features an. Wenn der Parameter auf Überschneidet oder Nahe festgelegt ist, werden Features gruppiert, wenn sowohl die räumlichen als auch die zeitlichen Kriterien erfüllt sind. Um diese Option zu unterstützen, müssen die Zeiteigenschaften bei der Eingabe aktiviert werden.
| String |
Zeitliche Near-Entfernung (optional) |
Die zum Gruppieren von Near-Features verwendete zeitliche Entfernung. Dieser Parameter wird nur verwendet, wenn der Parameterwert Zeitliche Beziehung auf Nahe festgelegt ist. | Time Unit |
Attributbeziehung (optional) | Ein ArcGIS Arcade-Ausdruck, der zum Gruppieren der Features verwendet wird. Mit $a["Amount"] == $b["Amount"] werden Features beispielsweise gruppiert, wenn das Feld Amount den gleichen Wert enthält. | String |
Zusammenfassung
Gruppiert Features, die sich in räumlicher oder spatiotemporaler Nähe zueinander befinden.
Nachfolgend finden Sie Beispielfragen, die mit den Workflows Nach Nähe gruppieren beantwortet werden können:
- Welche Straßen sind verbunden?
- Wo gibt es Gruppen von Straftaten, die in enger räumlicher und zeitlicher Nähe zueinander stattgefunden haben?
- Gibt es Gruppen von Polygonen, die einander überlappen?
Abbildung
Verwendung
Das Ausgabeergebnis ist eine Kopie der Eingabe mit einem neuen Feld namens group_id. Das Feld group_id stellt die Gruppierung der Features dar. Features mit demselben Wert für group_id befinden sich in derselben Gruppe. Die Gruppennummern geben die Mitgliedschaft in einer bestimmten Gruppe an und keinen Wert. Die Gruppennummern sind möglicherweise nicht fortlaufend oder identisch bei der wiederholten Verwendung des Werkzeugs. Ergebnisse werden unter Verwendung von acht Gruppen symbolisiert. Wenn im Ergebnis mehr als acht Gruppen vorliegen, werden standardmäßig alle Gruppen mit acht Farben symbolisiert. Sie können die Symbolisierung so ändern, dass die einzelnen Gruppen gezeigt werden, indem Sie für das Feld group_id eine Symbolisierung mit Einzelsymbolen festlegen.
Das Werkzeug unterstützt die folgenden Kombinationen von Beziehungen:
- Eine räumliche Beziehung
- Eine räumliche Beziehung und eine zeitliche Beziehung
- Eine räumliche Beziehung und eine Attributbeziehung
- Eine räumliche Beziehung, eine zeitliche Beziehung und eine Attributbeziehung
In der folgenden Tabelle werden die unterstützten räumlichen Beziehungen und Eingabe-Geometrien beschrieben:
Eingabe-Geometrietyp Überschneidet Berührt Nahe (geodätisch) Nahe (planar) Punkt
Polylinie
Polygon
Überlagerungsmethode Beschreibung Überschneidet
Features überschneiden sich, wenn sich Features oder Teile von Features überlappen. Dies ist die Standardeinstellung.
Berührt
Features berühren ein anderes Feature, wenn sie einen sich überschneidenden Stützpunkt haben, aber die Features sich nicht überlappen.
Nahe (geodätisch)
Features liegen nahe beieinander, wenn sich ein Stützpunkt oder eine Kante innerhalb einer bestimmten geodätischen Entfernung von einem anderen Feature befindet.
Nahe (planar)
Features liegen nahe beieinander, wenn sich ein Stützpunkt oder eine Kante innerhalb einer bestimmten planaren Entfernung von einem anderen Feature befindet.
Um die Option Nahe (planar) des Parameters Räumliche Beziehung verwenden zu können, muss der Parameterwert Eingabe-Layer projiziert werden oder das Ausgabe-Koordinatensystem auf Projiziertes Koordinatensystem gesetzt sein.
In der folgenden Tabelle werden die unterstützten zeitlichen Beziehungen und Typen beschrieben:
Zeitlicher Eingabetyp Überschneidet Nahe Keine
Zeitpunkt
Intervall
Zeitliche Beziehungsmethode Beschreibung Überschneidet
Features überschneiden sich, wenn ein Teil der Zeit eines Features ein anderes Feature überlappt.
Nahe
Features liegen nahe beieinander, wenn sich die Zeit eines Features innerhalb einer bestimmten zeitlichen Entfernung von einem anderen Feature befindet.
Um eine zeitliche Beziehung verwenden zu können, müssen Sie die Zeiteigenschaften bei der Eingabe aktivieren. Sie können die Zeiteigenschaften wie folgt aktivieren:
- Aktivieren Sie Zeiteigenschaften für die Eingabe einer Multifile-Feature-Verbindung (MFC).
- Durch Aktivieren der Zeiteigenschaften auf einem Layer in der Karte. Optional können Sie den Layer mit aktivierten Zeiteigenschaften als .lyrx-Datei speichern.
Attributausdrücke sind eine symmetrische Operation. Das Werkzeug verwendet beim Gruppieren einen Eingabe-Layer, der mit sich selbst verglichen wird. Daher wird der Eingabe-Layer im ArcGIS Arcade-Ausdruck mit a und b bezeichnet, und alle Ausdrücke müssen a und b enthalten. Um beispielsweise alle Datensätze zu gruppieren, wenn das Feld Amount den gleichen Wert enthält, verwenden Sie den folgenden Ausdruck: $a["Amount"] == $b["Amount"].
Wenn Sie einen oder mehrere der folgenden Schritte durchführen, können Sie die Performance des Werkzeugs Nach Nähe gruppieren verbessern:
- Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
- Legen Sie bei der Verwendung der Option Nahe (planar) oder Nahe (geodätisch) des Parameters Räumliche Beziehung einen kleineren Parameterwert für Räumliche Near-Entfernung fest.
- Bei der Verwendung des Parameters Räumliche Beziehung ist die Option Nahe (planar) schneller als die Option Nahe (geodätisch).
- Legen Sie bei der Verwendung der Option Nahe des Parameters Zeitliche Beziehung einen kleineren Parameterwert für Zeitliche Near-Entfernung fest.
- Verwenden Sie lokale Daten an der Stelle, an der die Analyse ausgeführt wird.
Dieses Geoverarbeitungswerkzeug wird unterstützt durch Spark. Bei Analysen auf Ihrem Desktop-Computer werden mehrere Kerne parallel verwendet. Weitere Informationen über die Ausführung der Analyse finden Sie unter Überlegungen zu GeoAnalytics Desktop-Werkzeugen.
Bei der Ausführung von GeoAnalytics Desktop-Werkzeugen wird die Analyse auf Ihrem Desktop-Computer durchgeführt. Für eine optimale Performance sollten die Daten auf Ihrem Desktop verfügbar sein. Wenn Sie einen gehosteten Feature-Layer verwenden, wird empfohlen, ArcGIS GeoAnalytics Server zu verwenden. Wenn Ihre Daten nicht lokal verfügbar sind, dauert die Ausführung eines Werkzeugs bedeutend länger. Informationen zur Verwendung von ArcGIS GeoAnalytics Server für Analysen finden Sie unter GeoAnalytics Tools.
Parameter
arcpy.geoanalytics.GroupByProximity(input_layer, output, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship})| Name | Erläuterung | Datentyp |
input_layer | Die Punkt-, Linien- oder Polygon-Features, die gruppiert werden. | Feature Layer |
output | Die Ausgabe-Feature-Class mit den gruppierten Features, dargestellt durch ein neues Feld namens group_id. | Feature Class |
spatial_relationship | Gibt den Beziehungstyp an, nach dem Features gruppiert werden.
| String |
spatial_near_distance (optional) |
Die zum Gruppieren von Near-Features verwendete Entfernung. Dieser Parameter wird nur verwendet, wenn der Parameterwert spatial_relationship NEAR_PLANAR oder NEAR_GEODESIC lautet. | Linear Unit |
temporal_relationship (optional) |
Gibt die zeitlichen Kriterien für die Zuordnung von Features an. Wenn der Parameter auf INTERSECTS oder NEAR festgelegt ist, werden Features gruppiert, wenn sowohl die räumlichen als auch die zeitlichen Kriterien erfüllt sind. Um diese Option zu unterstützen, müssen die Zeiteigenschaften bei der Eingabe aktiviert werden.
| String |
temporal_near_distance (optional) |
Die zum Gruppieren von Near-Features verwendete zeitliche Entfernung. Dieser Parameter wird nur verwendet, wenn der Parameterwert temporal_relationship Near lautet. | Time Unit |
attribute_relationship (optional) | Ein ArcGIS Arcade-Ausdruck, der zum Gruppieren der Features verwendet wird. Mit $a["Amount"] == $b["Amount"] werden Features beispielsweise gruppiert, wenn das Feld Amount den gleichen Wert enthält. | String |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion GroupByProximity verwenden.
# Name: GroupByProximity.py
# Description: Group roads together that touch
#
# Requirements: An advanced license
# Import system modules
import arcpy
# Set local variables
inFeatures = "C:\myData\cities.gdb\roads"
outname = "groupedRoads"
overlayType = "TOUCHES"
# Run Group By Proximity
result = arcpy.gapro.GroupByProximity(inFeatures, outname, overlayType)