Linear Directional Mean (Statistiques spatiales)
Récapitulatif
Identifie la direction moyenne, la longueur et le centre géographique d'un ensemble de lignes.
Pour en savoir plus sur le fonctionnement de l'outil Direction moyenne linéaire
Illustration
Utilisation
-
L'entrée doit être une classe d'entités linéaires.
-
Les valeurs attributaires pour la ou les entités linéaires en sortie comprennent : CompassA pour l'angle horizontal (dans le sens horaire à partir du Nord), DirMean pour la moyenne directionnelle (dans le sens anti-horaire à partir de l'Est), CirVar pour la variance circulaire (indication de la quantité de directions ou d'orientations de lignes qui dévient de la moyenne directionnelle), AveX et AveY pour les coordonnées X et Y du centre moyen, et AveLen pour la longueur moyenne. Lorsqu'un champ de récapitulation est spécifié, il est également ajouté à la classe d'entités en sortie.
-
Analogue à une mesure d'écart type, la valeur de variance circulaire indique de quelle façon le vecteur moyen directionnel représente l'ensemble de vecteurs en entrée. Les variances circulaires varient de 0 à 1. Si tous les vecteurs en entrée ont des directions absolument identiques (ou très similaires), la variance circulaire est petite (proche de 0). Lorsque les directions vectorielles en entrée couvrent la boussole entière, la variance circulaire est grande (proche de 1).
-
Le champ de récapitulation permet de grouper des entités pour effectuer des calculs de directions moyennes linéaires distinctes. Lorsqu'un champ de récapitulation est spécifié, les entités linéaires en entrée sont groupées en premier selon les valeurs du champ de récapitulation ; une entité linéaire en sortie est ensuite créé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.
-
Lors de la mesure de la direction, l'outil prend en compte uniquement les premiers et les derniers points de la ligne. Il ne prend pas en compte les sommets le long de la ligne.
-
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.
-
Lorsque cet outil s'exécute dans ArcMap, la classe d'entités en sortie est automatiquement ajoutée à la table des matières avec un rendu par défaut (vecteurs directionnels). Le rendu appliqué est défini par un fichier de couches dans <ArcGIS>/ArcToolbox/Templates/Layers. Vous pouvez appliquer à nouveau le rendu par défaut, si nécessaire, en important la symbologie des couches modèle.
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 les vecteurs pour lesquels la direction moyenne sera calculée. | Feature Layer |
Output_Feature_Class |
Classe d'entités linéaires qui va contenir les entités représentant les directions moyennes de la classe d'entités en entrée. | Feature Class |
Orientation_Only |
| Boolean |
Case_Field (Facultatif) |
Champ utilisé pour regrouper des entités pour des calculs de moyenne directionnelle distinctes. 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 LinearDirectionalMean.
import arcpy
arcpy.env.workspace = r"C:\data"
arcpy.DirectionalMean_stats("AutoTheft_links.shp", "auto_theft_LDM.shp", "DIRECTION", "#")
Le script Python autonome ci-dessous illustre l'utilisation de l'outil LinearDirectionalMean.
# 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.