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.
Abbildung
Verwendung
Es gibt zwei Möglichkeiten für das Angeben der Flächen, in denen Punkte aggregiert werden:
- Verwenden eines Polygon-Layers.
- Verwenden eines quadratischen oder hexagonalen 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 oder Quadrat) erstellen, in die aggregiert werden soll. Anhand der Abschnittsgröße wird die Größe der Abschnitte festgelegt. Beim Aggregieren in Hexagone entspricht die Größe der Höhe eines Hexagons. Die Breite des resultierenden Hexagons entspricht dabei 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.
Für Punkte aggregieren ist erforderlich, dass der Punkt-Layer projiziert wird oder dass das Ausgabe-Koordinatensystem auf ein Projiziertes Koordinatensystem festgelegt wird. Wenn Ihre Daten sich nicht in einem projizierten Koordinatensystem befinden und Sie kein projiziertes Verarbeitungskoordinatensystem einrichten, wird eine Projektion anhand der Ausdehnung der analysierten Daten zugewiesen.
Der Ausgabe-Feature-Layer ist immer ein Polygon-Layer. Es werden nur Polygone mit enthaltenen Punkten zurückgegeben, wobei resultierende Polygone vollständig aus dem Ergebnis-Layer entfernt werden.
Die grundlegendsten Aggregationen berechnen die Anzahl von Punkten in den einzelnen Polygonen. 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 (Mittelwert eines Zeichenfolgenfelds) angeben, wird sie übersprungen.
Hinweis:
Wenn Anzahl auf ein Feld angewendet wird, wird eine Anzahl der im Feld vorhandenen Nicht-Nullwerte 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. Jedes Zeitintervall wird unabhängig von den Features außerhalb des Zeitintervalls analysiert. Für die Verwendung von Zeitintervallen müssen Zeiteigenschaften für Ihre 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.
Wenn Sie ein Zeitschrittintervall, eine Zeitschrittwiederholung oder eine Bezugszeit angegeben haben und für die Daten keine Zeiteigenschaften aktiviert sind, führt das Werkzeug zu einem Fehler.
Der Parameter Zeitintervallbezug kann einen Datums- und Uhrzeitwert oder nur einen Datumswert aufweisen, jedoch nicht nur einen Uhrzeitwert.
Folgende Felder sind in den Ausgabe-Features enthalten:
Feldname Beschreibung count
Die Anzahl der Features in den einzelnen Polygonen.
statistic_fieldname
Für angegebene Statistiken wird jeweils ein Attributfeld erstellt, für das ein Name im folgenden Format festgelegt wird: Statistik_Feldname. Die maximale Abweichung und die Standardabweichung des Felds id lautet MAX_id bzw. SD_id.
start_date
Wenn die Verwendung von Zeitschritten angegeben wird, weisen Ausgabe-Polygone ein Zeitintervall auf. Dieses Feld stellt die Startzeit dar.
end_date
Wenn die Verwendung von Zeitschritten angegeben wird, weisen Ausgabe-Polygone ein Zeitintervall auf. Dieses Feld stellt die Endzeit dar.
Mithilfe der folgenden Tipps können Sie die Performance des Werkzeugs Punkte aggregieren verbessern:
- Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
- Größere Abschnitte sind leistungsfähiger als kleinere Abschnitte. Wenn Sie nicht sicher sind, welche Größe Sie verwenden sollen, beginnen Sie mit einem größeren Abschnitt.
- Wie bei den Abschnitten sind auch größere Zeitintervalle leistungsfähiger als kleinere Zeitintervalle.
- 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. Daher 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
Eine ähnliche Analyse ist auch mit dem Werkzeug Punkte aggregieren in der Toolbox "Standard Feature Analysis" möglich.
Syntax
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})
Parameter | Erklärung | Datentyp |
point_layer | Die Punkt-Features, die in Polygone oder Abschnitte aggregiert werden sollen. | Feature Set |
output_name | Der Name des Ausgabe-Feature-Service. | String |
polygon_or_bin | Gibt an, wie point_layer aggregiert werden soll.
| String |
polygon_layer (optional) | Die Polygon-Features, in die die Eingabepunkte aggregiert werden. | Feature Set |
bin_type (optional) | Gibt das Abschnitts-Shape an, das zum Speichern der aggregierten Punkte generiert wird.
| String |
bin_size (optional) | Das Entfernungsintervall, das die Abschnittsgröße und Einheiten darstellt, in die 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. Der Standardwert 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.
| 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.
| String |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
output | Die aggregierten Polygon-Features oder -Abschnitte. | Feature Set |
Codebeispiel
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs AggregatePoints im Python-Fenster.
#-------------------------------------------------------------------------------
# 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"
# Execute Aggregate Points
arcpy.geoanalytics.AggregatePoints(inFeatures, outFS, "BIN", None, "HEXAGON",
"1 Kilometers", None, None, None, None,
dataStore)
Umgebungen
- 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