Nach Nähe gruppieren (GeoAnalytics)

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

• Dieses Geoverarbeitungswerkzeug ist ab ArcGIS Enterprise 10.9.1 verfügbar.

• 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
  Features werden gruppiert, wenn alle angegebenen Beziehungen erfüllt sind.

• 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.

• 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 ArcGIS GeoAnalytics Server. Die Analyse wird auf dem GeoAnalytics Server ausgeführt, und die Ergebnisse werden in den eigenen Inhalten in ArcGIS Enterprise gespeichert.

• Bei der Ausführung von GeoAnalytics Server-Werkzeugen wird die Analyse auf dem GeoAnalytics Server abgeschlossen. Für eine optimale Performance sollten die Daten dem GeoAnalytics Server über Feature-Layer zur Verfügung stehen, die auf Ihrem ArcGIS Enterprise-Portal gehostet werden. Alternativ können Big-Data-Dateifreigaben verwendet werden. Daten, auf die der GeoAnalytics Server nicht lokal zugreifen kann, werden vor Analysebeginn auf den GeoAnalytics Server verschoben. Dadurch dauert die Ausführung eines Werkzeugs länger. Es kann zudem vorkommen, dass das Verschieben der Daten von ArcGIS Pro zum GeoAnalytics Server fehlschlägt. Die Wahrscheinlichkeit eines Fehlers hängt dabei von der Netzwerkgeschwindigkeit sowie der Größe und Komplexität der Daten ab. Es wird empfohlen, dass Sie Ihre Daten stets freigeben oder eine Big-Data-Dateifreigabe erstellen.

  Weitere Informationen zum Freigeben von Daten in Ihrem Portal

  Weitere Informationen zum Erstellen einer Big-Data-Dateifreigabe über Server Manager

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Layer	Die Punkt-, Linien- oder Polygon-Features, die gruppiert werden.	Feature Set
Ausgabename	Der Name des Ausgabe-Feature-Service. Der Name des Ausgabe-Feature-Service mit den gruppierten Features, dargestellt durch einen neuen Feldnamen. group_id	String
Räumliche Beziehung	Gibt den Beziehungstyp an, nach dem Features gruppiert werden. Überschneidet—Features werden gruppiert, wenn sich Features oder Teile von Features überlappen. Dies ist die Standardeinstellung. Berührt—Features werden mit einem anderen Feature gruppiert, wenn sie einen sich überschneidenden Stützpunkt haben, aber die Features sich nicht überlappen. Nahe (planar)—Features werden gruppiert, wenn sich ein Stützpunkt oder eine Kante innerhalb einer bestimmten planaren Entfernung eines anderen Features befindet. Nahe (geodätisch)—Features werden gruppiert, wenn sich ein Stützpunkt oder eine Kante innerhalb einer bestimmten geodätischen Entfernung eines anderen Features befindet.	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. Überschneidet—Features werden gruppiert, wenn ein Teil der Zeit eines Features ein anderes Feature überlappt. Dies ist die Standardeinstellung. Nahe—Features werden gruppiert, wenn sich die Zeit des Features innerhalb des Zeitbereichs eines anderen Features befindet. Keine—Die Zeit wird nicht zur Gruppierung von Features verwendet.	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
Data Store (optional)	Gibt den ArcGIS Data Store für das Speichern der Ausgabe an. Die Standardvorgabe ist der Big Data Store vom Typ "spatiotemporal". Alle in einem Big Data Store vom Typ "spatiotemporal" gespeicherten Ergebnisse werden im WGS84 gespeichert. Ergebnisse, die in einem Data Store vom Typ "relational" gespeichert werden, behalten ihr Koordinatensystem bei. Big Data Store vom Typ "spatiotemporal"—Die Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung. Data Store vom Typ "relational"—Die Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.	String
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

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Feature-Layer	Eine neue Feature-Class mit den gruppierten Features, dargestellt durch ein neues Feld namens group_id.	Feature Set

Python

arcpy.geoanalytics.GroupByProximity(input_layer, output_name, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {data_store}, {attribute_relationship})

Name	Erläuterung	Datentyp
input_layer	Die Punkt-, Linien- oder Polygon-Features, die gruppiert werden.	Feature Set
output_name	Der Name des Ausgabe-Feature-Service. Der Name des Ausgabe-Feature-Service mit den gruppierten Features, dargestellt durch einen neuen Feldnamen. group_id	String
spatial_relationship	Gibt den Beziehungstyp an, nach dem Features gruppiert werden. INTERSECTS—Features werden gruppiert, wenn sich Features oder Teile von Features überlappen. Dies ist die Standardeinstellung. TOUCHES—Features werden mit einem anderen Feature gruppiert, wenn sie einen sich überschneidenden Stützpunkt haben, aber die Features sich nicht überlappen. NEAR_PLANAR—Features werden gruppiert, wenn sich ein Stützpunkt oder eine Kante innerhalb einer bestimmten planaren Entfernung eines anderen Features befindet. NEAR_GEODESIC—Features werden gruppiert, wenn sich ein Stützpunkt oder eine Kante innerhalb einer bestimmten geodätischen Entfernung eines anderen Features befindet.	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. INTERSECTS—Features werden gruppiert, wenn ein Teil der Zeit eines Features ein anderes Feature überlappt. Dies ist die Standardeinstellung. NEAR—Features werden gruppiert, wenn sich die Zeit des Features innerhalb des Zeitbereichs eines anderen Features befindet. NONE—Die Zeit wird nicht zur Gruppierung von Features verwendet.	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
data_store (optional)	Gibt den ArcGIS Data Store für das Speichern der Ausgabe an. Die Standardeinstellung ist SPATIOTEMPORAL_DATA_STORE. Alle in einem Big Data Store vom Typ "spatiotemporal" gespeicherten Ergebnisse werden im WGS84 gespeichert. Ergebnisse, die in einem Data Store vom Typ "relational" gespeichert werden, behalten ihr Koordinatensystem bei. SPATIOTEMPORAL_DATA_STORE—Die Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung. RELATIONAL_DATA_STORE—Die Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.	String
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

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
output	Eine neue Feature-Class mit den gruppierten Features, dargestellt durch ein neues Feld namens group_id.	Feature Set

Codebeispiel

GroupByProximity – Beispiel (eigenständiges Skript)

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: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://myGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_cityData/BigDataCatalogServer/roads"
outFS = "groupedRoads"
overlayType = "TOUCHES"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Group By Proximity
result = arcpy.geoanalytics.GroupByProximity(inFeatures, outFS, 
                                 overlayType, data_store=dataStore)

Umgebungen

Ausgabe-Koordinatensystem, Ausdehnung, Aktueller Workspace

Sonderfälle

Ausgabe-Koordinatensystem

Das Koordinatensystem, das für die Analyse verwendet wird. Die Analyse wird im Eingabe-Koordinatensystem ausgeführt, sofern nicht anders durch diesen Parameter angegeben. Für GeoAnalytics Tools werden die Endergebnisse im Data Store vom Typ "spatiotemporal" in WGS84 gespeichert.

Lizenzinformationen

• Basic: Erfordert ArcGIS GeoAnalytics Server
• Standard: Erfordert ArcGIS GeoAnalytics Server
• Advanced: Erfordert ArcGIS GeoAnalytics Server