Zusammenfassung
Findet zentrale Features und Richtungsverteilungen und berechnet Mittel- und Medianwertpositionen aus der Eingabe.
Abbildung
Verwendung
Dieses Werkzeug kann für die Zentrierung und Verteilung von Features verwendet werden. Nachfolgend finden Sie Beispielsituationen, in denen dieses Werkzeug hilfreich ist:
- Eine Kommunalverwaltung plant, eine neue Bibliothek für eine unterversorgte Gemeinde zu eröffnen. Bestimmte Schwerpunkte in Blockgruppen mit der geeigneten Flächenverteilung und verfügbare Parzellen wurden erfasst. Die Berechnung eines zentralen Features mit einer Gewichtung auf Bevölkerung kann verwendet werden, um die zentrale Blockgruppe zu ermitteln, die der Gemeinde am besten dient.
- Ein GIS-Analyst analysiert die Positionen der 911-Notrufe und die Positionen der Notdienstzentralen (Polizei, Feuerwehr und Krankenwagen). Das Ergebnis eines Mittelpunktes kann verwendet werden, um den Mittelpunkt der Notrufe und den Mittelpunkt der Notdienstzentralen zu vergleichen und die Reaktionszeiten zu optimieren.
- Ein für die Kriminalitätsanalyse zuständiger Mitarbeiter möchte ermitteln, ob sich der Medianwert für Einbrüche beim Auswerten von Einbrüchen bei Tag im Vergleich zu Einbrüchen bei Nacht ändert. Die Berechnung eines Medianzentrums mit einer Gruppierung nach Tageszeit kann verwendet werden, um zu ermitteln, wo Straftaten bei Tag und bei Nacht geschehen.
- Ein GIS-Analyst für eine Nichtregierungsorganisation analysiert die Ausbreitung einer Infektionskrankheit. Mit einer Ellipse kann die Verteilung eines Ausbruchs modelliert werden.
Der Parameter Gewichtungsfeld wird verwendet, um Orte nach ihrer relativen Bedeutung zu gewichten. Beispielsweise können Filialen einer Einzelhandelskette nach Gesamtumsatz oder Polygon-Features nach ihrer Fläche gewichtet werden. Weitere Informationen zur Anwendung von Gewichtungen in Analysen finden Sie unter Verwenden von Gewichtungen.
Der Parameter Nach Feld gruppieren wird zum Gruppieren von Features für separate Berechnungen von zentralen Features oder der Verteilung verwendet. Zum Beispiel können Naturbeobachtungen, die im gesamten Jahr stattgefunden haben, nach Jahreszeit oder Monat gruppiert werden. Das Feld kann eine ganze Zahl, ein Datum oder eine Zeichenfolge aufweisen. Datensätze mit NULL-Werten werden gruppiert.
Das zentrale Feature ist das Feature, das der kürzesten kumulativen Entfernung zu allen anderen Features im Dataset zugewiesen ist. Dieses Feature wird ermittelt und in die Ausgabe Layer mit zentralem Feature einbezogen. Es ist möglich, dass mehrere Features die kürzeste kumulative Entfernung zu allen anderen Features gemeinsam haben. Wenn dies der Fall ist, werden alle am zentralsten positionierte Features in die Ausgabe Layer mit zentralem Feature einbezogen. Wenn der Parameterwert Nach Feld gruppieren angegeben wird, werden die Eingabe-Features zuerst nach den Feldwerten gruppiert. Anschließend wird ein zentrales Feature für jede Gruppe ermittelt.
Der Mittelpunkt ist ein aus den durchschnittlichen X- und Y-Koordinaten erstellter Punkt. Die Mittelpunkt-Features werden in die Ausgabe Layer mit Mittelwert für Mittelpunkt einbezogen. Wenn der Parameterwert Nach Feld gruppieren angegeben wird, werden die Eingabe-Features zuerst nach den Feldwerten gruppiert. Anschließend wird für jede Gruppe der Mittelpunkt berechnet.
Das Medianzentrum verwendet einen iterativen Algorithmus, um den geometrischen Medianwertpunkt zu finden, der die euklidische Entfernung zu allen Features im Dataset minimiert. Die Medianzentrum-Features werden in die Ausgabe Layer mit Medianwert für Mittelpunkt einbezogen. Wenn der Parameterwert Nach Feld gruppieren angegeben wird, werden die Eingabe-Features zuerst nach den Feldwerten gruppiert. Anschließend wird für jede Gruppe das Medianzentrum berechnet. Im Gegensatz zu den Ergebnissen des Mittelpunkt-Vorgangs werden die Ergebnisse des Medianzentrums weniger von Ausreißer-Features beeinflusst.
Es werden Standardabweichungsellipsen erstellt, um die räumlichen Eigenschaften geographischer Features zusammenzufassen: zentrale Tendenz, Streuung und Richtungstrends. Die Ellipse kann 1, 2 oder 3 Standardabweichungen groß sein. Die Ellipsen-Features werden in die Ausgabe Ellipsenlayer einbezogen. Wenn der Wert Nach Feld gruppieren angegeben wird, werden die Eingabe-Features zuerst nach den Feldwerten gruppiert. Anschließend wird für jede Gruppe eine Ellipse berechnet.
Sie können mindestens einen auszugebenden Zusammenfassungstyp angeben. Jeder Zusammenfassungstyp wird in einem eindeutigen Feature-Layer ausgegeben.
Enthält der Eingabe-Layer Features mit NULL-Werten für Zeit oder Geometrie, werden die Features nicht in der Analyse verwendet.
Sofern die Zeiteigenschaften für den Eingabe-Layer aktiviert wurden, stellen die Ergebnisse nicht den zeitlichen Mittelpunkt dar. Bei der Berechnung der zentralen Tendenz und Verteilung werden nur räumliche Überlegungen angestellt.
Neben den Feldern aus dem Eingabe-Layer enthält das Zusammenfassungstyp-Ergebnis der Ausgabe Zentrales Feature die folgenden Felder:
Feldname Beschreibung CoordX
Die X-Koordinate des zentralen Features. Wenn es sich bei dem Feature um eine Linie oder ein Polygon handelt, stellt der Wert den Schwerpunkt des Features dar.
CoordY
Die Y-Koordinate des zentralen Features. Wenn es sich bei dem Feature um eine Linie oder ein Polygon handelt, stellt der Wert den Schwerpunkt des Features dar.
instant_datetime
Wenn für den Eingabe-Layer Zeiteigenschaften mit dem Zeittyp "Zeitpunkt" aktiviert wurden, enthält das Ausgabeergebnis ein Feld für das Datum des Zeitpunktes, in dem die Uhrzeit des Ausgabe-Features angegeben wird.
Zusätzlich zu dem optionalen Parameterwert Nach Feld gruppieren, der in der Analyse verwendet wird, enthalten die Zusammenfassungstyp-Ergebnisse der Ausgaben Mittelwert für Mittelpunkt und Medianwert für Mittelpunkt die folgenden Felder:
Feldname Beschreibung CoordX
Die X-Koordinate des Mittelwert- oder Medianwert-Features.
CoordY
Die Y-Koordinate des Mittelwert- oder Medianwert-Features.
instant_datetime
Wenn für den Eingabe-Layer Zeiteigenschaften mit dem Zeittyp "Zeitpunkt" aktiviert wurden, enthält das Ausgabeergebnis ein Feld für das Datum des Zeitpunktes, in dem die Uhrzeit des Ausgabe-Features angegeben wird.
Zusätzlich zu dem optionalen Parameterwert Nach Feld gruppieren, der in der Analyse verwendet wird, enthält der Zusammenfassungstyp der Ausgabe Ellipse die folgenden Felder:
Feldname Beschreibung CenterX
Die X-Koordinate des Mittelpunktes der Ellipse.
CenterY
Die Y-Koordinate des Mittelpunktes der Ellipse.
CenterT
Den Zeitwert des Mittelpunktes der Ellipse.
Rotation
Die Rotation der langen Achse gemessen im Uhrzeigersinn von 12 Uhr aus. Dieser Wert wird in Grad gemessen.
MajStdDist
Die Standardentfernung für die große Halbachse. Dieser Wert wird in Grad gemessen.
MinStdDist
Die Standardentfernung für die kleine Halbachse. Dieser Wert wird in Grad gemessen.
TmStdDist
Die zeitliche Standardentfernung. Dieser Wert ist eine Dauer, die in Millisekunden gemessen wird.
Attribute von Koordinatenwerten, z. B. CoordX und CoordY, werden mit dem Raumbezug der Analyse berechnet. Standardmäßig ist der Raumbezug der Analyse identisch mit dem Eingabe-Layer. Sie können den in der Analyse verwendeten Raumbezug wahlweise mit der Variablen der Umgebung "Ausgabekoordinatensystem" angeben.
Wenn Sie Ergebnisse in ein Data Store vom Typ "spatiotemporal" schreiben, werden die Ergebnis-Features in dem Koordinatensystem "WGS 1984 (WKID 4326)" dargestellt. Das bedeutet, dass die Geometriewerte der Ergebnis-Features möglicherweise in anderen Koordinatensystemen gespeichert werden als die Ausgabeattributwerte. Wenn Sie beispielsweise einen Layer mit Mittelwert für Mittelpunkt in dem Data Store des Typs "spatiotemporal" ausgeben und den Umgebungswert "Ausgabekoordinatensystem" auf "NAD 1983 UTM Zone 1N (WKID 26901)" setzen, befinden sich die berechneten Werte für die Felder CoordX und CoordY im Koordinatensystem "NAD 1983 UTM Zone 1N (WKID 26901)", aber die Features auf der Karte im Koordinatensystem "WGS 1984 (WKID 4326)".
Wenn Sie einen oder mehrere der folgenden Schritte durchführen, können Sie die Performance des Werkzeugs Zentrierung und Verteilung zusammenfassen verbessern:
- Legen Sie die Ausdehnungsumgebung so fest, dass nur die gewünschten Daten analysiert werden.
- Verwenden Sie lokale Daten an der Stelle, an der die Analyse ausgeführt wird.
- Gruppieren Sie Daten mit dem Parameter Nach Feld gruppieren.
- Bei größeren Datasets ist Medianwert für Mittelpunkt aufgrund der iterativen Berechnungen möglicherweise der leistungsschwächste Zusammenfassungstyp.
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
Syntax
arcpy.geoanalytics.SummarizeCenterAndDispersion(input_layer, output_name, generate_types, {ellipse_size}, {weight_field}, {group_by_field}, {data_store})| Parameter | Erklärung | Datentyp |
input_layer | Der Punkt-Layer, der zusammengefasst werden soll | Feature Set |
output_name | Der Name des Ausgabe-Feature-Service. | String |
generate_types [generate_types,...] | Gibt die zu generierenden Zusammenfassungstypen an. Sie können mindestens einen Zusammenfassungstyp verwenden. Für jeden ausgewählten Zusammenfassungstyp wird ein eindeutiger Layer erstellt.
| String |
ellipse_size (optional) | Gibt die Größe von Ausgabeellipsen in Standardabweichungen an.
| String |
weight_field (optional) | Ein Zahlenfeld, das verwendet wird, um Orte nach ihrer relativen Bedeutung zu gewichten. Dies gilt für alle Zusammenfassungstypen. | Field |
group_by_field (optional) | Das Feld zum Gruppieren ähnlicher Features. Dies gilt für alle Zusammenfassungstypen. Wenn Sie z. B. das Feld PlantType auswählen, das Werte für Bäume, Büsche und Gräser enthält, werden alle Features mit Werten für Bäume im Hinblick auf ihren eigenen Mittelpunkt und ihre eigene Verteilung analysiert. In diesem Beispiel ergeben sich drei Features, eins für jede Gruppe von Bäumen, Büschen und Gräsern. | Field |
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 |
| out_central_feature_layer | Der Layer, der das zentrale Feature des Eingabe-Layers enthält. | Feature-Class |
| out_mean_center_layer | Der Punkt-Layer, der die Mittelpunktdarstellungen des Eingabe-Layers enthält. | Feature-Class |
| out_median_center_layer | Der Punkt-Layer, der die Darstellungen des Medianzentrums des Eingabe-Layers enthält. | Feature-Class |
| out_ellipse_layer | Der Polygon-Layer, der die Ellipsendarstellungen des Eingabe-Layers enthält. | Feature-Class |
Codebeispiel
Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug SummarizeCenterAndDispersion verwendet wird.
# Name: SummarizeCenterAndDispersion.py
# Description: Calculate a standard deviational ellipse of contagious disease
# data to understand the spread of the disease over time.
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
# This example calculates a standard deviational ellipse for 3 standard
# deviations of the data
inFeatures = "https://sampleserver6.com/arcgis/rest/services/DataStoreCatalogs/bigDataFileShares_myBDFS/BigDataCatalogServer/diseaseRecords"
outFS = "disease_movement_ellipse"
summaryType = "ELLIPSE"
dataStore = "RELATIONAL_DATA_STORE"
# Execute SummarizeCenterAndDispersion
arcpy.geoanalytics.SummarizeCenterAndDispersion(inFeatures, outFS, summaryType,
"3_STANDARD_DEVIATIONS", "",
"", "", "", "" 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