Distance standard (Statistiques spatiales)

Synthèse

Mesure le degré auquel les entités sont concentrées ou dispersées autour du centre moyen géométrique.

Pour en savoir plus sur le fonctionnement de l'outil Distance standard

Illustration

Illustration de l'outil de distance standard

Utilisation

  • La distance standard est une statistique utile, puisqu'elle fournit une mesure synthétique unique de la distribution des entités autour de leur centre (de la même façon que l'écart type mesure la distribution des valeurs de données autour de la moyenne statistique).

  • L'outil Distance Standard permet de créer une nouvelle classe d'entités qui contient un polygone circulaire ou un multipatch sphérique centré sur la moyenne pour chaque cas. Le rayon de chaque polygone circulaire ou multipatch sphérique est égal à la distance standard. La valeur attributaire de chaque polygone circulaire ou multipatch sphérique est sa valeur de distance standard.

  • Cet outil respecte la nature 3D des données ponctuelles et utilise les valeurs x, y et z dans les calculs si les valeurs z sont disponibles. Comme ces résultats sont en 3D, vous devez les afficher dans une scène. Veillez à exécuter l'analyse dans une scène ou à copier la couche de résultats dans une scène pour afficher correctement les résultats de l'analyse.

  • Il est possible que votre résultat 3D prenne la forme d’un œuf au lieu de la sphère attendue. Les calculs, distances et volumes sont corrects, mais la distorsion est provoquée par l’exagération z lors de la visualisation du résultat. Vous pouvez ajuster le paramètre Vertical Exaggeration (Exagération verticale) sous l’onglet Elevation (Altitude) de la fenêtre Layer Properties (Propriétés de la couche).

  • Le paramètre Case Field (Champ de récapitulation) permet de regrouper des entités avant l’analyse. Lorsque le paramètre Case Field (Champ de récapitulation) est spécifié, les entités en entrée sont groupées en premier selon les valeurs du champ de récapitulation. Un cercle de distance standard est ensuite calculé pour chaque groupe. Le champ de récapitulation peut être un entier, une date ou un type de chaîne et apparaît sous forme d’attribut dans Output Standard Distance Feature Class (Classe d’entités de distance standard en sortie). Les enregistrements avec la valeur NULL pour le champ de récapitulation sont exclus de l'analyse.

  • Le calcul de la distance standard peut se fonder sur le paramètre Weight Field (Champ de pondération) facultatif (pour obtenir la distance standard d’entreprises pondérées par nombre d’employés, par exemple). Le champ de pondération doit être numérique.

  • Lorsque le modèle spatial sous-jacent des entités est concentré vers le centre avec un nombre réduit d’entités vers la périphérie (suivant une distribution Rayleigh), une taille de cercle d’un écart type recouvre approximativement 63 pour cent des entités, une taille de cercle de deux écarts types contient approximativement 98 pour cent des entités et une taille de cercle de trois écarts types recouvre approximativement 99 pour cent des entités en deux dimensions. En trois dimensions, la règle de pourcentage est 61-99-100.

  • Cet outil nécessite des données projetées pour mesurer précisément les distances.

  • 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.

  • Les couches peuvent permettre de définir la classe d'entités en entrée. Lorsque vous utilisez une couche avec une sélection, seules les entités sélectionnées sont comprises dans l'analyse.

  • Attention :

    Lorsque vous utilisez des shapefiles, n'oubliez pas qu'ils ne peuvent pas stocker de valeurs Null. Il se peut que des outils ou autres procédures qui créent des fichiers de formes à partir d'entrées autres que des fichiers de formes stockent ou interprètent des valeurs Null comme étant égales à zéro. Dans certains cas, les valeurs Null sont stockées sous forme de valeurs négatives très élevées dans les fichiers de formes. Cela peut aboutir à des résultats inattendus. Reportez-vous à la rubrique Remarques concernant le géotraitement pour la sortie de fichiers de formes pour plus d'informations.

Paramètres

ÉtiquetteExplicationType de données
Classe d'entités en entrée

Classe d'entités contenant une distribution d'entités pour lesquelles la distance standard est calculée.

Feature Layer
Classe d'entités de distance standard en sortie

Classe d'entités surfaciques qui contiendra un polygone circulaire pour chaque centre en entrée. Ces polygones circulaires représentent graphiquement la distance standard à chaque point central.

Feature Class
Taille du cercle

Taille des cercles en sortie dans les écarts types. La taille des cercles par défaut est 1 ; les choix possibles sont 1, 2 ou 3 écarts types.

  • 1 écart type1 écart type
  • 2 écarts types2 écarts types
  • 3 écarts types3 écarts types
String
Champ de pondération
(Facultatif)

Champ numérique permettant de pondérer les emplacements en fonction de leur importance relative.

Field
Champ de récapitulation
(Facultatif)

Champ permettant de grouper des entités pour des calculs de distance standard distincts. Ce champ de récapitulation peut être de type entier, date ou chaîne.

Field

arcpy.stats.StandardDistance(Input_Feature_Class, Output_Standard_Distance_Feature_Class, Circle_Size, {Weight_Field}, {Case_Field})
NomExplicationType de données
Input_Feature_Class

Classe d'entités contenant une distribution d'entités pour lesquelles la distance standard est calculée.

Feature Layer
Output_Standard_Distance_Feature_Class

Classe d'entités surfaciques qui contiendra un polygone circulaire pour chaque centre en entrée. Ces polygones circulaires représentent graphiquement la distance standard à chaque point central.

Feature Class
Circle_Size

Taille des cercles en sortie dans les écarts types. La taille des cercles par défaut est 1 ; les choix possibles sont 1, 2 ou 3 écarts types.

  • 1_STANDARD_DEVIATION1 écart type
  • 2_STANDARD_DEVIATIONS2 écarts types
  • 3_STANDARD_DEVIATIONS3 écarts types
String
Weight_Field
(Facultatif)

Champ numérique permettant de pondérer les emplacements en fonction de leur importance relative.

Field
Case_Field
(Facultatif)

Champ permettant de grouper des entités pour des calculs de distance standard distincts. Ce champ de récapitulation peut être de type entier, date ou chaîne.

Field

Exemple de code

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

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil StandardDistance.

import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.StandardDistance_stats("AutoTheft.shp", "auto_theft_SD.shp", "1_STANDARD_DEVIATION")
Exemple 2 d'utilisation de l'outil StandardDistance (script autonome)

Le script Python autonome ci-dessous illustre l'utilisation de l'outil StandardDistance.

# Measure the geographic distribution of auto thefts
 
# Import system modules
import arcpy
 
# Local variables...
workspace = "C:/data"
locations = "AutoTheft.shp"
links = "AutoTheft_links.shp"
standardDistance = "auto_theft_SD.shp"
stardardEllipse = "auto_theft_SE.shp"
linearDirectMean = "auto_theft_LDM.shp"
 
# Set the workspace (to avoid having to type in the full path to the data every time)
arcpy.env.workspace = workspace
 
# Process: Standard Distance of auto theft locations...
arcpy.StandardDistance_stats(locations, standardDistance, "1_STANDARD_DEVIATION")
 
# Process: Directional Distribution (Standard Deviational Ellipse) of auto theft locations...
arcpy.DirectionalDistribution_stats(locations, standardEllipse, "1_STANDARD_DEVIATION")
 
# Process: Linear Directional Mean of auto thefts...
arcpy.DirectionalMean_stats(links, linearDirectMean, "DIRECTION")

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.

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes