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

Ilustración de la herramienta Barrera de horizonte
La primera imagen es la entrada de la herramienta Barrera de horizonte. Consta del punto del observador y la salida del Horizonte por medio de la herramienta Horizonte. La segunda imagen es la salida de Barrera de horizonte.

Uso

  • La barrera se asemeja a un abanico de triángulos formado al dibujar una línea desde el punto de observador hasta el primer vértice del horizonte y después recorrer la línea a través de todos los vértices del horizonte. Puede utilizar esta herramienta para determinar si las entidades, tales como multiparches que representan edificios, vulneran la barrera porque sobresalen de ella o si un edificio propuesto alterará el horizonte.

  • Utilice primero la herramienta Horizonte para generar un horizonte o una silueta. Una silueta producirá una representación volumétrica de la sombra proyectada por la luz que proviene del punto de observación.

  • Los parámetros Radio mínimo y Radio máximo definen la longitud de los bordes del triángulo que proviene del punto de observación. Si se especifica el valor predeterminado de 0 para Radio mínimo o Radio máximo, no se utilizará ninguna longitud mínima o máxima en el análisis.

  • Si crea un multiparche cerrado, la salida se extrudirá a la altura definida en el parámetro Elevación base y se creará un anillo horizontal 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 de la barrera de horizonte, la base será un techo.

  • La nueva clase de entidad multiparche contendrá 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).

Parámetros

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

La clase de entidad de punto que contiene los puntos de observador.

Feature Layer
Entidades de entrada

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
Clase de entidad de salida

La clase de entidad de salida en la que se ubicará la barrera de horizonte o el volumen de sombra.

Feature Class
Radio mínimo
(Opcional)

El radio mínimo al que se extenderán las aristas del triángulo desde el punto de observador. Por ejemplo, el valor de 10 metros significa que todas las entidades de barrera de salida se extenderán al menos 10 metros desde su punto de origen. El valor predeterminado es 0, lo que significa que no se aplica ninguna distancia mínima.

Linear Unit; Field
Radio máximo
(Opcional)

El radio máximo que se extenderán las aristas del triángulo desde el punto de observador. El valor predeterminado es 0, lo que significa que no se aplica ninguna distancia máxima.

Linear Unit; Field
Cerrado
(Opcional)

Especifica si se agregarán un borde y una base a la barrera de horizonte para que el multiparche resultante parezca un sólido cerrado.

  • Desactivado: no se agregará ningún borde ni base al multiparche; únicamente se representará la superficie que va desde el observador hasta el horizonte. Esta es la opción predeterminada.
  • Activado: se agregará un borde y una base al multiparche para formar la apariencia de un sólido cerrado.
Boolean
Elevación base
(Opcional)

La elevación de la base del multiparche cerrado. Este parámetro no se tiene en cuenta si el parámetro Cerrado está desactivado. El valor predeterminado es 0.

Linear Unit; Field
Proyectar al plano
(Opcional)

Especifica si los extremos frontales (más cercanos al observador) y posterior (más lejano del observador) de la barrera se proyectarán en un plano vertical. Se marca generalmente para crear un volumen de sombra.

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

arcpy.ddd.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})
NombreExplicaciónTipo de datos
in_observer_point_features

La clase de entidad de punto 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 ubicará la barrera de horizonte o el volumen de sombra.

Feature Class
min_radius_value_or_field
(Opcional)

El radio mínimo al que se extenderán las aristas del triángulo desde el punto de observador. Por ejemplo, el valor de 10 metros significa que todas las entidades de barrera de salida se extenderán al menos 10 metros desde su punto de origen. El valor predeterminado es 0, lo que significa que no se aplica ninguna distancia mínima.

Linear Unit; Field
max_radius_value_or_field
(Opcional)

El radio máximo que se extenderán las aristas del triángulo desde el punto de observador. El valor predeterminado es 0, lo que significa que no se aplica ninguna distancia máxima.

Linear Unit; Field
closed
(Opcional)

Especifica si se agregarán un borde y una base a la barrera de horizonte para que el multiparche resultante parezca un sólido cerrado.

  • NO_CLOSEDNo se agregará ningún borde ni base al multiparche; únicamente se representará la superficie que va desde el observador hasta el horizonte. Esta es la opción predeterminada.
  • CLOSEDSe agregará un borde y una base al multiparche para formar la apariencia de un sólido cerrado.
Boolean
base_elevation
(Opcional)

La elevación de la base del multiparche cerrado. Este parámetro no se tiene en cuenta si el parámetro closed tiene el valor NO_CLOSED. El valor predeterminado es 0.

Linear Unit; Field
project_to_plane
(Opcional)

Especifica si los extremos frontales (más cercanos al observador) y posterior (más lejano del observador) de la barrera deben proyectarse en un plano vertical. Por lo general, se le asigna el valor PROJECT_TO_PLANE 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 distintos de cero para el radio mínimo y el radio máximo). Esta es la opción predeterminada.
  • PROJECT_TO_PLANELa 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 (script 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