Calculer la bande de distance à partir du nombre de voisins (Statistiques spatiales)
Récapitulatif
Renvoie les distances minimum, maximum et moyenne jusqu'au N-ième voisin le plus proche spécifié (N est un paramètre en entrée) pour un ensemble d'entités. Les résultats peuvent être consultés dans la fenêtre Résultats.
Illustration
 |
Utilisation
-
A partir d'un ensemble d'entités, cet outil renvoie trois chiffres : les distances minimum, maximum et moyenne jusqu'à un nombre spécifié de voisins (N). Exemple : si vous spécifiez 8 pour le paramètre Voisins, cet outil crée une liste de distances entre chaque entité et son huitième voisin le plus proche ; à partir de cette liste de distances il calcule ensuite les distances minimum, maximum et moyenne.
- La valeur maximale est la distance à parcourir depuis chaque entité pour garantir que chaque entité présente au moins N voisins.
- La valeur minimale est la distance à parcourir depuis chaque entité pour garantir qu'au moins une entité présente N voisins.
- La valeur moyenne est la distance moyenne à parcourir depuis chaque entité pour trouver ses N voisins les plus proches.
-
La sortie de cet outil est écrite en tant que message dans la Fenêtre de résultats. Cliquez avec le bouton droit de la souris sur l'entrée Messages et sélectionnez Afficher pour consulter les résultats dans une boîte de dialogue Message.
-
Certains outils, tels que Hot Spot Analysis (Getis-Ord Gi*) et Spatial Autocorrelation (Global Moran's I), permettent de spécifier une valeur Canal distance ou distance seuil pour le voisinage. En utilisant la valeur Distance maximale en sortie de cet outil pour le paramètre Canal distance ou distance seuil, vous garantissez que chaque entité de la classe d'entités en entrée présente au moins N voisins.
-
Cet outil fournit une stratégie pour la détermination d'une valeur Canal distance ou distance seuil à utiliser avec les outils de la boîte à outils Spatial Statistics, tels que Hot Spot Analysis (Getis-Ord Gi*) ou Cluster and Outlier Analysis (Local Moran's I). Reportez-vous à la rubrique Sélection d'une distance fixe pour connaître des stratégies supplémentaires.
-
Les distances renvoyées par cet outil figurent en unités du Système de coordonnées en sortie de l'environnement de géotraitement.
-
Les calculs basés sur la distance euclidienne ou la distance de Manhattan requièrent des données projetées afin de pouvoir mesurer les distances avec précision.
-
Pour les entités linéaires et surfaciques, les centroïdes d'entité sont utilisés dans les calculs de distance. Pour les multi-points, les polylignes ou les polygones comprenant plusieurs parties, le centroïde est calculé à l'aide du centre moyen pondéré de toutes les parties d'entité. La pondération pour les entités ponctuelles est de 1 ; pour les entités linéaires, elle correspond à la longueur et pour les entités surfaciques, à la superficie.
Syntaxe
| Paramètre | Explication | Type de données |
Input_Features |
Couche ou classe d'entités utilisée pour le calcul des statistiques de distance. | Feature Layer |
Neighbors |
Le nombre de voisins (N) à prendre en compte pour chaque entité. Ce nombre doit être un entier compris entre un et le nombre total d'entités figurant dans la classe. Une liste des distances entre chaque entité et son N-ième voisin est compilée, puis les distances maximale, minimale et moyenne sont renvoyées dans la Fenêtre de résultats. | Long |
Distance_Method |
Spécifie le mode de calcul des distances de chaque entité avec les entités voisines.
| String |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil CalculateDistanceBandfromNeighborCount.
import arcpy
arcpy.env.workspace = "c:/data"
mindist, avgdist, maxdist = arcpy.CalculateDistanceBand_stats("Blocks", 10, "EUCLIDEAN_DISTANCE")
Le script Python autonome ci-dessous illustre l'utilisation de l'outil CalculateDistanceBandfromNeighborCount.
# import module
import arcpy
# Set geoprocessing environment Workspace
arcpy.env.workspace = "c:/data"
# Set variables
infc = "Blocks"
field = "POP2000"
outfc = "PopHotSpots"
neighbors = 10
# Run the CalculateDistanceBand tool to get a distance for use with the Hot Spot tool from the tool result object
mindist, avgdist, maxdist = arcpy.CalculateDistanceBand_stats(infc, neighbors, "EUCLIDEAN_DISTANCE")
# Run the Hot Spot Analysis tool, using the maxdist output from the Calculate Distance Band tool as an input
arcpy.HotSpots_analysis(infc, field, outfc, "Fixed Distance Band", "EUCLIDEAN_DISTANCE", "None", maxdist)
Environnements
- Système de coordonnées en sortie
La géométrie de l'entité est projetée au système de coordonnées en sortie avant l'analyse. Tous les calculs mathématiques sont basés sur la référence spatiale du système de coordonnées en sortie.