| Etiqueta | Explicación | Tipo de datos |
Superficie de entrada | Capa de escena de malla integrada, dataset LAS, ráster, TIN o superficie de terreno que se utilizará para determinar la visibilidad. | TIN Layer; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Scene Layer; File |
Entidades de línea de entrada | Entidades de línea de visión cuyo primer vértice define el punto de observación y el último vértice identifica la ubicación de destino. Si las líneas de visión son entidades 2D, las alturas del observador y del objetivo se derivarán de la superficie de entrada. Si las líneas de visión son entidades 3D, las alturas del observador y del objetivo se obtendrán a partir de las coordenadas z del elemento. Las líneas 2D se evaluarán con un desplazamiento respecto a la superficie subyacente. Se aplica un desplazamiento predeterminado de 1 para elevar los puntos por encima de la superficie. Utilice un campo denominado OffsetA para definir una altura de desplazamiento personalizada para el observador; utilice un campo denominado OffsetB para definir un desplazamiento personalizado para el objetivo. | Feature Layer |
Clase de entidad de salida | Clase de entidad de línea de salida a lo largo de la cual se determinará la visibilidad. | Feature Class |
Clase de entidad de puntos de obstrucción de salida (Opcional) | Una clase de entidad de punto opcional que identifica la ubicación de la primera obstrucción sobre la línea de visión del observador a su destino. | Feature Class |
Utilizar curvatura (Opcional) |
Especifica si se considerará la curvatura de la Tierra para el análisis de línea de visión. Para activar este parámetro, la superficie debe tener una referencia espacial definida en coordenadas proyectadas con unidades z definidas.
| Boolean |
Utilizar refracción (Opcional) |
Especifica si se tendrá en cuenta la refracción atmosférica al generar una línea de visión a partir de una superficie funcional. Este parámetro no se aplica si se utilizan entidades multiparche.
| Boolean |
Factor de refracción (Opcional) | Valor que se utilizará en el factor de refracción. 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, que indica resolución completa. | Double |
Entidades de entrada (Opcional) | Una entidad multiparche que puede definir elementos de obstrucción adicionales, como edificios. Las opciones de refracción no se respetan para esta entrada. | Feature Layer |
Atributos de creación de gráficos de salida (Opcional) | Especifica si los atributos de línea de visión de salida incluirán campos adicionales con información que pueda utilizarse en un gráfico de perfil. Los valores de estos campos proporcionan la información necesaria para generar un gráfico de perfil que incluye una representación del observador, la obstrucción potencial y el punto objetivo de cada línea de visión, junto con la visibilidad de la línea de visión directa que conecta al observador con el objetivo.
| Boolean |
Resumen
Determina la visibilidad de las líneas de visión sobre obstáculos formados por una superficie y un dataset multiparche opcional.
Ilustración
Uso
Solo los extremos de la línea de entrada se utilizan para definir el observador y el destino. Las líneas de visión deberían ser líneas rectas compuestas por dos vértices que representan el punto de observación y la ubicación de destino para la cual se determina la visibilidad.
Considere la posibilidad de crear líneas de visión con la herramienta Construir líneas de visión si los destinos de visibilidad residen en una clase de entidad diferente. Por ejemplo, las líneas de visión pueden generarse mediante el muestreo de una entidad de línea objetivo en un intervalo específico para comprobar la visibilidad a lo largo de un recorrido.
Las líneas de salida se dividirán a lo largo de las partes visibles e invisibles de la línea de visión de entrada. Si solo se utiliza una superficie para determinar la visibilidad de la línea de visión, las líneas de salida seguirán el perfil de la superficie. Si se proporciona una entidad multiparche al calcular la línea de visión, las líneas de salida seguirán la trayectoria de las líneas de visión de entrada.
La clase de entidad de la línea de salida incluirá los siguientes campos:
- SourceOID- Id. único de la entidad de línea de entrada que se utiliza en el cálculo de la visibilidad.
- VisCode- indica si la línea de salida representa una parte visible o no de la línea de visión. Cada línea de visión puede dividirse en múltiples entidades en función de si la línea de visión está parcialmente obstruida. Este atributo identifica el estado de visibilidad de cada porción de dichas líneas de visión. Un valor de 1 indica que la línea es visible, y un valor de 2 indica que no es visible. Este campo solo existirá en las entidades de línea de salida.
- TarIsVis- indica si el punto objetivo es visible desde el punto de observador. Un valor de 1 indica que el objetivo es visible, y un valor de 0 indica que no es visible. Este campo solo existirá en las entidades de línea de salida.
- OBSTR_MPID- obstáculo que bloquea la visibilidad del punto de destino. Se creará una entidad de línea separada para las partes visibles y obstruidas de cada línea de visión de entrada. La parte que no está obstruida tendrá un valor de -9999, la parte obstruida por un multiparche tendrá el Id. único de la entidad que crea la obstrucción, y la parte obstruida por la superficie tendrá un valor de -1.
Si el parámetro Atributos de creación de gráficos de salida está seleccionado, la clase de entidad de línea de salida tendrá los siguientes campos adicionales:
- OBSERVERZ- elevación del punto del observador, que incluye cualquier desplazamiento vertical que pueda haberse aplicado.
- TARGETZ- elevación del punto objetivo, que incluye cualquier desplazamiento vertical que se haya podido aplicar.
- OBSTR_DIST- distancia horizontal desde el observador hasta el punto que obstruye la visibilidad del objetivo. Cuando la línea de visión no esté obstruida, este valor será -1,0.
Parámetros
arcpy.ddd.LineOfSight(in_surface, in_line_feature_class, out_los_feature_class, {out_obstruction_feature_class}, {use_curvature}, {use_refraction}, {refraction_factor}, {pyramid_level_resolution}, {in_features}, {output_graphing_attributes})| Nombre | Explicación | Tipo de datos |
in_surface | Capa de escena de malla integrada, dataset LAS, ráster, TIN o superficie de terreno que se utilizará para determinar la visibilidad. | TIN Layer; Raster Layer; Mosaic Layer; Terrain Layer; LAS Dataset Layer; Scene Layer; File |
in_line_feature_class | Entidades de línea de visión cuyo primer vértice define el punto de observación y el último vértice identifica la ubicación de destino. Si las líneas de visión son entidades 2D, las alturas del observador y del objetivo se derivarán de la superficie de entrada. Si las líneas de visión son entidades 3D, las alturas del observador y del objetivo se obtendrán a partir de las coordenadas z del elemento. Las líneas 2D se evaluarán con un desplazamiento respecto a la superficie subyacente. Se aplica un desplazamiento predeterminado de 1 para elevar los puntos por encima de la superficie. Utilice un campo denominado OffsetA para definir una altura de desplazamiento personalizada para el observador; utilice un campo denominado OffsetB para definir un desplazamiento personalizado para el objetivo. | Feature Layer |
out_los_feature_class | Clase de entidad de línea de salida a lo largo de la cual se determinará la visibilidad. | Feature Class |
out_obstruction_feature_class (Opcional) | Una clase de entidad de punto opcional que identifica la ubicación de la primera obstrucción sobre la línea de visión del observador a su destino. | Feature Class |
use_curvature (Opcional) |
Especifica si se considerará la curvatura de la Tierra para el análisis de línea de visión. Para habilitar este parámetro, la superficie debe tener una referencia espacial definida en coordenadas proyectadas con unidades z definidas.
| Boolean |
use_refraction (Opcional) |
Especifica si se tendrá en cuenta la refracción atmosférica al generar una línea de visión a partir de una superficie funcional. Este parámetro no se aplica si se utilizan entidades multiparche.
| Boolean |
refraction_factor (Opcional) | Valor que se utilizará en el factor de refracción. 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, que indica resolución completa. | Double |
in_features (Opcional) | Una entidad multiparche que puede definir elementos de obstrucción adicionales, como edificios. Las opciones de refracción no se respetan para esta entrada. | Feature Layer |
output_graphing_attributes (Opcional) | Especifica si los atributos de línea de visión de salida incluirán campos adicionales con información que pueda utilizarse en un gráfico de perfil. Los valores de estos campos proporcionan la información necesaria para generar un gráfico de perfil que incluye una representación del observador, la obstrucción potencial y el punto objetivo de cada línea de visión, junto con la visibilidad de la línea de visión directa que conecta al observador con el objetivo.
| 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.ddd.LineOfSight("tin", "line.shp", "los.shp", "buldings_multipatch.shp",
"obstruction.shp")En el siguiente ejemplo se muestra cómo usar esta herramienta en un script independiente de Python.
'''*********************************************************************
Name: Sight Line Visibility of Parade Path
Description: This script demonstrates how to create a sight line feature class
from a pair of observer and target points.
*********************************************************************'''
# Import system modules
import arcpy
# Set Local Variables:
arcpy.env.workspace = 'C:/data'
# Setting up input and output variables:
obs = "observer_pts.shp"
tar = "parade_path.shp"
sightlines = "output_sightlines.shp"
height = "<None>"
join_field = "#"
sampling = 0.5
direction = "OUTPUT_THE_DIRECTION"
surface = 'elevation.tif'
bldgs = 'buildings.shp'
arcpy.ddd.ConstructSightLines(obs, tar, sightlines, height, height,
join_field, sampling, direction)
arcpy.ddd.LineOfSight(surface, sightlines, "Parade_LOS.shp",
"Obstructions.shp", in_features=bldgs)Entornos
Información de licenciamiento
- Basic: Requiere 3D Analyst
- Standard: Requiere 3D Analyst
- Advanced: Requiere 3D Analyst