Resumen
Calcula la visibilidad del cielo y genera una tabla opcional y un gráfico polar.
La tabla y el gráfico representan los ángulos horizontal y vertical que van desde el punto de observador hasta cada uno de los vértices en el horizonte.
Ilustración
Uso
Se evalúa el acimut y el ángulo vertical de cada punto de observador respecto a cada vértice del horizonte y el resultado se puede exportar a una tabla independiente especificando la Tabla de ángulos de salida. Los siguientes campos se incluirán en esta tabla:
- HORIZ_ANG: el ángulo horizontal.
- ZENITH_ANG: el ángulo cénit.
Si se selecciona Campos adicionales:
- 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.
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 del cielo visible siempre se incluye en los resultados. Este valor es igual al área por encima del horizonte, dividido por el área por encima del ángulo visible base (uno de los parámetros, con el valor predeterminado de cero, lo que implica la misma elevación que el observador) y se calcula sólo dentro del rango de acimut del horizonte.
Sintaxis
arcpy.3d.SkylineGraph(in_observer_point_features, in_line_features, {base_visibility_angle}, {additional_fields}, {out_angles_table}, {out_graph})| Parámetro | Explicación | Tipo 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) | El ángulo vertical de línea base que se utiliza para calcular el porcentaje del cielo visible. 0 es el horizonte, 90 es la recta hacia arriba; -90 es la recta hacia abajo. El valor predeterminado es 0. | Double |
additional_fields (Opcional) | Indica si se agregarán campos adicionales a la tabla de ángulos.
| Boolean |
out_angles_table (Opcional) | La tabla que se creará para generar los ángulos de salida. | Table |
out_graph (Opcional) |
No se admite este parámetro. | Graph |
Salida derivada
| Nombre | Explicación | Tipo 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. | Doble |
Muestra de código
En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python.
arcpy.env.workspace = "C:/data"
arcpy.SkylineGraph_3d("observers.shp", "skyline_outline.shp", 0,
"ADDITIONAL_FIELDS", "table.dbf")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.SkylineGraph_3d(inPts, inLines, 0, "ADDITIONAL_FIELDS", outTable)Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst