Tendance directionnelle (Geostatistical Analyst)

Synthèse

Crée un nuage de points sur une couche d’entités affichant la tendance des valeurs de données dans une direction spécifique.

Illustration

Une tendance linéaire dans un axe nord-est est affichée sous forme de nuage de points.

Utilisation

• La sortie est un nuage de points ajouté aux entités en entrée. L’entrée doit se composer d’entités ponctuelles ou surfaciques. Dans le cas d’entités surfaciques, les centroïdes des polygones sont utilisés pour créer le diagramme. Au moins sept entités sont requises. Les entités en entrée ne sont pas modifiées par l’outil.

• L’outil nécessite une carte active. Cela signifie, par exemple, qu’il ne peut pas être utilisé dans un script Python autonome. En l’absence d’une carte active, une erreur est retournée. Si les entités d’une couche d’entités de la carte active sont utilisées en entrée, le diagramme est ajouté à la couche d’entités. Dans tous les autres cas, une couche d’entités en sortie dérivée est ajoutée à la carte active contenant le diagramme.

• Les applications possibles de cet outil sont les suivantes :

  • Déterminer l’évolution du sentiment envers l’immigration lorsque vous partez de la frontière sud des États-Unis et remontez vers le nord.
  • Déterminer la façon dont le niveau des précipitations change à mesure que l’on s’éloigne du littoral.
  • Lors de l’interpolation géostatistique (krigeage), l’outil peut être utilisé pour déterminer si les valeurs de données présentent des tendances et l’ordre polynomial à utiliser lors de la suppression des tendances.

• La direction de la tendance est indiquée en degrés, dans le sens horaire à partir du nord. Par exemple, 0 correspond au nord, 90 à l’est, 180 au sud et 270 à l’ouest. La direction ne correspond généralement pas aux points cardinaux réels. Par exemple, 0 correspond à la direction des coordonnées y des entités dans leur système de coordonnées, qui n’est généralement pas le nord géographique.

• L’outil renvoie des messages qui affichent les valeurs R-carré et AIC de chaque ordre de polynôme (1 à 6). Si vous indiquez une direction de tendance, les valeurs sont déterminées pour cette direction pour chaque ordre de tendance polynomial. Si vous déterminez la direction de la tendance la plus forte, elle est déterminée pour chaque ordre polynomial de manière indépendante et elle est généralement différente pour chaque ordre. Vous pouvez utiliser les messages pour déterminer l’ordre polynomial à utiliser et, soit réexécuter l’outil avec l’ordre polynomial approprié, soit modifier l’ordre polynomial dans la fenêtre de propriétés du diagramme.

• Bien que l’outil vous permette d’utiliser des polynômes d’ordre six, il convient généralement de ne pas dépasser l’ordre trois.

• Lorsque vous déterminez la direction de la tendance la plus forte, l’outil identifie la direction qui maximise la valeur R-carré pour la direction de tendance et l’ordre polynomial indiqués. La direction de la tendance la plus forte est un nombre entier compris entre 0 et 179. En effet, l’ajout de 180 degrés à la direction inverse l’axe x et produit une valeur R-carré identique.

• Si les entités en entrée comportent une sélection, la direction de la tendance la plus forte et les messages associés sont déterminés uniquement à partir des entités sélectionnées. Toutefois, le diagramme est créé pour toute la couche d’entités, et pas seulement pour les entités sélectionnées. Pour afficher uniquement les entités sélectionnées dans le diagramme, cliquez sur le bouton Filtrer par sélection dans la fenêtre Diagramme.

• Pour explorer les tendances dans plusieurs directions, utilisez le géotraitement par lots pour créer plusieurs diagrammes dans des directions différentes.

• L’axe x du nuage de points est créé en faisant pivoter le système de coordonnées dans la direction de la tendance et en identifiant les coordonnées x des entités dans le système de coordonnées pivoté. Les valeurs de l’axe x sont remises à l’échelle pour commencer à 0 et peuvent être interprétées comme des distances le long de l’axe x pivoté.

  

  La rotation du système de coordonnées est effectuée à l’aide de la transformation suivante des coordonnées x et y des entités : x*cos(direction) + y*sin(direction). La direction est convertie en radians anti-horaires à partir de l’est avant d’appliquer la transformation.

