Diagramme de ligne d'horizon (3D Analyst)

Récapitulatif

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

Syntaxe

SkylineGraph_3d (in_observer_point_features, in_line_features, {base_visibility_angle}, {additional_fields}, {out_angles_table}, {out_graph})
ParamètreExplicationType de données
in_observer_point_features

The input features containing one or more observer points.

Feature Layer
in_line_features

Classe d'entités linéaires représentant l'horizon.

Feature Layer
base_visibility_angle
(Facultatif)

Angle vertical utilisé en tant que ligne de base pour calculer le pourcentage de ciel visible (0 signifiant l'horizon, 90 signifiant tout droit vers le haut, -90 signifiant tout droit vers le bas). La valeur par défaut est 0.

Double
additional_fields
(Facultatif)

Détermine si des champs supplémentaires doivent être ajoutés ou non à la table et pas seulement les deux valeurs d'angle.

  • NO_ ADDITIONAL_FIELDSLes champs supplémentaires ne sont pas générés. Il s'agit de l'option par défaut.
  • ADDITIONAL_FIELDSLes champs supplémentaires sont générés.
Boolean
out_angles_table
(Facultatif)

Table à créer pour générer les angles. La valeur par défaut est vide, ce qui signifie aucune table.

Table
out_graph
(Facultatif)

Nom du diagramme facultatif. Une table doit être créée pour que le diagramme puisse être créé. Le diagramme sera affiché et pourra être enregistré et/ou modifié. La valeur par défaut est vide, ce qui signifie aucun diagramme.

Graph

Exemple de code

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

The following sample demonstrates the use of this tool in the Python window:

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
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)

The following sample demonstrates the use of this tool in a stand-alone Python script:

'''****************************************************************************
Name: Skyline Example
Description: This script demonstrates how to use the 
             Skyline tool.
****************************************************************************'''
# Import system modules
import arcpy
import exceptions, sys, traceback
from arcpy import env

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension('3D')
    # Set environment settings
    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)


except arcpy.ExecuteError:
    print arcpy.GetMessages()
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

Environnements

Rubriques connexes

Informations de licence

ArcView : Obligatoire 3D Analyst
ArcEditor : Obligatoire 3D Analyst
ArcInfo : Obligatoire 3D Analyst

7/10/2012