Punkte aggregieren (GeoAnalytics)

Zusammenfassung

Aggregiert Punkte in Polygon-Features oder Abschnitte. An allen Positionen, an denen Punkte vorhanden sind, wird ein Polygon mit der Anzahl von Punkten und optionalen Statistiken zurückgegeben.

Weitere Informationen zur Funktionsweise von Zeitschritten

Abbildung

Werkzeug "Punkte aggregieren"
Es werden Beispiele für das Aggregieren von Punkten in Polygone (erste Zeile), von Punkten mit aktivierten Zeiteigenschaften in Polygone mit Zeitschritten (zweite Zeile), von Punkten in Abschnitte (dritte Zeile) und von Punkten in Abschnitte mit Zeitschritten (vierte Zeile) gezeigt.

Verwendung

  • Sie haben folgende Möglichkeiten, die Bereiche anzugeben, in denen die Punkte aggregiert werden sollen:

    • Verwenden eines Polygon-Layers
    • Verwenden eines quadratischen Abschnitts, hexagonalen Abschnitts oder H3-Abschnitts in der angegebenen Größe, der beim Ausführen der Analyse erstellt wird.

    Sie können den für die Analyse zu verwendenden Flächen-Layer bereitstellen oder Abschnitte mit festgelegter Größe und festgelegtem Shape (Hexagon, Quadrat oder H3) erstellen, in die die Punkte aggregiert werden sollen. Anhand der Abschnittsgröße wird die Größe der quadratischen und hexagonalen Abschnitte festgelegt.

    • Beim Aggregieren in Hexagone entspricht die Größe der Höhe jedes Hexagons und die Breite des resultierenden Hexagons der doppelten Höhe dividiert durch die Quadratwurzel von 3.
    • Beim Aggregieren in Quadrate entspricht die Abschnittsgröße der Höhe des Quadrats und damit der Breite.
    • Beim Aggregieren in H3-Abschnitte wird die Abschnittsgröße durch die festgelegte H3-Abschnittsauflösung bestimmt. Die H3-Abschnittsauflösung kann ein Wert zwischen 0 und 15 sein, wobei mit 0 die größten und mit 15 die kleinsten Abschnitte erzeugt werden.

    Hexagonale und quadratische Abschnitte

  • Für Punkte aggregieren muss beim Aggregieren in hexagonale oder quadratische Abschnitte der Wert des Parameters Punkt-Layer projiziert oder das Ausgabekoordinatensystem auf ein projiziertes Koordinatensystem festgelegt sein. Wenn sich beim Aggregieren in hexagonale oder quadratische Abschnitte die Daten nicht in einem projizierten Koordinatensystem befinden und Sie kein verarbeitendes projiziertes Koordinatensystem festlegen, wird eine Projektion anhand der Ausdehnung der analysierten Daten zugewiesen. Beim Aggregieren in H3-Abschnitte muss der Wert des Parameters Punkt-Layer in World Geodetic System 1984 (WKID 4326) angegeben werden. Bei Bedarf wird der Wert in dieses Koordinatensystem transformiert.

  • Der Ausgabe-Feature-Layer ist immer ein Polygon-Layer. Es werden nur Polygone mit Punkten zurückgegeben, und resultierende Polygone werden vollständig aus dem Ergebnis-Layer entfernt.

    Mit Punkt-Features zurückgegebene Polygone
    Die Eingabe-Punkt- und Eingabe-Polygon-Features werden in der ersten Abbildung gezeigt und die resultierenden Flächen-Features aus dem Werkzeug "Punkte aggregieren" in der zweiten Abbildung.

  • Die grundlegendsten Aggregationen berechnen eine Anzahl von Punkten innerhalb jedes Polygons. Statistiken (Anzahl, Summe, Minimum, Maximum, Bereich, Mittelwert, Standardabweichung und Varianz) können auch für numerische Felder berechnet werden und Statistiken (Anzahl, beliebig) können für Zeichenfolgenfelder berechnet werden. Die Statistik wird für jede Fläche separat berechnet. Wenn Sie eine ungültige Statistik angeben (zum Beispiel den Mittelwert eines Zeichenfolgenfeldes), wird diese übersprungen.

    Hinweis:

    Wenn Anzahl auf ein Feld angewendet wird, wird eine Anzahl der im Feld vorhandenen Nicht-NULL-Werte zurückgegeben. Wenn beliebig auf ein Zeichenfolgenfeld angewendet wird, wird eine einzelne im Feld vorhandene Zeichenfolge zurückgegeben.

  • Wenn in der Eingabe Zeiteigenschaften aktiviert sind, können Sie der Analyse Zeitschritte hinzufügen. Jeder Zeitschritt wird unabhängig von den Features außerhalb des Zeitschrittes analysiert. Für die Verwendung von Zeitintervallen müssen Zeiteigenschaften für die Eingabedaten aktiviert sein und ein Zeitintervall darstellen. Bei Anwendung von Zeitschritten sind Ausgabe-Features Zeitintervalle, die durch die Felder START_DATETIME und END_DATETIME dargestellt werden.

    Weitere Informationen zu Zeitschritten

  • Wenn Sie ein Zeitschrittintervall, eine Zeitschrittwiederholung oder eine Referenzzeit angeben und Zeiteigenschaften für die Daten nicht aktiviert sind, tritt ein Fehler auf.

  • Der Parameter Zeitintervallbezug kann einen Datums- und Uhrzeitwert oder nur einen Datumswert aufweisen, jedoch nicht nur einen Uhrzeitwert.

  • Die folgenden Felder sind in den Ausgabe-Features enthalten:

    FeldnameBeschreibung

    count

    Die Anzahl der Features in jedem Polygon.

    statistic_fieldname

    Für jede der angegebenen Statistiken wird ein Attributfeld mit einem Namen im folgenden Format erstellt: Statistik_Feldname. So haben beispielsweise die maximale Abweichung und die Standardabweichung des Feldes id die Namen MAX_id und SD_id.

    start_date

    Wenn Zeitschritte angegeben sind, weisen die Ausgabepolygone ein Zeitintervall auf. Dieses Feld stellt die Startzeit dar.

    end_date

    Wenn Zeitschritte angegeben sind, weisen die Ausgabepolygone ein Zeitintervall auf. Dieses Feld stellt die Endzeit dar.

    bin_id

    Die numerische ID des H3-Abschnitts. Dieses Feld ist nur beim Aggregieren in H3-Abschnitte vorhanden.

  • Sie können die Performance des Werkzeugs Punkte aggregieren verbessern, indem Sie einen oder mehrere der folgenden Tipps anwenden:

    • Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
    • Bei größeren Abschnitten ist die Performance besser als bei kleineren Abschnitten. Wenn Sie nicht sicher sind, welche Größe Sie verwenden sollten, beginnen Sie mit einem größeren Abschnitt als Prototyp.
    • Ähnlich wie bei den Abschnitten führen auch größere Zeitschritte zu einer besseren Performance als kleinere Zeitschritte.
    • 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

  • Ähnliche Analysen können auch mit dem Werkzeug Punkte aggregieren in der Toolbox "Standard Feature Analysis" durchgeführt werden.

Parameter

BeschriftungErläuterungDatentyp
Punkt-Layer

Die Punkt-Features, die in Polygone oder Abschnitte aggregiert werden.

Feature Set
Ausgabename

Der Name des Ausgabe-Feature-Service.

String
Polygon oder Abschnitt

Gibt an, wie der Wert des Parameters Punkt-Layer aggregiert werden soll.

  • PolygonDer Punkt-Layer wird in ein Polygon-Dataset aggregiert.
  • AbschnittDer Punkt-Layer wird in quadratische oder hexagonale Abschnitte aggregiert, die beim Ausführen des Werkzeugs generiert werden.
String
Polygon-Layer
(optional)

Die Polygon-Features, in die die Eingabepunkte aggregiert werden.

Feature Set
Abschnittstyp
(optional)

Gibt das Abschnitts-Shape an, das generiert wird und die aggregierten Punkte enthalten soll.

  • QuadratEs werden quadratische Abschnitte generiert, wobei der Wert Abschnittsgröße die Höhe eines Quadrats darstellt. Dies ist die Standardeinstellung.
  • SechseckEs werden hexagonale Abschnitte generiert, wobei der Wert Abschnittsgröße die Höhe zwischen zwei parallelen Seiten darstellt.
  • H3Es werden H3-Abschnitte generiert. Die Abschnittsgröße wird durch den Wert des Parameters Abschnittsauflösung bestimmt.
String
Abschnittsgröße
(optional)

Das Entfernungsintervall, das die Abschnittsgröße und die Einheiten darstellt, in die der Wert Punkt-Layer aggregiert wird. Das Entfernungsintervall muss eine lineare Einheit sein.

Das Entfernungsintervall, das die Abschnittsgröße und Einheiten darstellt, in die der Punkt-Layer aggregiert wird. Das Entfernungsintervall muss eine lineare Einheit sein.

Linear Unit
Zeitschrittintervall
(optional)

Ein Wert, der die Dauer des Zeitschritts angibt. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen.

Zeitschritte können nur angewendet werden, wenn in der Eingabe Zeiteigenschaften aktiviert sind.

Time Unit
Zeitschrittwiederholung
(optional)

Ein Wert, der die Frequenz der Zeitschrittintervalle festlegt. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen.

Time Unit
Zeitschrittbezug
(optional)

Ein Datum, das die Bezugszeit festlegt, mit der die Zeitintervalle abgeglichen werden sollen. Die Standardeinstellung ist 1. Januar 1970 um 00:00 Uhr. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen.

Date
Zusammenfassungsfelder
(optional)

Die Statistiken, die für bestimmte Felder berechnet werden.

Value Table
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
Abschnittsauflösung
(optional)

Die Auflösung der H3-Abschnitte. Dies ist ein Wert zwischen 0 und 15, wobei mit 0 die größten und mit 15 die kleinsten H3-Abschnitte erzeugt werden.

Long

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Ausgabe-Feature-Layer

Die aggregierten Polygon-Features oder -Abschnitte.

Feature Set

arcpy.geoanalytics.AggregatePoints(point_layer, output_name, polygon_or_bin, {polygon_layer}, {bin_type}, {bin_size}, {time_step_interval}, {time_step_repeat}, {time_step_reference}, {summary_fields}, {data_store}, {bin_resolution})
NameErläuterungDatentyp
point_layer

Die Punkt-Features, die in Polygone oder Abschnitte aggregiert werden.

Feature Set
output_name

Der Name des Ausgabe-Feature-Service.

String
polygon_or_bin

Gibt an, wie der Wert des Parameters point_layer aggregiert wird.

  • POLYGONDer Punkt-Layer wird in ein Polygon-Dataset aggregiert.
  • BINDer Punkt-Layer wird in quadratische oder hexagonale Abschnitte aggregiert, die beim Ausführen des Werkzeugs generiert werden.
String
polygon_layer
(optional)

Die Polygon-Features, in die die Eingabepunkte aggregiert werden.

Feature Set
bin_type
(optional)

Gibt das Abschnitts-Shape an, das generiert wird und die aggregierten Punkte enthalten soll.

  • SQUAREEs werden quadratische Abschnitte generiert, wobei der Wert bin_size die Höhe eines Quadrats darstellt. Dies ist die Standardeinstellung.
  • HEXAGONEs werden hexagonale Abschnitte generiert, wobei der Wert bin_size die Höhe zwischen zwei parallelen Seiten darstellt.
  • H3Es werden H3-Abschnitte generiert. Die Abschnittsgröße wird durch den Wert des Parameters bin_resolution bestimmt.
