Nachbarschaftssummenstatistik (Spatial Statistics)

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

Der Durchschnittswert wird anhand der Nachbarn berechnet.
Der Mittelwert um das fokale Feature wird anhand der Nachbarn berechnet.

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.

Syntax

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})
ParameterErklärungDatentyp
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.

  • ALLEs werden alle lokalen Statistiken berechnet. Dies ist die Standardeinstellung.
  • MEANEs wird der lokale Mittelwert (Durchschnitt) berechnet.
  • MEDIAN Es wird der lokale Medianwert berechnet.
  • STD_DEVEs wird die lokale Standardabweichung berechnet.
  • IQR Es wird der lokale Interquartil-Bereich berechnet.
  • SKEWNESS Es wird die lokalen Schiefe berechnet.
  • QUANTILE_IMBALANCE Es wird das lokale Quantil-Ungleichgewicht berechnet.
String
include_focal_feature
(optional)

Gibt an, ob das fokale Feature in die Berechnung lokaler Statistiken für die einzelnen Features einbezogen wird.

  • INCLUDE_FOCALDas fokale Feature und alle seine Nachbarn werden in die Berechnung lokaler Statistiken einbezogen. Dies ist die Standardeinstellung.
  • EXCLUDE_FOCALDas fokale Feature wird nicht in die Berechnung lokaler Statistiken einbezogen. Nur Nachbarn des Features werden einbezogen.
Boolean
ignore_nulls
(optional)

Gibt an, ob NULL-Werte in den Analysefeldern in die Berechnungen einbezogen oder ignoriert werden.

  • IGNORE_NULLSNULL-Werte werden in den lokalen Berechnungen ignoriert.
  • INCLUDE_NULLSNULL-Werte werden in die lokalen Berechnungen einbezogen.
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.

  • DISTANCE_BANDFeatures innerhalb einer angegebenen kritischen Entfernung von jedem Feature werden als Nachbarn einbezogen.
  • NUMBER_OF_NEIGHBORS Die nächstgelegenen Features werden als Nachbarn einbezogen.
  • CONTIGUITY_EDGES_ONLY Polygon-Features, die eine Kante gemeinsam haben, werden als Nachbarn einbezogen.
  • CONTIGUITY_EDGES_CORNERS Polygon-Features, die eine Kante oder Ecke gemeinsam haben, werden als Nachbarn einbezogen. Hierbei handelt es sich um den Standard für Polygon-Features.
  • DELAUNAY_TRIANGULATIONFeatures, deren Delaunay-Triangulationen eine gemeinsame Kante haben, werden als Nachbarn einbezogen. Hierbei handelt es sich um den Standard für Punkt-Features.
  • GET_SPATIAL_WEIGHTS_FROM_FILE Nachbarn und Gewichtungen werden durch eine angegebene Datei mit räumlichen Gewichtungen definiert.
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.

  • UNWEIGHTEDNachbarn werden nicht gewichtet. Dies ist die Standardeinstellung.
  • BISQUARENachbarn werden nach dem Biquadrat-Kernel-Schema gewichtet.
  • GAUSSIANNachbarn werden nach dem Gauß'schen Kernel-Schema gewichtet.
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

NeighborhoodSummaryStatistics – Beispiel 1 (Python-Fenster)

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")
NeighborhoodSummaryStatistics – Beispiel 2 (eigenständiges Skript)

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

Verwandte Themen