Barrera de horizonte (3D Analyst)

Resumen

Genera una clase de entidad multiparche que representa una barrera de horizonte o un volumen de sombra.

Más información sobre cómo funciona Barrera de horizonte

Ilustración

Barrera de horizonte
La imagen de la izquierda es la entrada en la herramienta Barrera de horizonte. Consta del punto del observador y la salida de Horizonte generada por la herramienta Horizonte. La imagen de la derecha es la salida de la Barrera de horizonte.

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

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ámetroExplicaciónTipo 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.

  • NO_CLOSEDNo se agrega ningún borde o base al multiparche; sólo se representa el multiparche que denota la superficie que va desde el observador hasta el horizonte. Esta es la opción predeterminada.
  • CLOSED Se agregan un borde y una base al multiparche para formar lo que parece ser un sólido cerrado.
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.

  • NO_PROJECT_TO_PLANELa barrera se extenderá desde el punto de observador hasta el horizonte (o más cerca o más lejos si se proporcionan valores que no son cero para el radio mínimo y el radio máximo). Esta es la opción predeterminada.
  • PROJECT_TO_PLANE La barrera se extenderá desde un plano vertical hasta un plano vertical.
Boolean

Muestra de código

Ejemplo 1 de SkylineBarrier (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.SkylineBarrier_3d("observers.shp", "skyline_outline.shp", 
                        "barrier_output.shp")
Ejemplo 2 de SkylineBarrier (secuencia de comandos independiente)

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

Información de licenciamiento

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

Temas relacionados