Résumés statistiques de voisinage (Outils de statistiques spatiales)

Résumé

Calcule les résumés statistiques d’un ou plusieurs champs numériques en utilisant les voisinages locaux autour de chaque entité. Les statistiques locales incluent la moyenne, la médiane, l’écart type, l’écart interquartile, l’asymétrie et l’asymétrie par quantiles. Toutes les géographies peuvent être pondérées géographiquement en utilisant des noyaux pour accorder plus d’influence aux voisins situés plus près de l’entité focale. Il est possible d’utiliser plusieurs types de voisinage, notamment le canal de distance, le nombre de voisins, la contiguïté surfacique, la triangulation de Delaunay et les fichiers de matrice de pondérations spatiales (.swm). Les résumés statistiques sont également calculés pour les distances par rapport aux voisins de chaque entité.

Learn more about how Neighborhood Summary Statistics works

Illustration

Utilisation

En plus des champs d’analyse fournis, des statistiques basées sur les distances par rapport aux voisins sont calculées pour chaque entité. Cela vous permet de calculer, par exemple, la moyenne et l’écart type des distances par rapport à chaque voisin pour voir si les voisins sont généralement proches ou éloignés de l’entité focale. L’entité focale ne sera pas utilisée dans les calculs des statistiques de distance par rapport aux voisins puisque cette distance est toujours zéro. En outre, ces statistiques ne seront pas pondérées géographiquement puisque le fait de pondérer les valeurs de distance en fonction de ces mêmes distances n’est pas significatif.
Lorsque l’option Delaunay triangulation (Triangulation de Delaunay) est sélectionnée pour le paramètre Neighborhood Type (Type de voisinage), la classe d’entités en sortie est appelée carte de Voronoï.
Si les entités en entrée sont des polygones, toutes les distances entre les polygones sont définies en fonction des distances entre les centroïdes de polygones.
Les statistiques locales ne peuvent être pondérées géographiquement que si le paramètre Neighborhood Type (Type de voisinage) est défini sur Number of Neighbors (Nombre de voisins) ou Distance Band (Canal de distance) car les voisinages basés sur la contigüité surfacique ou la triangulation de Delaunay ne doivent pas être pondérés par la distance de centroïde à centroïde. Si Get spatial weights from file (Extraire les pondérations spatiales à partir du fichier) est spécifié pour le paramètre Neighborhood Type (Type de voisinage), les pondérations définies dans le fichier de pondérations spatiales sont automatiquement utilisées pour la pondération géographique.
Si l’environnement du système de coordonnées en sortie est défini sur un système de coordonnées géographiques utilisant des coordonnées de latitude et de longitude, toutes les distances sont calculées en utilisant la chordal distance. Dans le cas contraire, toutes les distances sont calculées en utilisant la distance en ligne droite (euclidienne).
Si vous choisissez d’ignorer les valeurs nulles en utilisant le paramètre Ignore Null Values in Calculations (Ignorer les valeurs nulles dans les calculs), les voisins ayant des valeurs nulles dans le champ d’analyse seront écartés après la recherche de voisins. Ceci peut réduire le nombre de voisins attendu, et si plusieurs champs d’analyse sont fournis, certains peuvent utiliser un nombre de voisins différents des autres. Ceci est particulièrement évident lorsque l’option Number of Neighbors (Nombre de voisins) est spécifiée pour le paramètre Neighborhood Type (Type de voisinage).
Les moyennes locales des champs d’analyse sont souvent appelées décalage spatiaux des champs.

Etiqueter	Explication	Type de données
Input Features (Entités en entrée)	Entités ponctuelles ou surfaciques qui serviront à calculer les statistiques locales.	Feature Layer
Entités en sortie	Classe d’entités en sortie contenant les statistiques locales en tant que champs. Chaque statistique de chaque champ d’analyse sera stockée sous forme de champ individuel.	Feature Class
Champs d’analyse (Facultatif)	Un ou plusieurs champs qui seront utilisés pour calculer les statistiques locales. Si aucun champ d’analyse n’est fourni, seules les statistiques locales basées sur les distances par rapport aux voisins seront calculées.	Field
Résumé statistique local (Facultatif)	Spécifie le résumé statistique local qui sera calculé pour chaque champ d’analyse. Tous—Toutes les statistiques locales seront calculées. Il s’agit de l’option par défaut. Moyenne—La moyenne locale sera calculée. Médiane—La médiane locale sera calculée. Écart type—L’écart type local sera calculé. Ecart interquartile—L’écart interquartile local sera calculé. Inclinaison—L’asymétrie locale sera calculée. Déséquilibre quantile—Le déséquilibre quantile local sera calculé.	String
Inclure l’entité focale dans le calcul (Facultatif)	Spécifie si l’entité focale sera prise en compte lors du calcul des statistiques locales pour chaque entité. Activé—L’entité focale et tous ses voisins seront pris en compte lors du calcul des statistiques locales. Il s’agit de l’option par défaut. Décoché—L’entité focale ne sera pas prise en compte lors du calcul des statistiques locales. Seuls les voisins de l’entité seront pris en compte.	Boolean
Ignorer les valeurs nulles dans le calcul (Facultatif)	Spécifie si les valeurs nulles des champs d’analyse seront prises en compte ou ignorées dans le calcul. Activé—Les valeurs nulles seront ignorées dans les calculs locaux. Décoché—Les valeurs nulles sont prises en compte dans les calculs locaux.	Boolean
Type de voisinage (Facultatif)	Indique quelles entités seront incluses en tant que voisines. Pour calculer les statistiques locales, les entités voisines doivent être identifiées pour chaque entité en entrée, et ces voisins sont utilisés pour calculer les statistiques locales pour chaque entité. L’option Delaunay triangulation (Triangulation de Delaunay) n’est disponible qu’avec une licence Desktop Advanced. Canal de distance—Les entités qui se trouvent à une distance critique donnée de chaque entité seront incluses comme voisines. Nombre de voisins—Les entités les plus proches seront incluses en tant que voisines. Tronçons de contiguïté uniquement—Les entités surfaciques qui partagent un segment seront incluses en tant que voisines. Angles des tronçons de contiguïté—Les entités surfaciques qui partagent un segment ou un angle seront incluses en tant que voisines. Il s’agit de la valeur par défaut pour les entités surfaciques. triangulation de Delaunay—Les entités dont la triangulation de Delaunay partage un segment seront incluses en tant que voisines. Il s’agit de la valeur par défaut pour les entités ponctuelles. Extraire les pondérations spatiales à partir du fichier—Les voisins et pondérations sont définis par un fichier de pondérations spatiales spécifié.	String
Canal de distance (Facultatif)	Toutes les entités comprises dans cette distance sont incluses comme voisins. Si aucune valeur n’est spécifiée, une valeur est estimée lors du traitement et incluse comme message de géotraitement. Si la distance spécifiée génère plus de 1 000 voisins, seules les 1 000 entités les plus proches seront incluses en tant que voisines.	Linear Unit
Nombre de voisins (Facultatif)	Le nombre de voisins qui seront inclus pour chaque calcul local. Le nombre n’inclut pas l’entité focale. Si l’entité focale est comprise dans le calcul, un voisin supplémentaire sera utilisé. La valeur par défaut est 8.	Long
Fichier de matrice de pondérations (Facultatif)	Chemin d’accès et nom du fichier de matrice de pondérations spatiales définissant les relations spatiales, et potentiellement les relations temporelles, entre des entités.	File
Schéma de pondération local (Facultatif)	Indique le schéma de pondération appliqué aux voisins lors du calcul des statistiques locales. Non pondéré—Les voisins ne sont pas pondérés. Il s’agit de l’option par défaut. Bicarré—Les voisins sont pondérés via une structure de noyau bicarré. Gaussien—Les voisins sont pondérés via une structure de noyau Gaussien.	String
Bande passante du noyau (Facultatif)	Largeur de bande des schémas de pondération locaux Bicarré ou Gaussien. Si aucune valeur n’est spécifiée, une valeur est estimée lors du traitement et incluse comme message de géotraitement.	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})

