Diagramme de ligne d’horizon (3D Analyst)

Synthèse

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

La table et le diagramme représentent les angles horizontaux et verticaux allant du point d'observation jusqu'à chacun des sommets de l'horizon.

Illustration

Diagramme de ligne d'horizon

Utilisation

  • L'angle azimut et vertical de chaque point d'observation vers chaque sommet de la ligne d'horizon est évalué et peut être exporté vers une table autonome si vous spécifiez la Table d’angles en sortie. Les champs suivants apparaissent dans cette table :

    • HORIZ_ANG : angle horizontal.
    • ZENITH_ANG : angle de zénith.

    Si vous sélectionnez Champs supplémentaires :

    • FEATURE_ID : 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'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 toujours répertorié dans les résultats. Cette valeur est égale à la surface au-dessus de l'horizon, divisée par la surface au-dessus de l'angle visible de base (l'un des paramètres, ayant zéro comme valeur par défaut, signifiant à la même altitude que le point d'observation), 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. 0 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)

Indique si des champs supplémentaires seront ajoutés à la table d'angles.

  • Désactivé : aucun champ supplémentaire ne sera ajouté. Il s’agit de l’option par défaut.
  • Activé : des champs supplémentaires seront ajoutés.
Boolean
Table d’angles en sortie
(Facultatif)

Table à créer pour générer les angles.

Table
Nom du diagramme en sortie
(Facultatif)

Ce paramètre n'est pas pris en charge.

Graph

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})
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. 0 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)

Indique si des champs supplémentaires seront ajoutés à la table d'angles.

  • NO_ADDITIONAL_FIELDSAucun champ supplémentaire ne sera ajouté. Il s’agit de l’option par défaut.
  • ADDITIONAL_FIELDSDes champs supplémentaires seront ajoutés.
Boolean
out_angles_table
(Facultatif)

Table à créer pour générer les angles.

Table
out_graph
(Facultatif)

Ce paramètre n'est pas pris en charge.

Graph

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.SkylineGraph_3d("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.SkylineGraph_3d(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