Etiqueta | Explicación | Tipo de datos |
Entidades de entrada de punto del observador | Los puntos 3D que representan los observadores. Cada entidad tendrá su propia salida. | Feature Layer |
Clase de entidad de salida | Las entidades 3D que serán líneas que representan el horizonte o multiparches que representan siluetas. | Feature Class |
Superficie de entrada (Opcional) | La superficie topográfica que se utilizará para definir el horizonte. Si no se indica una superficie, se utilizará una superficie virtual, definida por los valores de los parámetros Radio de superficie virtual y Elevación de superficie virtual. | LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer; Terrain Layer |
Radio de superficie virtual (Opcional) | El radio de la superficie virtual que se utilizará para definir el horizonte cuando no se indica una superficie topográfica. El valor predeterminado es 1000 metros. | Linear Unit |
Elevación de superficie virtual (Opcional) | La elevación de la superficie virtual que se utilizará para definir el horizonte en lugar de una superficie real. El parámetro se ignora si se proporciona una superficie real. El valor predeterminado es 0. | Linear Unit |
Entidades de entrada (Opcional) | Las entidades utilizadas para determinar el horizonte. Si no se especifican las entidades, el horizonte constará solamente de la línea de horizonte tal y como se haya definido en la superficie topográfica o virtual. | Feature Layer |
Nivel de detalle de entidad (Opcional) | Especifica el nivel de detalle con el que se examinará cada entidad.
| String |
Desde acimut (Opcional) | El acimut, en grados, desde el cual comenzará el análisis del horizonte. El análisis comienza en el punto del observador y se mueve hacia la derecha, desde el valor del parámetro Acimut de origen hasta que llega al valor del parámetro Acimut de destino. El valor debe ser mayor que -360 y menor que 360. El valor predeterminado es 0. | Double; Field |
A acimut (Opcional) | La dirección, en grados, en la que se realizará el análisis del horizonte. El análisis comienza en el punto del observador y se mueve hacia la derecha, desde el valor del parámetro Acimut de origen hasta que llega al valor del parámetro Acimut de destino. El valor no debe ser más de 360 grados mayor que el valor del parámetro Acimut de origen. El valor predeterminado es 360. | Double; Field |
Incremento de acimut (Opcional) | El intervalo angular, en grados, en el que se evaluará el horizonte mientras se realiza el análisis del horizonte entre el valor del parámetro Acimut de origen y el valor del parámetro Acimut de destino. El valor no debe ser mayor que el valor del parámetro Acimut de destino menos el valor del parámetro Acimut de origen. El valor predeterminado es 1. | Double; Field |
Máximo radio de horizonte (Opcional) | La distancia máxima desde la ubicación del observador desde la que se buscará un horizonte. Un valor de cero indica que no se impondrá ninguna limitación. El valor predeterminado es 0. | Linear Unit |
Horizonte del segmento (Opcional) | Especifica si el horizonte resultante tendrá una entidad para cada punto de observador o si el horizonte de cada observador se segmentará según los elementos únicos que contribuyen al horizonte. Este parámetro solo está activo si se ha especificado un multiparche de entrada. Si se generan siluetas, este parámetro indicará si se usarán rayos divergentes. Para las sombras del sol, desactive el parámetro.
| Boolean |
Ajustar a porcentaje (Opcional) | Indica en qué porcentaje del ángulo vertical (ángulo por encima del horizonte o ángulo de elevación) o de la elevación original se ubicará cada vértice del horizonte. Si se utiliza un valor de 0 o 100, no se escalará. El valor predeterminado es 100. | Double |
Escala según (Opcional) | Especifica cómo se determinará el escalado.
| String |
Método de escala (Opcional) | Especifica el vértice que se utilizará para el cálculo de la escala.
| String |
Utilizar curvatura (Opcional) | Especifica si se utilizará la curvatura de la Tierra para generar el cordón montañoso. Esta opción sólo está disponible cuando se especifica una superficie de ráster para el parámetro Superficie de entrada.
| Boolean |
Utilizar refracción (Opcional) | Especifica si se aplicará la refracción atmosférica al generar el cordón montañoso a partir de una superficie de entrada. Esta opción sólo está disponible cuando se especifica una superficie de ráster para el parámetro Superficie de entrada.
| Boolean |
Factor de refracción (Opcional) | El coeficiente de refracción que se utilizará si se aplica refracción atmosférica. El valor predeterminado es 0,13. | Double |
Resolución de nivel de pirámide (Opcional) | La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa. | Double |
Crear siluetas (Opcional) | Especifica si las entidades de salida representarán horizontes o siluetas.
| Boolean |
Resumen
Genera una clase de entidad de línea o multiparche que contiene los resultados de un análisis de horizonte o silueta.
Ilustración
Uso
La herramienta Horizonte se puede utilizar para crear siluetas de entidades que se pueden extrudir en volúmenes de sombra con la herramienta Barrera de horizonte.
Los siguientes campos se agregarán al valor del parámetro de Clase de entidad de salida que contiene los horizontes:
- OBSV_PT_ID— El FID del punto del observador que se utilizó para crear este horizonte
- ORIGFTR_ID— El FID de la entidad, como un edificio
Los siguientes campos se agregarán al valor del parámetro de Clase de entidad de salida que contiene las siluetas:
- OBSV_PT_ID— El FID del punto del observador que se utilizó para crear esta silueta
- ORIGFTR_ID— El FID de la entidad original, como un edificio, representada por esta silueta
- DIR_VECT_X— El componente X del vector unitario que representa la dirección de los rayos de luz desde la posición del observador
- DIR_VECT_Y— El componente Y del vector unitario que representa la dirección de los rayos de luz desde la posición del observador
- DIR_VECT_Z— El componente Z del vector unitario que representa la dirección de los rayos de luz desde la posición del observador
- FEAT_CTR_X— El componente Z del centro del sobre de la entidad original (por ejemplo, edificio)
- FEAT_CTR_Y— El componente Y del centro del sobre de la entidad original
- FEAT_CTR_Z— El componente Z del centro del sobre de la entidad original
- BHND_CTR_X— El componente X del centro del sobre de la entidad, que se movió detrás de la entidad
- BHND_CTR_Y— El componente Y del centro del sobre de la entidad, que se movió detrás de la entidad
- BHND_CTR_Z— El componente Z del centro del sobre de la entidad, que se movió detrás de la entidad
- USED_PARLL— Indica si la silueta se creó o no usando rayos de luz paralelos (1 para sí, 0 para no)
- MADE_VERT— Indica si la silueta se hizo en vertical, en lugar de en perpendicular a los rayos de luz (1 para sí, 0 para no)
- MOVED_BHND— Indica si la silueta se movió detrás de la entidad, en lugar de mantenerse en el centro (1 para sí, 0 para no)
La refracción atmosférica y la corrección de la curvatura de la Tierra solo se aplicarán cuando el valor del parámetro Superficie de entrada sea un dataset ráster. Si la superficie está definida por un dataset de TIN, de terreno o LAS, utilice una de las siguientes herramientas para exportar los datos a un ráster:
Parámetros
arcpy.ddd.Skyline(in_observer_point_features, out_feature_class, {in_surface}, {virtual_surface_radius}, {virtual_surface_elevation}, {in_features}, {feature_lod}, {from_azimuth_value_or_field}, {to_azimuth_value_or_field}, {azimuth_increment_value_or_field}, {max_horizon_radius}, {segment_skyline}, {scale_to_percent}, {scale_according_to}, {scale_method}, {use_curvature}, {use_refraction}, {refraction_factor}, {pyramid_level_resolution}, {create_silhouettes})
Nombre | Explicación | Tipo de datos |
in_observer_point_features | Los puntos 3D que representan los observadores. Cada entidad tendrá su propia salida. | Feature Layer |
out_feature_class | Las entidades 3D que serán líneas que representan el horizonte o multiparches que representan siluetas. | Feature Class |
in_surface (Opcional) | La superficie topográfica que se utilizará para definir el horizonte. Si no se indica una superficie, se utilizará una superficie virtual, definida por los valores de los parámetros virtual_surface_radius y virtual_surface_elevation. | LAS Dataset Layer; Mosaic Layer; Raster Layer; TIN Layer; Terrain Layer |
virtual_surface_radius (Opcional) | El radio de la superficie virtual que se utilizará para definir el horizonte cuando no se indica una superficie topográfica. El valor predeterminado es 1000 metros. | Linear Unit |
virtual_surface_elevation (Opcional) | La elevación de la superficie virtual que se utilizará para definir el horizonte en lugar de una superficie real. El parámetro se ignora si se proporciona una superficie real. El valor predeterminado es 0. | Linear Unit |
in_features [in_features,...] (Opcional) | Las entidades utilizadas para determinar el horizonte. Si no se especifican las entidades, el horizonte constará solamente de la línea de horizonte tal y como se haya definido en la superficie topográfica o virtual. | Feature Layer |
feature_lod (Opcional) | Especifica el nivel de detalle con el que se examinará cada entidad.
| String |
from_azimuth_value_or_field (Opcional) | El acimut, en grados, desde el cual comenzará el análisis del horizonte. El análisis comienza en el punto del observador y se mueve hacia la derecha, desde el valor del parámetro from_azimuth_value_or_field hasta que llega al valor del parámetro to_azimuth_value_or_field. El valor debe ser mayor que -360 y menor que 360. El valor predeterminado es 0. | Double; Field |
to_azimuth_value_or_field (Opcional) | La dirección, en grados, en la que se realizará el análisis del horizonte. El análisis comienza en el punto del observador y se mueve hacia la derecha, desde el valor del parámetro from_azimuth_value_or_field hasta que llega al valor del parámetro to_azimuth_value_or_field. El valor no debe ser más de 360 grados mayor que el valor del parámetro from_azimuth_value_or_field. El valor predeterminado es 360. | Double; Field |
azimuth_increment_value_or_field (Opcional) | El intervalo angular, en grados, en el que se evaluará el horizonte mientras se realiza el análisis del horizonte entre el valor del parámetro from_azimuth_value_or_field y el valor del parámetro to_azimuth_value_or_field. El valor no debe ser mayor que el valor del parámetro to_azimuth_value_or_field menos el valor del parámetro from_azimuth_value_or_field. El valor predeterminado es 1. | Double; Field |
max_horizon_radius (Opcional) | La distancia máxima desde la ubicación del observador desde la que se buscará un horizonte. Un valor de cero indica que no se impondrá ninguna limitación. El valor predeterminado es 0. | Linear Unit |
segment_skyline (Opcional) | Especifica si el horizonte resultante tendrá una entidad para cada punto de observador o si el horizonte de cada observador se segmentará según los elementos únicos que contribuyen al horizonte. Este parámetro solo está habilitado si se ha especificado un multiparche de entrada. Si se generan siluetas, este parámetro indicará si se usarán rayos divergentes. Para las sombras del sol, defina el parámetro como NO_SEGMENT_SKYLINE.
| Boolean |
scale_to_percent (Opcional) | Indica en qué porcentaje del ángulo vertical (ángulo por encima del horizonte o ángulo de elevación) o de la elevación original se ubicará cada vértice del horizonte. Si se utiliza un valor de 0 o 100, no se escalará. El valor predeterminado es 100. | Double |
scale_according_to (Opcional) | Especifica cómo se determinará el escalado.
| String |
scale_method (Opcional) | Especifica el vértice que se utilizará para el cálculo de la escala.
| String |
use_curvature (Opcional) | Especifica si se utilizará la curvatura de la Tierra para generar el cordón montañoso a partir de una superficie funcional. Esta opción sólo está disponible cuando se especifica una superficie de ráster para el parámetro in_surface.
| Boolean |
use_refraction (Opcional) | Especifica si se aplicará refracción atmosférica al generar el cordón montañoso a partir de una superficie funcional. Esta opción sólo está disponible cuando se especifica una superficie de ráster para el parámetro in_surface.
| Boolean |
refraction_factor (Opcional) | El coeficiente de refracción que se utilizará si se aplica refracción atmosférica. El valor predeterminado es 0,13. | Double |
pyramid_level_resolution (Opcional) | La tolerancia Z o la resolución del tamaño de la ventana del nivel de pirámide de terreno que se utilizará. El valor predeterminado es 0, o resolución completa. | Double |
create_silhouettes (Opcional) | Especifica si las entidades de salida representarán horizontes o siluetas.
| 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.Skyline_3d("observers.shp", "skyline_output.shp", "sample.gdb/featuredataset/terrain")
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"
# Make sure output has a unique name
outFC = arcpy.CreateUniqueName("skyline_output.shp")
inSurface = "sample.gdb/featuredataset/terrain"
obstructionFCs = "buildings.shp; billboards.shp"
surfRad = "1000 meters"
surfElev = "100 meters"
LOD = "FULL_DETAIL"
fromAzim = 0
toAzim = 360
incAzim = 1
maxHorizRad = 0
segSky = "SEGMENT_SKYLINE"
scale = 100
scaleAcc = "ELEVATION"
scaleMethod = "SKYLINE_MAXIMUM"
# Execute Skyline
arcpy.Skyline_3d(inPts, outFC, inSurface, surfRad, surfElev,
obstructionFCs, LOD, fromAzim, toAzim, incAzim,
maxHorizRad, segSky, scale, scaleAcc, scaleMethod)
Entornos
Casos especiales
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst