Calculer la bande de distance à partir du nombre de voisins (Statistiques spatiales)

Synthèse

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

Illustration de l’outil Calculer la bande de distance à partir du nombre de voisins

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.

  • 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, comme Analyse de point chaud (Getis-Ord Gi*) et Autocorrélation spatiale (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 Statistiques spatiales tels que Analyse de points chauds (Getis-Ord Gi*) ou Analyse des valeurs aberrantes et des agrégats (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.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Couche ou classe d'entités utilisée pour calculer les statistiques de distance.

Feature Layer
Voisins

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
Méthode de distance

Spécifie le mode de calcul des distances de chaque entité avec les entités voisines.

  • EuclidienDistance en ligne droite entre deux points (distance à vol d'oiseau).
  • ManhattanDistance entre deux points mesurée le long des axes à angle droit (bloc de bâtiments) ; calculée en totalisant la différence (absolue) entre les coordonnées x et y.
String

Sortie obtenue

ÉtiquetteExplicationType de données
Distance minimale

La distance minimale par rapport au voisin N.

Double
Distance moyenne

La distance moyenne par rapport au voisin N.

Double
Distance maximale

La distance maximale par rapport au voisin N.

Double

arcpy.stats.CalculateDistanceBand(Input_Features, Neighbors, Distance_Method)
NomExplicationType 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.

  • EUCLIDEAN_DISTANCEDistance en ligne droite entre deux points (distance à vol d'oiseau).
  • MANHATTAN_DISTANCEDistance entre deux points mesurée le long des axes à angle droit (bloc de bâtiments) ; calculée en totalisant la différence (absolue) entre les coordonnées x et y.
String

Sortie obtenue

NomExplicationType de données
Minimum_Distance

La distance minimale par rapport au voisin N.

Double
Average_Distance

La distance moyenne par rapport au voisin N.

Double
Maximum_Distance

La distance maximale par rapport au voisin N.

Double

Exemple de code

Exemple 1 d’utilisation de l’outil CalculateDistanceBand (fenêtre Python)

Le script ci-dessous pour la fenêtre Python Windows illustre l’utilisation de la fonction CalculateDistanceBand.

import arcpy
arcpy.env.workspace = "c:/data"
mindist, avgdist, maxdist = arcpy.stats.CalculateDistanceBand("Blocks", 10, "EUCLIDEAN_DISTANCE")
Exemple 2 de l’outil CalculateDistanceBand (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de la fonction CalculateDistanceBand.

# import module
import arcpy

# Set geoprocessing workspace environment
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.stats.CalculateDistanceBand(infc, neighbors, 
                                                              "EUCLIDEAN_DISTANCE")
 
# Run the Hot Spot Analysis tool, using the maxdist output from the Calculate 
# Distance Band tool as an input
arcpy.stats.HotSpots(infc, field, outfc, "Fixed Distance Band", 
                        "EUCLIDEAN_DISTANCE", "None", maxdist)

Environnements

Cas particuliers

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.