Nach Nähe gruppieren (GeoAnalytics Desktop)

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

Darstellung des Werkzeugs "Nach Nähe gruppieren"

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
    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ÜberschneidetBerührtNahe (geodätisch)Nahe (planar)

    Punkt

    HäkchenHäkchenHäkchen

    Polylinie

    HäkchenHäkchenHäkchenHäkchen

    Polygon

    HäkchenHäkchenHäkchenHäkchen

    ÜberlagerungsmethodeBeschreibung

    Ü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ÜberschneidetNahe

    Keine

    Zeitpunkt

    HäkchenHäkchen

    Intervall

    HäkchenHäkchen

    Zeitliche BeziehungsmethodeBeschreibung

    Ü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:

  • 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

BeschriftungErläuterungDatentyp
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.

  • ÜberschneidetFeatures werden gruppiert, wenn sich Features oder Teile von Features überlappen. Dies ist die Standardeinstellung.
  • BerührtFeatures 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.

  • ÜberschneidetFeatures werden gruppiert, wenn ein Teil der Zeit eines Features ein anderes Feature überlappt. Dies ist die Standardeinstellung.
  • NaheFeatures werden gruppiert, wenn sich die Zeit des Features innerhalb des Zeitbereichs eines anderen Features befindet.
  • KeineDie 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
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

arcpy.geoanalytics.GroupByProximity(input_layer, output, spatial_relationship, {spatial_near_distance}, {temporal_relationship}, {temporal_near_distance}, {attribute_relationship})
NameErläuterungDatentyp
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.

  • INTERSECTSFeatures werden gruppiert, wenn sich Features oder Teile von Features überlappen. Dies ist die Standardeinstellung.
  • TOUCHESFeatures werden mit einem anderen Feature gruppiert, wenn sie einen sich überschneidenden Stützpunkt haben, aber die Features sich nicht überlappen.
  • NEAR_PLANARFeatures werden gruppiert, wenn sich ein Stützpunkt oder eine Kante innerhalb einer bestimmten planaren Entfernung eines anderen Features befindet.
  • NEAR_GEODESICFeatures 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.

  • INTERSECTSFeatures werden gruppiert, wenn ein Teil der Zeit eines Features ein anderes Feature überlappt. Dies ist die Standardeinstellung.
  • NEARFeatures werden gruppiert, wenn sich die Zeit des Features innerhalb des Zeitbereichs eines anderen Features befindet.
  • NONEDie 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
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

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: 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)