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
Utilisation
L'entrée doit être une classe d'entités linéaires.
Cet outil respecte la nature 3D des données ponctuelles et utilise les valeurs x, y et z dans les calculs si les valeurs z sont disponibles. Comme ces résultats sont en 3D, vous devez les afficher dans une scène. Veillez à exécuter l'analyse dans une scène ou à copier la couche de résultats dans une scène pour afficher correctement les résultats de l'analyse.
Lorsque les entités en entrée sont 2D, les valeurs attributaires pour 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
Lorsque les entités en entrée sont 3D, les valeurs attributaires pour l'entité linéaire en sortie incluent :
- CompassA - Angle horizontal (dans le sens horaire à partir du plein nord) dans le plan XY de la moyenne directionnelle
- DirMean - Moyenne directionnelle (dans le sens anti-horaire à partir du plein est)
- DirMeanZ - Angle entre le plan XY et le vecteur moyen directionnel
- SphVar - Variance sphérique (mesure du degré d'écart des directions ou orientations des lignes par rapport à la moyenne directionnelle)
- AveX, AveY et AveZ - Coordonnées X, Y et Z du centre moyen
- AveLen3D - Longueur de ligne moyenne calculée en trois dimensions
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.
Un test d'uniformité de Rayleigh est appliqué à la moyenne directionnelle. Il vous indique si la moyenne directionnelle est très différente d'une distribution uniforme. En 2D, une distribution uniforme signifie que les lignes sont distribuées de façon uniforme autour de la boussole. En 3D, une distribution uniforme signifie que les lignes sont distribuées de façon uniforme autour d'une sphère. Les valeurs ZScore et PValue indiquent si vous pouvez rejeter l'hypothèse nulle d'uniformité circulaire. La valeur RefValue est la valeur critique du test statistique de Rayleigh. UnifTest contiendra le texte Nonuniform si l'hypothèse nulle a été rejetée ; dans le cas contraire, il contiendra le texte Uniform.
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.
La couche Entités en sortie est ajoutée 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 Pro>\Resources\ArcToolBox\Templates\Layers. Vous pouvez appliquer à nouveau le rendu par défaut, si nécessaire, à l'aide de l'outil Appliquer la symbologie d'une couche.
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, à l'aide de l'outil Appliquer la symbologie d’une couche.
Attention :
Lorsque vous utilisez des shapefiles, 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
arcpy.stats.DirectionalMean(Input_Feature_Class, Output_Feature_Class, Orientation_Only, {Case_Field})| 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 | Indique s'il faut inclure les informations sur la direction (nœuds de début et de fin) dans l'analyse.
| 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"
# 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
- Système de coordonnées en sortie
La géométrie des entités est projetée sur le 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.
Informations de licence
- Basic: Oui
- Standard: Oui
- Advanced: Oui
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?