Beschriftung | Erläuterung | Datentyp |
Eingabe-Layer | Der zusammenzufassende Punkt-, Linien- oder Polygon-Layer. | Feature Layer |
Zentrales Ausgabe-Feature | Die Ausgabe-Feature-Class mit dem am zentralsten positionierten Feature im Eingabe-Layer. | Feature Class |
Mittelwert-Ausgabe für Mittelpunkt (optional) | Die Ausgabe-Point-Feature-Class mit den Features, welche die Mittelpunkte des Eingabe-Layers darstellen. | Feature Class |
Medianwert-Ausgabe für Mittelpunkt (optional) | Die Ausgabe-Point-Feature-Class mit den Features, welche die Medianzentren des Eingabe-Layers darstellen. | Feature Class |
Ausgabeellipse (optional) | Die Ausgabe-Polygon-Feature-Class mit der richtungsbezogenen Ellipsendarstellung des Eingabe-Layers. | Feature Class |
Ellipsengröße (optional) | Gibt die Größe von Ausgabeellipsen in Standardabweichungen an.
| String |
Gewichtungsfeld (optional) | Ein Zahlenfeld, das verwendet wird, um Orte nach ihrer relativen Bedeutung zu gewichten. Dies gilt für alle Zusammenfassungstypen. | Field |
Nach Feld gruppieren (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 |
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). Die Berechnung 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. Ein Medianzentrum, das mit einer Gruppierung nach Tageszeit berechnet wurde, 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.
Für Eingabe-Linien- und -Polygon-Features werden bei Entfernungsberechnungen Feature-Schwerpunkte verwendet.
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 Geometrietyp des zentralen Ausgabe-Features muss mit dem Typ der Eingabe-Features identisch sein.
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 diese Features nicht in der Analyse verwendet.
Neben den Feldern aus dem Eingabe-Layer enthält das Ergebnis des Parameters Zentrales Ausgabe-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.
date
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.
start_date
Wenn für den Eingabe-Layer Zeiteigenschaften mit dem Zeittyp "Intervall" aktiviert wurden, enthält das Ausgabeergebnis ein Feld für das Startdatum, in dem die Startzeit des Ausgabe-Features angegeben wird.
end_date
Wenn für den Eingabe-Layer Zeiteigenschaften mit dem Zeittyp "Intervall" aktiviert wurden, enthält das Ausgabeergebnis ein Feld für das Enddatum, in dem die Endzeit des Ausgabe-Features angegeben wird.
Zusätzlich zu dem optionalen Parameterwert Nach Feld gruppieren, der in der Analyse verwendet wird, enthalten die Ergebnisse der Parameter Mittelwert-Ausgabe für Mittelpunkt und Medianwert-Ausgabe 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.
date
Wenn für den Eingabe-Layer Zeiteigenschaften aktiviert wurden, enthält das Ausgabeergebnis ein Feld für das Datum des Zeitpunkts, in dem die durchschnittliche Zeit oder Medianzeit des Eingabe-Features angegeben wird. Dies gilt für Eingabe-Layer sowohl mit dem Typ "Intervall" als auch "Zeitpunkt".
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. Die Rotation wird in den Einheiten des Raumbezugs der Eingabe gemessen. Zum Beispiel könnte ein projiziertes Dataset in Metern und ein geographisches Dataset in Grad gemessen werden.
MajStdDist
Die Standardentfernung für die große Achse. Die Rotation wird in den Einheiten des Raumbezugs der Eingabe gemessen. Zum Beispiel könnte ein projiziertes Dataset mit projiziertem Raumbezug in Metern und ein Dataset mit geographischem Raumbezug in Grad gemessen werden.
MinStdDist
Die Standardentfernung für die kleine Achse. Die Rotation wird in den Einheiten des Raumbezugs der Eingabe gemessen. Zum Beispiel könnte ein projiziertes Dataset mit projiziertem Raumbezug in Metern und ein Dataset mit geographischem Raumbezug in Grad gemessen werden.
TmStdDist
Die zeitliche Standardentfernung. Dieser Wert ist eine Dauer, die in Millisekunden gemessen wird.
Alle Werte von Ausgabekoordinaten 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 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.
- Verwenden Sie bei größeren Datasets das Medianzentrum für den Parameter Typen generieren, da dieses aufgrund der iterativen Berechnungen möglicherweise der leistungsschwächste Zusammenfassungstyp ist.
Ähnliche Analysen können auch mit den folgenden Werkzeugen für räumliche Statistiken durchgeführt werden:
- Finden Sie das zentrale Feature mit dem Werkzeug Zentrales Feature.
- Berechnen Sie den Mittelwert mit dem Werkzeug Mittelwert für Mittelpunkt.
- Berechnen Sie das Medianzentrum mit dem Werkzeug Medianwert für Mittelpunkt.
- Berechnen Sie eine Ellipse mit dem Werkzeug Richtungsverteilung (Standardabweichungsellipse).
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
arcpy.gapro.SummarizeCenterAndDispersion(input_layer, out_central_feature, {out_mean_center}, {out_median_center}, {out_ellipse}, {ellipse_size}, {weight_field}, {group_by_field})
Name | Erläuterung | Datentyp |
input_layer | Der zusammenzufassende Punkt-, Linien- oder Polygon-Layer. | Feature Layer |
out_central_feature | Die Ausgabe-Feature-Class mit dem am zentralsten positionierten Feature im Eingabe-Layer. | Feature Class |
out_mean_center (optional) | Die Ausgabe-Point-Feature-Class mit den Features, welche die Mittelpunkte des Eingabe-Layers darstellen. | Feature Class |
out_median_center (optional) | Die Ausgabe-Point-Feature-Class mit den Features, welche die Medianzentren des Eingabe-Layers darstellen. | Feature Class |
out_ellipse (optional) | Die Ausgabe-Polygon-Feature-Class mit der richtungsbezogenen Ellipsendarstellung des Eingabe-Layers. | Feature Class |
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 |
Codebeispiel
Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug SummarizeCenterAndDispersion verwendet wird.
# Name: SummarizeCenterAndDispersion.py
# Description: Calculate the directionality and movement of fire occurrences
# over time. This sample calculates a mean center and a standard
# deviational ellipse.
# Requirements: ArcGIS Pro Advanced license
# Import system modules
import arcpy
# Set local variables
inFeatures = r"c:\data\MyBigDataConnection.bdc\fire_incidents"
outMeanCenter = r"c:\data\FireIncidents.gdb\fires_meancenter"
outEllipse = r"c:\data\FireIncidents.gdb\fires_ellipse"
# Execute SummarizeCenterAndDispersion
arcpy.gapro.SummarizeCenterAndDispersion(inFeatures, "", outMeanCenter, "",
outEllipse, "2_STANDARD_DEVIATIONS")
Umgebungen
Sonderfälle
Lizenzinformationen
- Basic: Nein
- Standard: Nein
- Advanced: Ja