String
bin_size
(optional)

Das Entfernungsintervall, das die Abschnittsgröße und die Einheiten darstellt, in die der Wert point_layer aggregiert wird. Das Entfernungsintervall muss eine lineare Einheit sein.

Linear Unit
time_step_interval
(optional)

Ein Wert, der die Dauer des Zeitschritts angibt. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen.

Zeitschritte können nur angewendet werden, wenn in der Eingabe Zeiteigenschaften aktiviert sind.

Time Unit
time_step_repeat
(optional)

Ein Wert, der die Frequenz der Zeitschrittintervalle festlegt. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen.

Time Unit
time_step_reference
(optional)

Ein Datum, das die Bezugszeit festlegt, mit der die Zeitintervalle abgeglichen werden sollen. Die Standardeinstellung ist 1. Januar 1970 um 00:00 Uhr. Dieser Parameter ist nur verfügbar, wenn Eingabepunkte mit aktivierten Zeiteigenschaften vorliegen und einen bestimmten Zeitpunkt darstellen.

Date
summary_fields
[summary_fields,...]
(optional)

Die Statistiken, die für bestimmte Felder berechnet werden.

  • COUNT: Die Anzahl der Nicht-NULL-Werte. Es kann für numerische Felder oder Zeichenfolgen verwendet werden. Die Anzahl von [null, 0, 2] ist 2.
  • SUM: Die Summe der numerischen Werte in einem Feld. Die Summe von [null, null, 3] ist 3.
  • MEAN: Der Mittelwert der numerischen Werte. Der Mittelwert von [0,2, null] ist 1.
  • MIN: Der Minimalwert eines numerischen Feldes. Das Minimum von [0, 2, null] ist 0.
  • MAX: Der Maximalwert eines numerischen Feldes. Der Maximalwert von [0, 2, null] ist 2.
  • STDDEV: Die Standardabweichung eines numerischen Feldes. Die Standardabweichung von [1] ist null. Die Standardabweichung von [null, 1,1,1] ist null.
  • VAR: Die Varianz eines numerischen Feldes in einem Track. Die Varianz von [1] ist null. Die Varianz von [null, 1,1,1] ist null.
  • RANGE: Der Bereich eines numerischen Feldes. Dieser wird durch die Subtraktion der Minimalwerte vom Maximalwert berechnet. Der Bereich von [0, null, 1] ist 1. Der Bereich von [null, 4] ist 0.
  • ANY: Dies ist eine Beispielzeichenfolge aus einem Feld vom Typ "Zeichenfolge".

Value Table
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_STOREDie Ausgabe wird in einem Big Data Store vom Typ "spatiotemporal" gespeichert. Dies ist die Standardeinstellung.
  • RELATIONAL_DATA_STOREDie Ausgabe wird in einem Data Store vom Typ "relational" gespeichert.
String
bin_resolution
(optional)

Die Auflösung der H3-Abschnitte. Dies ist ein Wert zwischen 0 und 15, wobei mit 0 die größten und mit 15 die kleinsten H3-Abschnitte erzeugt werden.

Long

Abgeleitete Ausgabe

NameErläuterungDatentyp
output

Die aggregierten Polygon-Features oder -Abschnitte.

Feature Set

Codebeispiel

AggregatePoints (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion AggregatePoints verwenden.

# Name: AggregatePoints.py
# Description: Aggregate 311 events into 1 KM Bins.
#
# Requirements: ArcGIS GeoAnalytics Server

# Import system modules
import arcpy

# Set local variables
inFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/SF311/FeatureServer/0"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
outFS = "AggregateWildfires"
dataStore = "SPATIOTEMPORAL_DATA_STORE"

# Run Aggregate Points
arcpy.geoanalytics.AggregatePoints(inFeatures, outFS, "BIN", None, "HEXAGON", 
                                   "1 Kilometers", None, None, None, None, 
                                   dataStore)

Umgebungen

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

Verwandte Themen