Nachbarschaftssummenstatistik (Spatial Statistics)

Zusammenfassung

Berechnet Summenstatistiken für mindestens ein numerisches Feld anhand der lokalen Nachbarschaften um jedes Feature. Zu den lokalen Statistiken gehören Mittelwert (Durchschnitt), Medianwert, Standardabweichung, Interquartil-Bereich, Schiefe und Quantil-Ungleichheit. 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

Abbildung des Werkzeugs "Nachbarschaftssummenstatistik"
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.

Parameter

BeschriftungErläuterungDatentyp
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.

  • AlleEs werden alle lokalen Statistiken berechnet. Dies ist die Standardeinstellung.
  • MittelwertEs wird der lokale Mittelwert (Durchschnitt) berechnet.
  • MedianwertEs wird der lokale Medianwert berechnet.
  • StandardabweichungEs wird die lokale Standardabweichung berechnet.
  • Interquartil-BereichEs wird der lokale Interquartil-Bereich berechnet.
  • SchiefeEs wird die lokalen Schiefe berechnet.
  • Quantil-UngleichgewichtEs wird das lokale Quantil-Ungleichgewicht berechnet.
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.

  • Aktiviert: Das fokale Feature und alle seine Nachbarn werden in die Berechnung lokaler Statistiken einbezogen. Dies ist die Standardeinstellung.
  • Deaktiviert: Das fokale Feature wird nicht in die Berechnung lokaler Statistiken einbezogen. Nur Nachbarn des Features werden einbezogen.

Boolean
NULL-Werte in Berechnungen ignorieren
(optional)

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

  • Aktiviert: NULL-Werte in den Analysefeldern werden ignoriert, und Statistiken werden nur mit Nicht-NULL-Werten berechnet. Dies ist die Standardeinstellung.
  • Deaktiviert: NULL-Werte in den Analysefeldern werden in die Berechnungen einbezogen, und lokale Statistiken werden als Null berechnet, wenn einer der in der Berechnung verwendeten Werte Null ist.

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.

Die Option Delaunay-Triangulation ist nur mit einer Desktop Advanced-Lizenz verfügbar.

  • EntfernungsbandFeatures innerhalb einer angegebenen kritischen Entfernung von jedem Feature werden als Nachbarn einbezogen.
  • Anzahl der NachbarnDie nächstgelegenen Features werden als Nachbarn einbezogen.
  • Nur benachbarte KantenPolygon-Features, die eine Kante gemeinsam haben, werden als Nachbarn einbezogen.
  • Benachbarte Kanten/EckenPolygon-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.
  • Räumliche Gewichtungen aus Datei abrufenNachbarn und Gewichtungen werden durch eine angegebene Datei mit räumlichen Gewichtungen definiert.
String
Entfernungsband
(optional)

Alle Features innerhalb dieser Entfernung werden als Nachbarn einbezogen. Wird kein Wert bereitgestellt, wird er während der Verarbeitung 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 wird.

  • UngewichtetNachbarn werden nicht gewichtet. Dies ist die Standardeinstellung.
  • BiquadratNachbarn werden nach dem Biquadrat-Kernel-Schema gewichtet.
  • GaußNachbarn werden nach dem Gauß'schen Kernel-Schema gewichtet.
String
Kernel-Bandbreite
(optional)

Die Bandbreite des Biquadrats oder der Gauß'schen lokalen Gewichtungsschemas. Wird kein Wert bereitgestellt, wird er während der Verarbeitung geschätzt und als Geoverarbeitungsmeldung einbezogen.

Linear Unit

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})
NameErläuterungDatentyp
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.
  • MEDIANEs wird der lokale Medianwert berechnet.
  • STD_DEVEs wird die lokale Standardabweichung berechnet.
  • IQREs wird der lokale Interquartil-Bereich berechnet.
  • SKEWNESSEs wird die lokalen Schiefe berechnet.
  • QUANTILE_IMBALANCEEs 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.

Die Option Delaunay-Triangulation ist nur mit einer Desktop Advanced-Lizenz verfügbar.

  • DISTANCE_BANDFeatures innerhalb einer angegebenen kritischen Entfernung von jedem Feature werden als Nachbarn einbezogen.
  • NUMBER_OF_NEIGHBORSDie nächstgelegenen Features werden als Nachbarn einbezogen.
  • CONTIGUITY_EDGES_ONLYPolygon-Features, die eine Kante gemeinsam haben, werden als Nachbarn einbezogen.
  • CONTIGUITY_EDGES_CORNERSPolygon-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_FILENachbarn 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 Verarbeitung 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 wird.

  • 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 Verarbeitung 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: Begrenzt
  • Standard: Begrenzt
  • Advanced: Ja

Verwandte Themen