• Si les entités d’une couche d’entités de la carte active sont utilisées en entrée, le diagramme de tendance directionnelle est ajouté à la couche d’entités. Si l’entrée est une classe d’entités sur disque, une couche des entités est ajoutée à la carte active contenant le diagramme.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités en entrée	Couche d’entités en entrée utilisée pour calculer la tendance directionnelle. L’entrée doit se composer d’entités ponctuelles ou surfaciques. Dans le cas d’entités surfaciques, les centroïdes des polygones sont utilisés pour créer le diagramme.	Feature Layer
Champ d’analyse	Champ numérique de la couche d’entités en entrée à utiliser pour calculer la tendance directionnelle.	Field
Direction de la tendance (Facultatif)	Direction de la tendance. Indiquez la valeur en degrés dans le sens horaire à partir du nord. Par exemple, 0 correspond au nord, 90 à l’est, 180 au sud et 270 à l’ouest. La valeur doit être comprise entre 0 et 360. La valeur par défaut est 0. Ce paramètre ne s’applique pas si vous déterminez la direction de la tendance la plus forte. La direction ne correspond généralement pas aux points cardinaux réels. Par exemple, 0 correspond à la direction des coordonnées y des entités, qui peut ne pas être le nord géographique.	Double
Déterminer la direction de la tendance la plus forte (Facultatif)	Spécifie si la direction de la tendance la plus forte sera déterminée par l’outil. La direction de la tendance la plus forte est déterminée en identifiant la direction qui maximise la valeur R-carré pour l’ordre polynomial indiqué. Lorsque ce paramètre est activé, la valeur est arrondie à un nombre entier compris entre 0 et 179. Activé : la direction de la tendance la plus forte sera déterminée par l’outil. Désactivé : la direction de la tendance sera la valeur du paramètre Direction de la tendance. Il s’agit de l’option par défaut.	Boolean
Ordre de tendance de polynôme (Facultatif)	Indique l’ordre du polynôme ajusté en fonction des valeurs de données. 1—Utilisation d’un polynôme de premier ordre (linéaire). 2—Utilisation d’un polynôme de deuxième ordre (quadratique). 3—Utilisation d’un polynôme de troisième ordre (cubique). 4—Utilisation d’un polynôme de quatrième ordre (quartique). 5—Utilisation d’un polynôme de cinquième ordre (quintique). 6—Utilisation d’un polynôme de sixième ordre (sextique).	Long

Sortie obtenue

Étiquette	Explication	Type de données
Entités en entrée mises à jour avec le diagramme	Couche d’entités comportant le diagramme de tendance directionnelle. Si les entités en entrées font partie d’une couche d’entités de la carte active, cette valeur est vide.	Feature Layer

Python

arcpy.ga.DirectionalTrend(in_features, analysis_field, {direction}, {determine_direction}, {order})

Nom	Explication	Type de données
in_features	Couche d’entités en entrée utilisée pour calculer la tendance directionnelle. L’entrée doit se composer d’entités ponctuelles ou surfaciques. Dans le cas d’entités surfaciques, les centroïdes des polygones sont utilisés pour créer le diagramme.	Feature Layer
analysis_field	Champ numérique de la couche d’entités en entrée à utiliser pour calculer la tendance directionnelle.	Field
direction (Facultatif)	Direction de la tendance. Indiquez la valeur en degrés dans le sens horaire à partir du nord. Par exemple, 0 correspond au nord, 90 à l’est, 180 au sud et 270 à l’ouest. La valeur doit être comprise entre 0 et 360. La valeur par défaut est 0. Ce paramètre ne s’applique pas si vous déterminez la direction de la tendance la plus forte. La direction ne correspond généralement pas aux points cardinaux réels. Par exemple, 0 correspond à la direction des coordonnées y des entités, qui peut ne pas être le nord géographique.	Double
determine_direction (Facultatif)	Spécifie si la direction de la tendance la plus forte sera déterminée par l’outil. La direction de la tendance la plus forte est déterminée en identifiant la direction qui maximise la valeur R-carré pour l’ordre polynomial indiqué. Si vous spécifiez DETERMINE_DIRECTION, la valeur sera arrondie à un nombre entier. DETERMINE_DIRECTION—La direction de la tendance la plus forte sera déterminée par l’outil. NO_DETERMINE_DIRECTION—La direction de la tendance sera la valeur du paramètre direction. Il s’agit de l’option par défaut.	Boolean
order (Facultatif)	Indique l’ordre du polynôme ajusté en fonction des valeurs de données. 1—Utilisation d’un polynôme de premier ordre (linéaire). 2—Utilisation d’un polynôme de deuxième ordre (quadratique). 3—Utilisation d’un polynôme de troisième ordre (cubique). 4—Utilisation d’un polynôme de quatrième ordre (quartique). 5—Utilisation d’un polynôme de cinquième ordre (quintique). 6—Utilisation d’un polynôme de sixième ordre (sextique).	Long

Sortie obtenue

Nom	Explication	Type de données
updated_in_features	Couche d’entités comportant le diagramme de tendance directionnelle. Si les entités en entrées font partie d’une couche d’entités de la carte active, cette valeur est vide.	Feature Layer

Exemple de code

Exemple 1 d’utilisation de la fonction DirectionalTrend (fenêtre Python)

Le script Python ci-dessous illustre l’utilisation de la fonction DirectionalTrend.

import arcpy
# Create chart of trend of data values in northeast direction.
arcpy.ga.DirectionalTrend(
    in_features="myFeatureLayer",
    analysis_field="myField",
    direction=45, # Northeast direction
    determine_direction="NO_DETERMINE_DIRECTION",
    order=2
)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

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