Aide

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 des entités linéaires en sortie sont notamment

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

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

DirectionalMean_stats (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
  • DIRECTION —Les nœuds de début et de fin sont utilisés dans le calcul de la moyenne (valeur 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 d'utilisation de l'outil LinearDirectionalMean (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 d'utilisation de l'outil LinearDirectionalMean (script Python 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"
 
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

Informations de licence

  • ArcGIS Desktop Basic: Oui
  • ArcGIS Desktop Standard: Oui
  • ArcGIS Desktop Advanced: Oui

Rubriques connexes