Gráfico de horizonte (3D Analyst)

Resumen

Calcula la relación de visibilidad del cielo y genera una tabla opcional y un gráfico polar.

Uso

  • Esta herramienta requiere las entidades de línea creadas por la herramienta Horizonte.

  • El acimut y el ángulo vertical de cada punto de observador respecto a cada vértice del horizonte se puede exportar a una tabla independiente especificando el valor del parámetro Tabla de ángulos de salida. La tabla de salida contendrá los siguientes campos:

    • HORIZ_ANG— El ángulo horizontal
    • ZENITH_ANG— El ángulo cénit

    Si se activa el parámetro Campos adicionales, la tabla de salida también contendrá los siguientes campos:

    • FEATURE_ID— La entidad de horizonte que obstruye la vista del observador del cielo
    • VERTEX_X— La coordenada x del vértice
    • VERTEX_Y— La coordenada y del vértice
    • VERTEX_Z— La coordenada z del vértice
    • DIST_2D— La distancia horizontal desde el observador hasta el vértice
    • DIST_3D— La distancia de pendiente desde el observador hasta el vértice
  • La herramienta indicará los ángulos verticales mínimo y máximo de visibilidad del cielo junto con la relación de visibilidad del cielo, que se expresa como un valor de 0 a 1. Una relación de visibilidad de 0,8 indica que el 80 por ciento del cielo es visible.

  • El ángulo horizontal aritmético es igual a 90 menos el acimut y el ángulo cénit es 90 menos el ángulo vertical. (Un ángulo horizontal aritmético de 0 tiene dirección este y uno de 90 tiene dirección norte; un ángulo cénit de 90 es horizontal y uno de 0 es recto hacia arriba).

  • El porcentaje de cielo visible se incluirá en los resultados. Este valor es igual al área por encima del horizonte, dividida por el área por encima del valor del parámetro Ángulo de visibilidad base y se calcula solo dentro del rango de acimut del horizonte.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada de punto del observador

Las entidades de entrada que contienen uno o más puntos de observador.

Feature Layer
Entidades de línea de entrada

Las entidades de línea que representan el horizonte.

Feature Layer
Ángulo de visibilidad base
(Opcional)

Ángulo vertical de la línea base que se utilizará para calcular el porcentaje del cielo visible. Cero es el horizonte, 90 es recto hacia arriba y -90 es la recta hacia abajo. El valor predeterminado es 0.

Double
Campos adicionales
(Opcional)

Especifica si se incluirán campos adicionales en la tabla de ángulos.

  • Desactivado: no se incluirán campos adicionales. Esta es la opción predeterminada.
  • Activado: se incluirán campos adicionales.
Boolean
Tabla de ángulos de salida
(Opcional)

Tabla que se va a crear para la salida de los ángulos horizontal y vertical que van desde el punto de observador hasta cada uno de los vértices en el horizonte.

Table
Nombre de gráfico de salida
(Opcional)

No se admite este parámetro.

Graph
Imagen del gráfico de salida
(Opcional)

Imagen del gráfico polar que representa la vista radial del horizonte visible. La imagen se puede crear en formato PNG, JPG, JPEG o SVG.

File

Salida derivada

EtiquetaExplicaciónTipo de datos
Relación de visibilidad

El porcentaje medio de cielo visible para todos los observadores. Este valor se expresa como un valor entre 0 y 1, donde 0,8 representa el 80% de visibilidad del horizonte.

Double

arcpy.ddd.SkylineGraph(in_observer_point_features, in_line_features, {base_visibility_angle}, {additional_fields}, {out_angles_table}, {out_graph}, {out_image_file})
NombreExplicaciónTipo de datos
in_observer_point_features

Las entidades de entrada que contienen uno o más puntos de observador.

Feature Layer
in_line_features

Las entidades de línea que representan el horizonte.

Feature Layer
base_visibility_angle
(Opcional)

Ángulo vertical de la línea base que se utilizará para calcular el porcentaje del cielo visible. Cero es el horizonte, 90 es recto hacia arriba y -90 es la recta hacia abajo. El valor predeterminado es 0.

Double
additional_fields
(Opcional)

Especifica si se incluirán campos adicionales en la tabla de ángulos.

  • NO_ADDITIONAL_FIELDSNo se incluirán campos adicionales. Esta es la opción predeterminada.
  • ADDITIONAL_FIELDSSe incluirán campos adicionales.
Boolean
out_angles_table
(Opcional)

Tabla que se va a crear para la salida de los ángulos horizontal y vertical que van desde el punto de observador hasta cada uno de los vértices en el horizonte.

Table
out_graph
(Opcional)

No se admite este parámetro.

Graph
out_image_file
(Opcional)

Imagen del gráfico polar que representa la vista radial del horizonte visible. La imagen se puede crear en formato PNG, JPG, JPEG o SVG.

File

Salida derivada

NombreExplicaciónTipo de datos
out_visibility_ratio

El porcentaje medio de cielo visible para todos los observadores. Este valor se expresa como un valor entre 0 y 1, donde 0,8 representa el 80% de visibilidad del horizonte.

Double

Muestra de código

Ejemplo 1 de SkylineGraph (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.

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

En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.

'''****************************************************************************
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)

Información de licenciamiento

  • Basic: Requiere 3D Analyst
  • Standard: Requiere 3D Analyst
  • Advanced: Requiere 3D Analyst

Temas relacionados