Directional Distribution (Standard Deviational Ellipse) (Statistiques spatiales)
Récapitulatif
Crée des ellipses de l'écart type pour récapituler les caractéristiques spatiales d'entités géographiques : tendance centrale, dispersion et tendances directionnelles.
Illustration
![]() |
Utilisation
-
L'outil Standard Deviational Ellipse crée une Classe d'entités en sortie qui contient des polygones elliptiques, un pour chaque cas (paramètre Champ de récapitulation). Les valeurs attributaires pour ces polygones d'ellipse comprennent des coordonnées X et Y pour le centre moyen, deux distances standard (axe long et axe court) et l'orientation de l'ellipse. Les noms de champ sont CenterX, CenterY, XStdDist, YStdDist et Rotation. Lorsqu'un Champ de récapitulation est fourni, il est également ajouté à la Classe d'entités en sortie.
-
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.
-
Lorsque le modèle spatial sous-jacent des entités est concentré dans le centre avec un nombre réduit d'entités vers la périphérie (répartition normale spatiale), un polygone d'ellipse d'un écart type recouvre approximativement 68 pour cent des entités, deux écarts types contiennent approximativement 95 pour cent des entités et trois écarts types recouvrent approximativement 99 pour cent des entités dans l'agrégat.
-
La valeur dans le champ Rotation en sortie représente la rotation de l'axe long, mesurée dans le sens horaire à partir de midi.
-
Le Champ de récapitulation permet de regrouper des entités avant l'analyse. Lorsqu'un Champ de récapitulation est spécifié, les entités en entrée sont d'abord regroupées selon les valeurs du champ de récapitulation, puis une ellipse de l'écart type est calculée pour chaque groupe. Ce champ de récapitulation peut être de type entier, date ou chaîne. Les enregistrements avec la valeur NULL pour le champ de récapitulation sont exclus de l'analyse.
Le calcul de l'ellipse de l'écart type peut être basé sur un Champ de pondération facultatif (pour pondérer les ellipses des accidents de la circulation par gravité, par exemple). Le champ de pondération doit être numérique.
-
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. Lors de l'utilisation d'une couche avec une sélection, seules les entités sélectionnées sont incluses dans l'analyse.
![Attention Attention](rsrc/caution.png)
Lorsque vous utilisez des fichiers de formes, 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.
Syntaxe
Paramètre | Explication | Type de données |
Input_Feature_Class |
Classe d'entités contenant une répartition des entités pour laquelle l'ellipse de l'écart type doit être calculée. | Feature Layer |
Output_Ellipse_Feature_Class |
Classe d'entités surfaciques devant contenir l'entité ellipse en sortie. | Feature Class |
Ellipse_Size |
Taille des ellipses en sortie, mesurée en écarts types. La taille par défaut de l'ellipse est 1, les choix valides étant 1, 2, ou 3 é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 utilisé pour regrouper des entités pour différents calculs de répartition directionnelle. Ce champ de récapitulation peut être de type entier, date ou chaîne. | Field |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil DirectionalDistribution.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.DirectionalDistribution_stats("AutoTheft.shp", "auto_theft_SE.shp", "1_STANDARD_DEVIATION", "#", "#")
Le script Python autonome ci-dessous illustre l'utilisation de l'outil DirectionalDistribution.
# 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"
try:
# 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", "#")
except:
# If an error occurred while running a tool, print the messages
print arcpy.GetMessages()
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.