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.

Utilisation

  • Cet outil requiert les entités linaires créées par l’outil 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. La table en sortie contient les champs suivants :

    • HORIZ_ANG—L’angle horizontal
    • ZENITH_ANG—L’angle de zénith

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

    • FEATURE_ID—L’entité de ligne d’horizon qui bloque la vue du ciel du point d’observation
    • VERTEX_X—Coordonnée X du sommet
    • VERTEX_Y—Coordonnée Y du sommet
    • VERTEX_Z—Coordonnée Z du sommet
    • DIST_2D—Distance horizontale entre le point d’observation et le sommet
    • DIST_3D—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.

  • L'angle horizontal arithmétique est égal à 90 moins l'azimut, et l'angle zénithal est égal à 90 moins l'angle vertical. (Un angle horizontal arithmétique égal à 0 est plein est, et égal à 90, plein nord. Un angle zénithal égal à 90 est horizontal, et égal à 0, tout droit vers le haut.)

  • 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 de paramètre Angle de visibilité de base et est calculée uniquement dans la plage d’azimuts de l’horizon.

Paramètres

ÉtiquetteExplicationType 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)

Table à créer 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

ÉtiquetteExplicationType 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

arcpy.ddd.SkylineGraph(in_observer_point_features, in_line_features, {base_visibility_angle}, {additional_fields}, {out_angles_table}, {out_graph}, {out_image_file})
NomExplicationType 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_FIELDSAucun champ supplémentaire ne sera inclus. Il s’agit de l’option par défaut.
  • ADDITIONAL_FIELDSDes champs supplémentaires seront inclus.
Boolean
out_angles_table
(Facultatif)

Table à créer 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

NomExplicationType 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)

Informations de licence

  • Basic: Nécessite 3D Analyst
  • Standard: Nécessite 3D Analyst
  • Advanced: Nécessite 3D Analyst

Rubriques connexes