Nom	Explication	Type de données
in_features	Entités ponctuelles ou surfaciques qui serviront à calculer les statistiques locales.	Feature Layer
output_features	Classe d’entités en sortie contenant les statistiques locales en tant que champs. Chaque statistique de chaque champ d’analyse sera stockée sous forme de champ individuel.	Feature Class
analysis_fields [analysis_fields,...] (Facultatif)	Un ou plusieurs champs qui seront utilisés pour calculer les statistiques locales. Si aucun champ d’analyse n’est fourni, seules les statistiques locales basées sur les distances par rapport aux voisins seront calculées.	Field
local_summary_statistic (Facultatif)	Spécifie le résumé statistique local qui sera calculé pour chaque champ d’analyse. `ALL`—Toutes les statistiques locales seront calculées. Il s’agit de l’option par défaut. `MEAN`—La moyenne locale sera calculée. `MEDIAN`—La médiane locale sera calculée. `STD_DEV`—L’écart type local sera calculé. `IQR`—L’écart interquartile local sera calculé. `SKEWNESS`—L’asymétrie locale sera calculée. `QUANTILE_IMBALANCE`—Le déséquilibre quantile local sera calculé.	String
include_focal_feature (Facultatif)	Spécifie si l’entité focale sera prise en compte lors du calcul des statistiques locales pour chaque entité. `INCLUDE_FOCAL`—L’entité focale et tous ses voisins seront pris en compte lors du calcul des statistiques locales. Il s’agit de l’option par défaut. `EXCLUDE_FOCAL`—L’entité focale ne sera pas prise en compte lors du calcul des statistiques locales. Seuls les voisins de l’entité seront pris en compte.	Boolean
ignore_nulls (Facultatif)	Spécifie si les valeurs nulles des champs d’analyse seront prises en compte ou ignorées dans le calcul. `IGNORE_NULLS`—Les valeurs nulles seront ignorées dans les calculs locaux. `INCLUDE_NULLS`—Les valeurs nulles sont prises en compte dans les calculs locaux.	Boolean
neighborhood_type (Facultatif)	Indique quelles entités seront incluses en tant que voisines. Pour calculer les statistiques locales, les entités voisines doivent être identifiées pour chaque entité en entrée, et ces voisins sont utilisés pour calculer les statistiques locales pour chaque entité. L’option Delaunay triangulation (Triangulation de Delaunay) n’est disponible qu’avec une licence Desktop Advanced. `DISTANCE_BAND`—Les entités qui se trouvent à une distance critique donnée de chaque entité seront incluses comme voisines. `NUMBER_OF_NEIGHBORS`—Les entités les plus proches seront incluses en tant que voisines. `CONTIGUITY_EDGES_ONLY`—Les entités surfaciques qui partagent un segment seront incluses en tant que voisines. `CONTIGUITY_EDGES_CORNERS`—Les entités surfaciques qui partagent un segment ou un angle seront incluses en tant que voisines. Il s’agit de la valeur par défaut pour les entités surfaciques. `DELAUNAY_TRIANGULATION`—Les entités dont la triangulation de Delaunay partage un segment seront incluses en tant que voisines. Il s’agit de la valeur par défaut pour les entités ponctuelles. `GET_SPATIAL_WEIGHTS_FROM_FILE`—Les voisins et pondérations sont définis par un fichier de pondérations spatiales spécifié.	String
distance_band (Facultatif)	Toutes les entités comprises dans cette distance sont incluses comme voisins. Si aucune valeur n’est spécifiée, une valeur est estimée lors du traitement et incluse comme message de géotraitement. Si la distance spécifiée génère plus de 1 000 voisins, seules les 1 000 entités les plus proches seront incluses en tant que voisines.	Linear Unit
number_of_neighbors (Facultatif)	Le nombre de voisins qui seront inclus pour chaque calcul local. Le nombre n’inclut pas l’entité focale. Si l’entité focale est comprise dans le calcul, un voisin supplémentaire sera utilisé. La valeur par défaut est 8.	Long
weights_matrix_file (Facultatif)	Chemin d’accès et nom du fichier de matrice de pondérations spatiales définissant les relations spatiales, et potentiellement les relations temporelles, entre des entités.	File
local_weighting_scheme (Facultatif)	Indique le schéma de pondération appliqué aux voisins lors du calcul des statistiques locales. `UNWEIGHTED`—Les voisins ne sont pas pondérés. Il s’agit de l’option par défaut. `BISQUARE`—Les voisins sont pondérés via une structure de noyau bicarré. `GAUSSIAN`—Les voisins sont pondérés via une structure de noyau Gaussien.	String
kernel_bandwidth (Facultatif)	Largeur de bande des schémas de pondération locaux Bicarré ou Gaussien. Si aucune valeur n’est spécifiée, une valeur est estimée lors du traitement et incluse comme message de géotraitement.	Linear Unit

Exemple de code

NeighborhoodSummaryStatistics exemple 1 (fenêtre Python)

Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction NeighborhoodSummaryStatistics.

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 exemple 2 (script autonome)

Le script autonome ci-après illustre l’utilisation de la fonction NeighborhoodSummaryStatistics.

# 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")

Environnements

Système de coordonnées en sortie

Informations de licence

Basic: Limité
Une licence Advanced est requise pour utiliser le type de voisinage de la triangulation de Delaunay.
Standard: Limité
Une licence Advanced est requise pour utiliser le type de voisinage de la triangulation de Delaunay.
Advanced: Oui