Distribution directionnelle (ellipse de l’écart type) (Outils de statistiques spatiales)

Résumé

Crée des ellipses d'écart type ou des ellipsoïdes pour récapituler les caractéristiques spatiales d'entités géographiques : tendance centrale, dispersion et tendances directionnelles.

En savoir plus sur le fonctionnement de l’outil Distribution directionnelle (ellipse de l’écart type)

Illustration

Illustration de l’outil Distribution directionnelle (ellipse de l’écart type)

Utilisation

Cet outil crée des polygones elliptiques ou des multipatchs ellipsoïdaux 3D, un pour chaque cas si le paramètre Case Field (Champ de récapitulation) est spécifié. Les valeurs attributaires pour ces polygones elliptiques 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. Lorsque des données ponctuelles de type z sont utilisées, les valeurs attributaires incluent également la coordonnée z du centre moyen, une troisième distance standard (hauteur) et des mesures d’orientation de l’ellipsoïde. Si les entités en entrée sont en 2D, les noms de champ sont CenterX, CenterY, XStdDist, YStdDist et Rotation. Si les entités en entrée sont des points 3D, les champs supplémentaires suivants sont également ajoutés à la sortie : CenterZ, ZStdDist, AngleZ, TiltX, RollY et Volume. Lorsqu’une valeur du paramètre Case Field (Champ de récapitulation) est fournie, ce champ est également ajouté la sortie.
Cet outil respecte la nature 3D des données ponctuelles et utilise les valeurs x, y et z dans ses calculs si les valeurs z sont disponibles. Comme ces résultats sont en 3D par nature, vous devez les afficher dans une scène. Veillez à exécuter l’analyse dans une scène ou à copier la couche de résultat dans une scène pour afficher correctement les résultats d’analyse.
Les calculs requièrent des données projetées pour mesurer précisément les distances.
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 gaussienne spatiale), un polygone d’ellipse d’écart type couvre approximativement 68 pour cent des entités, deux écarts types couvrent approximativement 95 pour cent des entités et trois écarts types couvrent approximativement 99 pour cent des entités.
Si les données en entrée sont de type z, les valeurs des champs AngleZ, TiltX et RollY en sortie sont des angles d’Euler et décrivent l’orientation de l’ellipsoïde dans l’espace 3D. Si les données ne sont pas de type z, 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.
L’outil Calculer des attributs géométriques permet de consulter les coordonnées x, y et z des données.
Le paramètre Case Field (Champ de récapitulation) permet de regrouper des entités avant l’analyse. Lorsque la valeur du paramètre Case Field (Champ de récapitulation) est spécifiée, les entités en entrée sont regroupées en premier selon les valeurs du champ de récapitulation. Une ellipse ou un ellipsoïde d’écart type est ensuite calculé pour chaque groupe. Ce champ de récapitulation peut être de type entier, date ou chaîne. Les enregistrements dont la valeur du paramètre Case Field (Champ de récapitulation) est NULL sont exclus de l’analyse.
Le calcul de l’ellipse ou de l’ellipsoïde de l’écart type peut être basé sur le paramètre Weight Field (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 de carte peuvent être utilisées pour définir Input Feature Class (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, gardez à l’esprit qu’ils ne peuvent pas stocker de valeurs nulles. 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 des shapefiles pour plus d’informations.

Etiqueter	Explication	Type de données
Classe d’entités en entrée	Classe d'entités contenant une répartition des entités pour laquelle l'ellipse d'écart type ou l'ellipsoïde doit être calculé.	Feature Layer
Classe d’entités d’ellipse en sortie	Classe d'entités surfaciques devant contenir l'entité ellipse en sortie.	Feature Class
Taille de l'ellipse	Spécifie la taille des ellipses en sortie en écarts types. 1 écart type—La taille des ellipses en sortie sera d’un écart type. Il s’agit de l’option par défaut. 2 écarts types—La taille des ellipses en sortie sera de deux écarts types. 3 écarts types—La taille des ellipses en sortie sera de trois écarts types.	String
Champ de pondération (Facultatif)	Champ numérique qui permettra de pondérer les localisations en fonction de leur importance relative.	Field
Champ de récapitulation (Facultatif)	Champ qui sera utilisé pour regrouper des entités pour différents calculs de distribution directionnelle. Ce champ de récapitulation peut être de type entier, date ou chaîne.	Field

arcpy.stats.DirectionalDistribution(Input_Feature_Class, Output_Ellipse_Feature_Class, Ellipse_Size, {Weight_Field}, {Case_Field})

Nom	Explication	Type de données
Input_Feature_Class	Classe d'entités contenant une répartition des entités pour laquelle l'ellipse d'écart type ou l'ellipsoïde doit être calculé.	Feature Layer
Output_Ellipse_Feature_Class	Classe d'entités surfaciques devant contenir l'entité ellipse en sortie.	Feature Class
Ellipse_Size	Spécifie la taille des ellipses en sortie en écarts types. `1_STANDARD_DEVIATION`—La taille des ellipses en sortie sera d’un écart type. Il s’agit de l’option par défaut. `2_STANDARD_DEVIATIONS`—La taille des ellipses en sortie sera de deux écarts types. `3_STANDARD_DEVIATIONS`—La taille des ellipses en sortie sera de trois écarts types.	String
Weight_Field (Facultatif)	Champ numérique qui permettra de pondérer les localisations en fonction de leur importance relative.	Field
Case_Field (Facultatif)	Champ qui sera utilisé pour regrouper des entités pour différents calculs de distribution directionnelle. Ce champ de récapitulation peut être de type entier, date ou chaîne.	Field

Exemple de code

DirectionalDistribution Exemple (fenêtre Python)

Le script de la fenêtre Python ci-après illustre l’utilisation de la fonction DirectionalDistribution.

import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.stats.DirectionalDistribution("AutoTheft.shp", "auto_theft_SE.shp",
                                    "1_STANDARD_DEVIATION")

DirectionalDistribution Exemple 2 (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de la fonction 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"

# 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.stats.StandardDistance(locations, standardDistance, "1_STANDARD_DEVIATION")

# Process: Directional Distribution (Standard Deviational Ellipse) of auto theft
# locations.
arcpy.stats.DirectionalDistribution(locations, standardEllipse,
                                    "1_STANDARD_DEVIATION")

# Process: Linear Directional Mean of auto thefts.
arcpy.stats.DirectionalMean(links, linearDirectMean, "DIRECTION")

Environnements

Système de coordonnées en sortie, Transformations géographiques, Espace de travail courant, Espace de travail temporaire, Gérer les noms de champs complets, Valeurs M en sortie, Résolution M, Tolérance M, Valeurs Z en sortie, Valeur Z en sortie par défaut, Résolution Z, Tolérance Z, Résolution XY, Tolérance XY, Domaine Z en sortie

Cas particuliers

Système de coordonnées en sortie: Feature geometry is projected to the Output Coordinate System prior to analysis. All mathematical computations are based on the Output Coordinate System spatial reference.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui