Diagramme de ligne d’horizon (3D Analyst)

Synthèse

Permet de calculer le taux de visibilité du ciel et génère une table et un diagramme polaire en option.

Illustration

Utilisation

• Cet outil requiert les entités linaires créées par l’outil Horizon et génère un diagramme polaire. Le diagramme polaire peut être visualisé dans la fenêtre de message de l’outil et également enregistré sous forme d’image. Le message en sortie indique également le pourcentage de ciel visible au-dessus de l’horizon.

• L’angle azimut et vertical de chaque point d’observation vers chaque sommet de la ligne d’horizon peut être exporté vers une table autonome si vous spécifiez la valeur de paramètre Table d’angles en sortie. Le tableau obtenu contiendra les champs suivants :

  • HORIZ_ANG- L’angle horizontal arithmétique exprimé, où 0° correspond à l’est et les valeurs augmentent dans le sens anti-horaire jusqu’à 360°. L’angle horizontal arithmétique est égal à 90 moins l’azimut.
  • ZENITH_ANG- L’angle zénithal où 0° se trouve directement en haut le long de l’axe z, 90° à l’horizon et 180° directement en bas le long de l’axe z. L’angle zénithal est égal à 90 moins l’angle vertical à partir de l’horizon.
  • HOR_AN_GEO- L’angle horizontal géographique pour lequel 0° se trouve au nord de la projection et les valeurs augmentent dans la direction horaire jusqu’à 360°.
  • ZEN_AN_INV- L’angle zénithal pour lequel 0° indique l’horizon, 90° le haut le long de l’axe z et - 90° le bas le long de l’axe z.

  Le paramètre Champs supplémentaires est activé, la table en sortie contient également les champs suivants :

  • FEATURE_ID- L’identifiant unique de l’entité définissant l’horizon. Les lignes pour lesquelles cette valeur est égale à -1 indiquent les endroits où l’horizon est défini par une surface, tandis qu’une valeur de -2 représente des lignes de transition qui ne contribuent pas à la ligne d’horizon, mais sont utilisées pour relier les segments qui définissent l’horizon.
  • VERTEX_X- La coordonnée x du sommet.
  • VERTEX_Y- La coordonnée Y du sommet.
  • VERTEX_Z- La coordonnée z du sommet.
  • DIST_2D- La distance horizontale entre le point d’observation et le sommet.
  • DIST_3D- La distance de pente entre le point d’observation et le sommet.

• L’outil indique les angles de visibilité verticaux minimal et maximal par rapport au ciel avec le taux de visibilité du ciel, exprimé par une valeur comprise entre 0 et 1. Un taux de visibilité de 0,8 indique que 80 % du ciel est visible.

• Le pourcentage de ciel visible est inclus dans les résultats. Cette valeur est égale à la surface au-dessus de l’horizon, divisée par la surface au-dessus de la valeur du paramètre Angle de visibilité de base et est calculée uniquement dans la plage d’azimuts de l’horizon.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Entités ponctuelles d’observation en entrée	Entités en entrée contenant un ou plusieurs points d'observation.	Feature Layer
Entités linéaires en entrée	Entités linéaires représentant la ligne d’horizon.	Feature Layer
Angle de visibilité de base (Facultatif)	Angle vertical de ligne de base utilisé pour calculer le pourcentage de ciel visible. Zéro signifie l’horizon, 90 signifie tout droit vers le haut et -90 signifie tout droit vers le bas. La valeur par défaut est 0.	Double
Champs supplémentaires (Facultatif)	Spécifie si des champs supplémentaires seront ajoutés à la table d’angles. Désactivé : aucun champ supplémentaire ne sera inclus. Il s’agit de l’option par défaut. Activé : des champs supplémentaires seront inclus.	Boolean
Table d’angles en sortie (Facultatif)	Le tableau qui sera créé pour générer les angles horizontaux et verticaux allant du point d’observation jusqu’à chacun des sommets de l’horizon.	Table
Nom du diagramme en sortie (Facultatif)	Ce paramètre n’est pas pris en charge.	Graph
Image du diagramme en sortie (Facultatif)	Image du diagramme polaire qui décrit la vue radiale de l’horizon visible. L’image peut être créée au format PNG, JPG, JPEG ou SVG.	File

Sortie obtenue

Étiquette	Explication	Type de données
Taux de visibilité	Pourcentage moyen de ciel visible pour tous les points d’observation. La valeur exprimée est comprise entre 0 et 1, où 0,8 représente 80 pour cent de visibilité de la ligne d’horizon.	Double

Python

arcpy.ddd.SkylineGraph(in_observer_point_features, in_line_features, {base_visibility_angle}, {additional_fields}, {out_angles_table}, {out_graph}, {out_image_file})

Nom	Explication	Type de données
in_observer_point_features	Entités en entrée contenant un ou plusieurs points d'observation.	Feature Layer
in_line_features	Entités linéaires représentant la ligne d’horizon.	Feature Layer
base_visibility_angle (Facultatif)	Angle vertical de ligne de base utilisé pour calculer le pourcentage de ciel visible. Zéro signifie l’horizon, 90 signifie tout droit vers le haut et -90 signifie tout droit vers le bas. La valeur par défaut est 0.	Double
additional_fields (Facultatif)	Spécifie si des champs supplémentaires seront ajoutés à la table d’angles. NO_ADDITIONAL_FIELDS—Aucun champ supplémentaire ne sera inclus. Il s’agit de l’option par défaut. ADDITIONAL_FIELDS—Des champs supplémentaires seront inclus.	Boolean
out_angles_table (Facultatif)	Le tableau qui sera créé pour générer les angles horizontaux et verticaux allant du point d’observation jusqu’à chacun des sommets de l’horizon.	Table
out_graph (Facultatif)	Ce paramètre n’est pas pris en charge.	Graph
out_image_file (Facultatif)	Image du diagramme polaire qui décrit la vue radiale de l’horizon visible. L’image peut être créée au format PNG, JPG, JPEG ou SVG.	File

Sortie obtenue

Nom	Explication	Type de données
out_visibility_ratio	Pourcentage moyen de ciel visible pour tous les points d’observation. La valeur exprimée est comprise entre 0 et 1, où 0,8 représente 80 pour cent de visibilité de la ligne d’horizon.	Double

Exemple de code

1er exemple d’utilisation de l’outil SkylineGraph (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python.

arcpy.env.workspace = "C:/data"
arcpy.ddd.SkylineGraph("observers.shp", "skyline_outline.shp", 0, 
                      "ADDITIONAL_FIELDS", "table.dbf")

2e exemple d’utilisation de l’outil SkylineGraph (script autonome)

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome.

'''****************************************************************************
Name: Skyline Example
Description: This script demonstrates how to use the 
             Skyline tool.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'

# Set Local Variables
inPts = "observers.shp"
inLines = "skyline_outline.shp"
baseVisibility = 25

# Ensure output table has unique name
outTable = arcpy.CreateUniqueName("angles_table.dbf")

#Execute SkylineGraph
arcpy.ddd.SkylineGraph(inPts, inLines, 0, "ADDITIONAL_FIELDS", outTable)

Environnements

Espace de travail courant, Étendue, Transformations géographiques