Beschriftung | Erläuterung | Datentyp |
Eingabe-Features
| Die Punkt- oder Polygon-Features, mit denen die lokalen Statistiken berechnet werden. | Feature Layer |
Ausgabe-Features
| Die Ausgabe-Feature-Class mit den lokalen Statistiken als Feldern. Jede Statistik jedes Analysefeldes wird als einzelnes Feld gespeichert. | Feature Class |
Analysefelder
(optional) | Mindestens ein Feld, für das lokale Statistiken berechnet werden. Werden keine Analysefelder bereitgestellt, werden nur lokale Statistiken basierend auf Entfernungen zu Nachbarn berechnet. | Field |
Lokale Summenstatistiken
(optional) | Gibt die lokalen Summenstatistiken an, die für jedes Analysefeld berechnet werden.
| String |
Fokales Feature in Berechnungen einbeziehen
(optional) | Gibt an, ob das fokale Feature in die Berechnung lokaler Statistiken für die einzelnen Features einbezogen wird.
| Boolean |
NULL-Werte in Berechnungen ignorieren
(optional) | Gibt an, ob NULL-Werte in den Analysefeldern in die Berechnungen einbezogen oder ignoriert werden.
| Boolean |
Nachbarschaftstyp
(optional) | Gibt an, wie Nachbarn für die einzelnen Eingabe-Features ausgewählt werden. Zur Berechnung lokaler Statistiken müssen benachbarte Features für jedes Eingabe-Feature ermittelt werden. Diese Nachbarn werden in die Berechnung der lokalen Statistiken der einzelnen Features einbezogen. Die Standardeinstellung für Punkt-Features ist Delaunay-Triangulation. Die Standardeinstellung für Polygon-Features lautet Benachbarte Kanten/Ecken.
| String |
Entfernungsband
(optional) | Alle Features innerhalb dieser Entfernung werden als Nachbarn einbezogen. Wird kein Wert bereitgestellt, wird er während der Ausführung geschätzt und als Geoverarbeitungsmeldung einbezogen. Wenn die angegebene Distanz zu mehr als 1.000 Nachbarn führt, werden nur die 1.000 nächstgelegenen Features als Nachbarn einbezogen. | Linear Unit |
Anzahl der Nachbarn
(optional) | Die Anzahl der Nachbarn, die für jede lokale Berechnung einbezogen werden. Die Anzahl enthält nicht das fokale Feature. Wird das fokale Feature in Berechnungen einbezogen, wird ein zusätzlicher Nachbar verwendet. Der Standardwert ist 8. | Long |
Gewichtungsmatrix-Datei
(optional) | Der Pfad und Dateiname der Datei mit räumlicher Gewichtungsmatrix, die räumliche und möglicherweise zeitliche Beziehungen zwischen Features definiert. | File |
Lokales Gewichtungsschema
(optional) | Gibt das Gewichtungsschema an, das bei der Berechnung lokaler Statistiken auf Nachbarn angewendet werden muss.
| String |
Kernel-Bandbreite
(optional) | Die Bandbreite des Biquadrats oder der Gauß'schen lokalen Gewichtungsschemas. Wird kein Wert bereitgestellt, wird er während der Ausführung geschätzt und als Geoverarbeitungsmeldung einbezogen. | Linear Unit |
Zusammenfassung
Berechnet Summenstatistiken für mindestens ein numerisches Feld anhand der lokalen Nachbarschaften um jedes Feature. Die lokalen Statistiken enthalten den Mittelwert (Durchschnitt), den Medianwert, die Standardabweichung, den Interquartil-Bereich, die Schiefe sowie das Quantil-Ungleichgewicht. Alle Statistiken können geographisch mit Kernels gewichtet werden, um den Nachbarn in der Nähe des fokalen Features mehr Gewicht zu geben. Verschiedene Nachbarschaftstypen können verwendet werden, z. B. Entfernungsband, Anzahl der Nachbarn, Polygonnachbarschaft, Delaunay-Triangulation und Dateien mit räumlicher Gewichtungsmatrix (.swm). Summenstatistiken werden auch für die Entfernungen zu den Nachbarn jedes Features berechnet.
Weitere Informationen zur Funktionsweise von "Nachbarschaftssummenstatistik"
Abbildung
Verwendung
Zusätzlich zu den eventuell bereitgestellten Analysefeldern werden für jedes Feature Statistiken basierend auf Entfernungen zu Nachbarn berechnet. Auf diese Weise können Sie z. B. den Mittelwert und die Standardabweichung der Entfernungen zu jedem Nachbarn berechnen, um zu prüfen, ob die Nachbarn sich allgemein in der Nähe des fokalen Features befinden oder weit entfernt sind. Die Statistiken für die Entfernung zu Nachbarn verwenden in ihren Berechnungen nicht das fokale Feature, da diese Entfernung immer Null beträgt. Zudem werden diese Statistiken nicht geographisch gewichtet, weil die Gewichtung von Entfernungswerten basierend auf denselben Entfernungen nicht aussagekräftig ist.
Wenn die Option Delaunay-Triangulation als Nachbarschaftstyp ausgewählt wird, handelt es sich bei der Ausgabe-Feature-Class um eine Voronoi Map.
Sind die Eingabe-Features Polygone, werden alle Entfernungen zwischen Polygonen durch die Entfernungen zwischen den Polygon-Schwerpunkten definiert.
Die lokalen Statistiken können nur geographisch gewichtet werden, wenn der Parameter Nachbarschaftstyp auf Anzahl der Nachbarn oder Entfernungsband gesetzt ist, da auf Polygonnachbarschaft oder Delaunay-Triangulation basierende Nachbarschaften nicht nach der Entfernung zwischen Schwerpunkten gewichtet werden sollten. Wenn Räumliche Gewichtungen aus Datei abrufen für den Parameter Nachbarschaftstyp angegeben wird, werden automatisch die in der Datei mit den räumlichen Gewichtungen definierten Gewichtungen für die geographische Gewichtung verwendet.
Wenn für die Umgebung "Ausgabekoordinatensystem" ein geographisches Koordinatensystem mit Koordinaten für Breitengrad und Längengrad angegeben wird, werden alle Entfernungen mit der Sehnenentfernung berechnet. Andernfalls erfolgt die Berechnung aller Entfernungen mit einer geradlinigen (euklidischen) Entfernung.
Wenn Sie mit dem Parameter NULL-Werte in Berechnungen ignorieren angeben, dass NULL-Werte ignoriert werden sollen, werden Nachbarn mit NULL-Werten im Analysefeld nach der Suche nach Nachbarn herausgefiltert. Dies kann zu weniger Nachbarn als erwartet führen. Wenn mehrere Analysefelder bereitgestellt werden, verwenden einige möglicherweise eine andere Anzahl von Nachbarn als andere. Dies wird besonders deutlich, wenn die Option Anzahl der Nachbarn für den Parameter Nachbarschaftstyp angegeben wird.
Parameter
arcpy.stats.NeighborhoodSummaryStatistics(in_features, output_features, {analysis_fields}, {local_summary_statistic}, {include_focal_feature}, {ignore_nulls}, {neighborhood_type}, {distance_band}, {number_of_neighbors}, {weights_matrix_file}, {local_weighting_scheme}, {kernel_bandwidth})
Name | Erläuterung | Datentyp |
in_features | Die Punkt- oder Polygon-Features, mit denen die lokalen Statistiken berechnet werden. | Feature Layer |
output_features | Die Ausgabe-Feature-Class mit den lokalen Statistiken als Feldern. Jede Statistik jedes Analysefeldes wird als einzelnes Feld gespeichert. | Feature Class |
analysis_fields [analysis_fields,...] (optional) | Mindestens ein Feld, für das lokale Statistiken berechnet werden. Werden keine Analysefelder bereitgestellt, werden nur lokale Statistiken basierend auf Entfernungen zu Nachbarn berechnet. | Field |
local_summary_statistic (optional) | Gibt die lokalen Summenstatistiken an, die für jedes Analysefeld berechnet werden.
| String |
include_focal_feature (optional) | Gibt an, ob das fokale Feature in die Berechnung lokaler Statistiken für die einzelnen Features einbezogen wird.
| Boolean |
ignore_nulls (optional) | Gibt an, ob NULL-Werte in den Analysefeldern in die Berechnungen einbezogen oder ignoriert werden.
| Boolean |
neighborhood_type (optional) | Gibt an, wie Nachbarn für die einzelnen Eingabe-Features ausgewählt werden. Zur Berechnung lokaler Statistiken müssen benachbarte Features für jedes Eingabe-Feature ermittelt werden. Diese Nachbarn werden in die Berechnung der lokalen Statistiken der einzelnen Features einbezogen. Die Standardeinstellung für Punkt-Features ist Delaunay-Triangulation. Die Standardeinstellung für Polygon-Features lautet Benachbarte Kanten/Ecken.
| String |
distance_band (optional) | Alle Features innerhalb dieser Entfernung werden als Nachbarn einbezogen. Wird kein Wert bereitgestellt, wird er während der Ausführung geschätzt und als Geoverarbeitungsmeldung einbezogen. Wenn die angegebene Distanz zu mehr als 1.000 Nachbarn führt, werden nur die 1.000 nächstgelegenen Features als Nachbarn einbezogen. | Linear Unit |
number_of_neighbors (optional) | Die Anzahl der Nachbarn, die für jede lokale Berechnung einbezogen werden. Die Anzahl enthält nicht das fokale Feature. Wird das fokale Feature in Berechnungen einbezogen, wird ein zusätzlicher Nachbar verwendet. Der Standardwert ist 8. | Long |
weights_matrix_file (optional) | Der Pfad und Dateiname der Datei mit räumlicher Gewichtungsmatrix, die räumliche und möglicherweise zeitliche Beziehungen zwischen Features definiert. | File |
local_weighting_scheme (optional) | Gibt das Gewichtungsschema an, das bei der Berechnung lokaler Statistiken auf Nachbarn angewendet werden muss.
| String |
kernel_bandwidth (optional) | Die Bandbreite des Biquadrats oder der Gauß'schen lokalen Gewichtungsschemas. Wird kein Wert bereitgestellt, wird er während der Ausführung geschätzt und als Geoverarbeitungsmeldung einbezogen. | Linear Unit |
Codebeispiel
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs NeighborhoodSummaryStatistics im Python-Fenster.
import arcpy
arcpy.env.workspace = r"c:\data\project_data.gdb"
arcpy.stats.NeighborhoodSummaryStatistics("USCounties",
"USCounties_NeighborhoodSummaryStatistics", "POP2018;POP2019",
"ALL", "INCLUDE_FOCAL", "IGNORE_NULLS", "NUMBER_OF_NEIGHBORS", None,
8, None, "UNWEIGHTED")
Im folgenden eigenständigen Skript wird veranschaulicht, wie das Werkzeug NeighborhoodSummaryStatistics verwendet wird.
# Calculate a focal mean for the population and income of US cities.
import arcpy
# Set the current workspace
arcpy.env.workspace = r"c:\data\project_data.gdb"
# Calculate the local mean of POP2020 and MedIncome2020 fields
# using 8 nearest neighbors.
arcpy.stats.NeighborhoodSummaryStatistics("USCities", "USCities_Mean",
"POP2020;MedIncome2020", "MEAN", "EXCLUDE_FOCAL", "IGNORE_NULLS",
"NUMBER_OF_NEIGHBORS", None, 8, None, "GAUSSIAN", "50 Miles")
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja