Resumen
Genera una clase de entidad multiparche que representa una barrera de horizonte o un volumen de sombra.
Ilustración
Uso
La barrera se asemeja a un ventilador de triángulos formado al dibujar una línea desde el punto de observador hasta el primer vértice del horizonte y, a continuación, al ocultar la línea a través de todos los vértices del horizonte. Considere el uso de esta herramienta para determinar si las entidades, como multiparches que representan edificios, violan la barrera sobresaliendo de ella, o si un edificio propuesto podría alterar el horizonte.
Utilice la herramienta Horizonte primero para generar un horizonte o una silueta. Una silueta produciría una representación volumétrica de la sombra de luz que viene de los puntos de observación.
Los parámetros del Radio mínimo y Radio máximo definen la longitud de los bordes del triángulo que proviene del punto de observación. Si el valor predeterminado de 0 se especifica para Radio mínimo o Radio máximo, entonces no se utiliza ninguna longitud mínima o máxima en el análisis.
Si elige crear un multiparche cerrado, entonces la salida se extraerá a la altura definida en el parámetro Elevación base, y un anillo horizontal se creará para formar la parte inferior de la geometría cerrada. Si la elevación base especificada es mayor que el vértice más alto en la barrera de horizonte, entonces la base en realidad será un techo.
La clase de entidad multiparche nueva tendrá los siguientes campos:
- OBSV_PT_ID: el FID del punto de observador utilizado para crear el horizonte que, a su vez, se usó para crear este multiparche de barrera de horizonte.
- ORIGFTR_ID: el FID de la entidad original, como un edificio, representada por el segmento del horizonte o la silueta que se usó para crear este volumen de sombra.
- SILHOUE_ID: el FID de la entidad multiparche (silueta) que se usó para crear este volumen (solo para siluetas).
Sintaxis
arcpy.3d.SkylineBarrier(in_observer_point_features, in_features, out_feature_class, {min_radius_value_or_field}, {max_radius_value_or_field}, {closed}, {base_elevation}, {project_to_plane})
Parámetro | Explicación | Tipo de datos |
in_observer_point_features | La clase de entidad de puntos que contiene los puntos de observador. | Feature Layer |
in_features | La clase de entidad de línea de entrada que representa los horizontes, o la clase de entidad multiparche de entrada que representa las siluetas. | Feature Layer |
out_feature_class | La clase de entidad de salida en la que se ubica la barrera de horizonte o el volumen de sombra. | Feature Class |
min_radius_value_or_field (Opcional) | El radio mínimo al cual deben extenderse las aristas del triángulo desde el punto de observador. El valor predeterminado es 0, que significa sin mínimo. | Linear Unit; Field |
max_radius_value_or_field (Opcional) | El radio máximo al cual deben extenderse las aristas del triángulo desde el punto de observador. El valor predeterminado es 0, que significa sin máximo. | Linear Unit; Field |
closed (Opcional) | Si cerrar la barrera de horizonte con un borde y una base, de manera que el multiparche resultante parezca un sólido.
| Boolean |
base_elevation (Opcional) | Elevación de la base del multiparche cerrado; se ignora si la barrera no se va a cerrar. El valor predeterminado es 0. | Linear Unit; Field |
project_to_plane (Opcional) | Si los extremos delantero (más cerca al observador) y trasero (más lejos del observador) de la barrera deben proyectarse en un plano vertical. Esto se marca (se activa), por lo general, para crear un volumen de sombra.
| Boolean |
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.SkylineBarrier_3d("observers.shp", "skyline_outline.shp",
"barrier_output.shp")
En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.
'''****************************************************************************
Name: Skyline Barrier Example
Description: This script demonstrates how to use the
Skyline Barrier tool.
****************************************************************************'''
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/data'
# Set Local Variables
inPts = 'observers.shp'
inLine = 'skyline.shp'
outFC = 'output_barriers.shp'
minRadius = '0 METERS'
maxRadius = '200 METERS'
#Execute SkylineBarrier
arcpy.SkylineBarrier_3d(inPts, inLine, outFC, minRadius,
maxRadius, 'CLOSED')
Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst