Résumé
Retourne la distance minimale, maximale et moyenne par rapport au énième voisin le plus proche spécifié (N est un paramètre en entrée) d'un ensemble d'entités. Les résultats sont écrits sous forme de messages d'exécution de l'outil.
Illustration
Utilisation
Pour un ensemble d'entités, cet outil retourne trois nombres : la distance minimale, maximale et moyenne par rapport à un nombre (N) de voisins spécifié. Exemple : si vous spécifiez 8 comme paramètre Voisins , cet outil crée une liste de distances entre chaque entité et son huitième voisin, puis, à partir de cette liste il calcule la distance minimale, maximale et moyenne.
- La valeur maximale est la distance à parcourir pour s'éloigner de chaque entité, afin de s'assurer que chaque entité possède au moins N voisins.
- La valeur minimale est la distance à parcourir pour s'éloigner de chaque entité, afin de s'assurer qu'au moins une entité possède au moins N voisins.
- La valeur moyenne est la distance moyenne à parcourir pour s'éloigner de chaque entité, afin de trouver ses N voisins les plus proches.
La sortie de cet outil est écrite sous la forme de messages dans la fenêtre Résultats. Cliquez avec le bouton droit 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 de voisinage Canal distance ou distance seuil. En utilisant la valeur en sortie Distance maximale de cet outil pour le paramètre Canal distance ou distance seuil, vous vous assurez que chaque entité dans la classe d'entités en entrée possède au moins N voisins.
Cet outil offre une stratégie pour déterminer une valeur Canal distance ou distance seuil à utiliser avec les outils contenus dans la boîte à outils Spatial Statistics, Analyse de points chauds (Getis-Ord Gi*) ou Analyse de grappes et de valeurs aberrantes (Anselin Local Moran's I). Reportez-vous à la rubrique Sélection d'une distance fixe pour découvrir d'autres stratégies.
Les distances renvoyées par cet outil sont exprimées dans les unités de l'environnement de géotraitement Système de coordonnées en sortie.
Lorsque la Classe d'entités en entrée n'est pas projetée (c'est-à-dire, lorsque les coordonnées sont exprimées en degrés, minutes et secondes) ou lorsque le système de coordonnées en sortie est un Système de coordonnées géographiques, les distances sont calculées à l'aide des mesures à la corde. Les mesures de distance à la corde permettent de calculer rapidement et de fournir une bonne estimation de distance géodésiques réelles, du moins pour les points situés à environ trente degrés les uns des autres. Les distances de corde reposent sur un sphéroïde aplati. Si l'on prend deux points sur la surface de la Terre, la distance de corde qui les sépare est la longueur d'une ligne qui traverse la Terre en trois dimensions pour relier ces deux points. Les distances à la corde sont exprimées en mètres.
-
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
CalculateDistanceBand_stats (Input_Features, Neighbors, Distance_Method)
| Paramètre | Explication | Type de données |
Input_Features | Couche ou classe d'entités utilisée pour calculer les statistiques de distance. | Feature Layer |
Neighbors | 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 énième voisin est compilée, puis les distances maximale, minimale et moyenne sont renvoyées en sortie à 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
Exemple d'utilisation de l'outil Calculer la bande de distance à partir du nombre de voisins (fenêtre Python)
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil Calculer la bande de distance à partir du nombre de voisins.
import arcpy
arcpy.env.workspace = "c:/data"
mindist, avgdist, maxdist = arcpy.CalculateDistanceBand_stats("Blocks", 10, "EUCLIDEAN_DISTANCE")
Exemple d'utilisation de l'outil Calculer la bande de distance à partir du nombre de voisins (script Python autonome)
Le script Python autonome suivant illustre l'utilisation de l'outil Calculer la bande de distance à partir du nombre de voisins.
# 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
Informations de licence
- ArcGIS Desktop Basic: Oui
- ArcGIS Desktop Standard: Oui
- ArcGIS Desktop Advanced: Oui