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 Neighbors (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.
L'outil Calculer la bande de distance à partir du nombre de voisins renvoie trois valeurs : Minimum, Moyenne et Distance minimale par rapport au voisin N. Les valeurs sont écrites sous forme de messages au bas de la fenêtre Géotraitement au cours de l'exécution de l'outil et sont transmises sous la forme de valeurs en sortie dérivées pour une utilisation éventuelle dans des modèles ou des scripts. Vous pouvez accéder aux messages en pointant sur la barre de progression, en cliquant sur le bouton contextuel ou en développant la section des messages dans la fenêtre Géotraitement. Vous pouvez également accéder aux messages d'un outil précédemment exécuté via l'historique du géotraitement.
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.
Attention :
Veillez à projeter les données si votre zone d'étude s'étend au-delà de 30 degrés. Les distances à la corde ne constituent pas une bonne estimation des distance géodésiques au-delà de 30 degrés.
-
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
arcpy.stats.CalculateDistanceBand(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 |
Sortie dérivée
| Nom | Explication | Type de données |
| Minimum_Distance | Distance minimale par rapport au voisin N. | Double |
| Average_Distance | Distance moyenne par rapport au voisin N. | Double |
| Maximum_Distance | Distance maximale par rapport au voisin N. | Double |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil CalculateDistanceBand.
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 CalculateDistanceBand.
# 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. Lorsque le système de coordonnées en sortie est exprimé en degrés, minutes et secondes, les distances géodésiques sont estimées à l'aide de distances à la corde.
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?