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.

Ilustración

Ilustración de la herramienta Gráfico de horizonte

Uso

  • Esta herramienta requiere las entidades de línea creadas por la herramienta Horizonte y genera un gráfico polar. El gráfico polar se puede ver en la ventana de mensajes de la herramienta y también se puede guardar como una imagen. El mensaje de salida también indica el porcentaje de cielo visible sobre el 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 resultante contendrá estos campos:

    • HORIZ_ANG: el ángulo horizontal aritmético expresado donde 0° es hacia el este y los valores aumentan en sentido contrario a las agujas del reloj hasta 360°. El ángulo horizontal aritmético es igual a 90 menos el acimut.
    • ZENITH_ANG: el ángulo cénit donde 0° está directamente hacia arriba a lo largo del eje z, 90° está en el horizonte y 180° está directamente hacia abajo a lo largo del eje z. El ángulo cénit es 90 menos el ángulo vertical desde el horizonte.
    • HOR_AN_GEO: el ángulo horizontal geográfico donde 0° está en el norte de la proyección y los valores aumentan en el sentido de las agujas del reloj hasta 360°.
    • ZEN_AN_INV: el ángulo cénit donde 0° está en el horizonte, 90° está directamente hacia arriba a lo largo del eje z y -90° está directamente hacia abajo a lo largo del eje z.

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

    • FEATURE_ID: el Id. único de la entidad que define el horizonte. Las filas donde este valor es -1 denotan ubicaciones donde el horizonte está definido por una superficie, mientras que un valor de -2 representa líneas de transición que no contribuyen al horizonte pero que se utilizan para conectar los segmentos que definen el horizonte.
    • 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 porcentaje de cielo visible se incluirá en los resultados. Este valor es igual al área por encima del horizonte, dividida entre 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 recto 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)

La tabla que se creará para generar los ángulos horizontal y vertical que van desde el punto de observador hasta cada uno de los vértices del 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 recto 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)

La tabla que se creará para generar los ángulos horizontal y vertical que van desde el punto de observador hasta cada uno de los vértices del 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 una secuencia de comandos 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)

Temas relacionados