ArcMap

Direction moyenne linéaire

Résumé

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

Illustration de l'outil Direction moyenne linéaire

Utilisation

  • L'entrée doit être une classe d'entités linéaires.

  • Les valeurs attributaires de l'entité linéaire en sortie incluent :

    • CompassA - Angle horizontal (dans le sens horaire à partir du plein nord)
    • DirMean - Moyenne directionnelle (dans le sens anti-horaire à partir du plein est)
    • CirVar - Variance circulaire (mesure du degré d'écart des directions ou orientations des lignes par rapport à la moyenne directionnelle)
    • AveX et AveY - Coordonnées X et Y du centre moyen
    • AveLen - Longueur de ligne 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 (CirVar) 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). Cette mesure est donnée en tant que SphVar pour la variance sphérique en trois dimensions.

  • 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. L'outil ne prend pas en compte tous les sommets le long d'une ligne.

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

  • Les entités en sortie sont ajoutées automatiquement à la table des matières avec le rendu par défaut (vecteurs directionnels). Le rendu appliqué est défini par un fichier de couche dans <ArcGIS>/Desktop10.x/ArcToolbox/Templates/Layers. Vous pouvez appliquer à nouveau le rendu par défaut, si nécessaire, en important la symbologie des couches modèle.

  • Lorsque cet outil s'exécute, la classe d'entité 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 couche 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.

Syntaxe

arcpy.stats.DirectionalMean(Input_Feature_Class, Output_Feature_Class, Orientation_Only, {Case_Field})
ParamètreExplicationType 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

Indique s'il faut inclure les informations sur la direction (nœuds de début et de fin) dans l'analyse.

  • DIRECTION —Les nœuds de début et de fin sont utilisés dans le calcul de la moyenne. Il s'agit de l'option par défaut.
  • ORIENTATION_ONLY —Les informations sur les nœuds de début et de fin sont ignorées.
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

Exemple 1 d'utilisation de l'outil Direction moyenne linéaire (fenêtre Python)

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")
Exemple 2 d'utilisation de l'outil Direction moyenne linéaire (script autonome)

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"
 
# 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

Informations de licence

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

Rubriques connexes