Nachbarschaftssummenstatistik (Spatial Statistics Tools)

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

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 angegeben 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 "Ausgabe-Koordinatensystem" 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.
Lokale Mittelwerte von Analysefeldern werden in der Regel als räumliche Entfernungsstufen der Felder bezeichnet.

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)	Ein oder mehrere Felder, die für die Berechnung der lokalen Statistiken verwendet 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. Alle—Es werden alle lokalen Statistiken berechnet. Dies ist die Standardeinstellung. Mittelwert—Es wird der lokale Mittelwert (Durchschnitt) berechnet. Medianwert—Es wird der lokale Medianwert berechnet. Standardabweichung—Es wird die lokale Standardabweichung berechnet. Interquartil-Bereich—Es wird der lokale Interquartil-Bereich berechnet. Schiefe—Es wird die lokalen Schiefe berechnet. Quantil-Ungleichgewicht—Es 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 werden in den lokalen Berechnungen ignoriert. Deaktiviert—NULL-Werte werden in die lokalen Berechnungen einbezogen.	Boolean
Nachbarschaftstyp (Optional)	Gibt an, welche Features als Nachbarn einbezogen 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 Option Delaunay-Triangulation ist nur mit einer Desktop Advanced-Lizenz verfügbar. Entfernungsband—Features innerhalb einer angegebenen kritischen Entfernung von jedem Feature werden als Nachbarn einbezogen. Anzahl der Nachbarn—Die nächstgelegenen Features werden als Nachbarn einbezogen. Nur Kontiguitätskanten—Polygon-Features, die eine Kante gemeinsam haben, werden als Nachbarn einbezogen. Kontiguitätsecken und -kanten—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-Triangulation—Features, 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 abrufen—Nachbarn und Gewichtungen werden durch eine angegebene Datei mit räumlichen Gewichtungen definiert.	String
Entfernungsband (Optional)	Alle Features innerhalb dieser Entfernung werden als Nachbarn aufgenommen. Wenn kein Wert angegeben wird, wird dieser während der Verarbeitung geschätzt und als Geoverarbeitungsmeldung aufgenommen. 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. Die Standardeinstellung 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 der lokalen Statistiken auf die Nachbarn angewendet wird. Ungewichtet—Nachbarn werden nicht gewichtet. Dies ist die Standardeinstellung. Biquadrat—Nachbarn werden unter Verwendung eines Biquadrat-Kernel-Schemas gewichtet. Gauß—Nachbarn werden mit einem Gaußschen Kernel-Schema gewichtet.	String
Kernel-Bandbreite (Optional)	Die Bandbreite der Biquadrat- oder lokalen Gaußschen Gewichtungsschemas. Wenn kein Wert angegeben wird, wird dieser während der Verarbeitung geschätzt und als Geoverarbeitungsmeldung aufgenommen.	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})

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)	Ein oder mehrere Felder, die für die Berechnung der lokalen Statistiken verwendet 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. `ALL`—Es werden alle lokalen Statistiken berechnet. Dies ist die Standardeinstellung. `MEAN`—Es wird der lokale Mittelwert (Durchschnitt) berechnet. `MEDIAN`—Es wird der lokale Medianwert berechnet. `STD_DEV`—Es 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_FOCAL`—Das fokale Feature und alle seine Nachbarn werden in die Berechnung lokaler Statistiken einbezogen. Dies ist die Standardeinstellung. `EXCLUDE_FOCAL`—Das 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_NULLS`—NULL-Werte werden in den lokalen Berechnungen ignoriert. `INCLUDE_NULLS`—NULL-Werte werden in die lokalen Berechnungen einbezogen.	Boolean
neighborhood_type (Optional)	Gibt an, welche Features als Nachbarn einbezogen 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 Option Delaunay-Triangulation ist nur mit einer Desktop Advanced-Lizenz verfügbar. `DISTANCE_BAND`—Features 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_TRIANGULATION`—Features, 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 aufgenommen. Wenn kein Wert angegeben wird, wird dieser während der Verarbeitung geschätzt und als Geoverarbeitungsmeldung aufgenommen. 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. Die Standardeinstellung 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 der lokalen Statistiken auf die Nachbarn angewendet wird. `UNWEIGHTED`—Nachbarn werden nicht gewichtet. Dies ist die Standardeinstellung. `BISQUARE`—Nachbarn werden unter Verwendung eines Biquadrat-Kernel-Schemas gewichtet. `GAUSSIAN`—Nachbarn werden mit einem Gaußschen Kernel-Schema gewichtet.	String
kernel_bandwidth (Optional)	Die Bandbreite der Biquadrat- oder lokalen Gaußschen Gewichtungsschemas. Wenn kein Wert angegeben wird, wird dieser während der Verarbeitung geschätzt und als Geoverarbeitungsmeldung aufgenommen.	Linear Unit

Codebeispiel

NeighborhoodSummaryStatistics Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion NeighborhoodSummaryStatistics verwenden.

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)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion 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")

Umgebungen

Ausgabe-Koordinatensystem

Lizenzierungsinformationen

Basic: Eingeschränkt
Für die Verwendung des Nachbarschaftstyps "Delaunay-Triangulation" ist eine Advanced-Lizenz erforderlich.
Standard: Eingeschränkt
Für die Verwendung des Nachbarschaftstyps "Delaunay-Triangulation" ist eine Advanced-Lizenz erforderlich.
Advanced: Ja