Puntos de observador (3D Analyst)

Resumen

Identifica qué puntos de observador son visibles desde cada ubicación de superficie de ráster.

La herramienta Cuenca visual geodésica proporciona una funcionalidad o rendimiento mejorados.

Más información sobre cómo funciona Puntos de observador

Ilustración

Salida de Puntos de observador mostrada sobre una superficie de elevación sombreada

Uso

• Determinar los puntos de observación es un proceso que requiere muchos recursos informáticos. El tiempo de procesamiento depende de la resolución. En los estudios preliminares, puede utilizar un tamaño de celda más grueso para reducir la cantidad de celdas de la entrada. Utilice el ráster de resolución completa cuando los resultados finales estén listos para ser generados.

• Si en el ráster de entrada hay ruido no deseado causado por los errores de muestreo, puede suavizar el ráster con un filtro de paso bajo, como la opción Valor medio de la herramienta Estadísticas focalizadas, antes de ejecutar esta herramienta.

• La visibilidad de cada centro de celda se calcula comparando el ángulo de altitud hacia el centro de celda con el ángulo de altitud hacia el horizonte local. El horizonte local se obtiene teniendo en cuenta el terreno que interviene entre el punto de observación y el centro de la celda actual. Si el punto se encuentra por encima del horizonte local, se considera visible.

• La herramienta proporciona un ráster de salida sobre el nivel del suelo (AGL) opcional. Cada celda del ráster de salida AGL registra la altura mínima que se debe agregar a esa celda para que resulte visible al menos para un observador.

  Cuando las entidades de observador de entrada contienen varios observadores, el valor de salida es el mínimo de los valores de AGL de todos los observadores individuales.

• Cuando el ráster de entrada se deba remuestrear, se utilizará la técnica bilineal. Un ejemplo en el que se debe remuestrear un ráster de entrada se produce cuando el sistema de coordenadas de salida, la extensión o el tamaño de celda es diferente del de entrada.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster de entrada	Ráster de entrada de superficie.	Raster Layer
Entidades de puntos de observador de entrada	La clase de entidad de punto que identifica las ubicaciones del observador. El número máximo de puntos permitido es 16.	Feature Layer
Ráster de salida	El ráster de salida. La salida identifica exactamente qué puntos de observador son visibles desde cada ubicación de superficie de ráster.	Raster Dataset
Factor z (Opcional)	El número de unidades x, y de suelo en una superficie de unidades z. El factor z ajusta las unidades de medida para las unidades z cuando son diferentes de las unidades x, y de la superficie de entrada. Los valores z de la superficie de entrada se multiplican por el factor z al calcular la superficie de salida final. Si las unidades z y las unidades x,y están en las mismas unidades de medida, el factor z es 1. Esta es la opción predeterminada. Si las unidades x,y y las unidades z están en diferentes unidades de medida, el factor z se debe establecer en el factor adecuado o los resultados serán incorrectos. Por ejemplo, si las unidades z son pies y las unidades x,y son metros, debe utilizar un factor z de 0,3048 para convertir las unidades z de pies a metros (1 pie = 0,3048 metros).	Double
Utilizar las correcciones de la curvatura de la Tierra (Opcional)	Especifica si se aplicará la corrección de la curvatura de la Tierra. Desactivado: no se aplicará ninguna corrección de la curvatura. Esta es la opción predeterminada. Activado: se aplicará la corrección de la curvatura.	Boolean
Coeficiente de refracción (Opcional)	El coeficiente de la refracción de la luz visible en el aire. El valor predeterminado es 0,13.	Double
Ráster sobre el nivel del suelo de salida (Opcional)	El ráster de nivel sobre el suelo (AGL) de salida. El resultado del AGL es un ráster en el que cada valor de celda es la altura mínima que se debe agregar a una celda por lo demás no visible para que resulte visible al menos para un observador. Las celdas que ya estaban visibles tendrán un valor de 0 en este ráster de salida.	Raster Dataset

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	El ráster de salida. La salida identifica exactamente qué puntos de observador son visibles desde cada ubicación de superficie de ráster.	Raster

Python

arcpy.ddd.ObserverPoints(in_raster, in_observer_point_features, out_raster, {z_factor}, {curvature_correction}, {refractivity_coefficient}, {out_agl_raster})

Nombre	Explicación	Tipo de datos
in_raster	Ráster de entrada de superficie.	Raster Layer
in_observer_point_features	La clase de entidad de punto que identifica las ubicaciones del observador. El número máximo de puntos permitido es 16.	Feature Layer
out_raster	El ráster de salida. La salida identifica exactamente qué puntos de observador son visibles desde cada ubicación de superficie de ráster.	Raster Dataset
z_factor (Opcional)	El número de unidades x, y de suelo en una superficie de unidades z. El factor z ajusta las unidades de medida para las unidades z cuando son diferentes de las unidades x, y de la superficie de entrada. Los valores z de la superficie de entrada se multiplican por el factor z al calcular la superficie de salida final. Si las unidades z y las unidades x,y están en las mismas unidades de medida, el factor z es 1. Esta es la opción predeterminada. Si las unidades x,y y las unidades z están en diferentes unidades de medida, el factor z se debe establecer en el factor adecuado o los resultados serán incorrectos. Por ejemplo, si las unidades z son pies y las unidades x,y son metros, debe utilizar un factor z de 0,3048 para convertir las unidades z de pies a metros (1 pie = 0,3048 metros).	Double
curvature_correction (Opcional)	Especifica si se aplicará la corrección de la curvatura de la Tierra. FLAT_EARTH—No se aplicará ninguna corrección de la curvatura. Esta es la opción predeterminada. CURVED_EARTH—Se aplicará la corrección de la curvatura.	Boolean
refractivity_coefficient (Opcional)	El coeficiente de la refracción de la luz visible en el aire. El valor predeterminado es 0,13.	Double
out_agl_raster (Opcional)	El ráster de nivel sobre el suelo (AGL) de salida. El resultado del AGL es un ráster en el que cada valor de celda es la altura mínima que se debe agregar a una celda por lo demás no visible para que resulte visible al menos para un observador. Las celdas que ya estaban visibles tendrán un valor de 0 en este ráster de salida.	Raster Dataset

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	El ráster de salida. La salida identifica exactamente qué puntos de observador son visibles desde cada ubicación de superficie de ráster.	Raster

Muestra de código

Ejemplo 1 de ObserverPoints (ventana de Python)

En el ejemplo se identifica exactamente qué puntos de observador son visibles desde cada ubicación de superficie de ráster.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outObsPoints = ObserverPoints("elevation","observers.shp", 1, "CURVED_EARTH", 0.13)
outObsPoints.save("C:/sapyexamples/output/outobspnt01")

Ejemplo 2 de ObserverPoints (secuencia de comandos independiente)

En el ejemplo se identifica exactamente qué puntos de observador son visibles desde cada ubicación de superficie de ráster.

# Name: ObserverPoints_Ex_02.py
# Description: Identifies exactly which observer points are visible 
#              from each raster surface location.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "elevation"
inObsPoints = "observers.shp"
zFactor = 1
useEarthCurv = "CURVED_EARTH"
refractionVal = 0.13

# Execute ObserverPoints
outObsPoints = ObserverPoints(inRaster, inObsPoints, zFactor, 
                              useEarthCurv, refractionVal)

# Save the output 
outObsPoints.save("C:/sapyexamples/output/outobspnt02")

Ejemplo 1 de ObserverPoints (ventana de Python)

En el ejemplo se identifica exactamente qué puntos de observador son visibles desde cada ubicación de superficie de ráster.

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.ObserverPoints_3d("elevation","observers.shp", "C:/output/outobspnt01", 
                        1, "CURVED_EARTH", 0.13)

Ejemplo 2 de ObserverPoints (secuencia de comandos independiente)

En el ejemplo se identifica exactamente qué puntos de observador son visibles desde cada ubicación de superficie de ráster.

# Name: ObserverPoints_3d_Ex_02.py
# Description: Identifies exactly which observer points are visible 
#              from each raster surface location.
# Requirements: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inRaster = "elevation"
inObsPoints = "observers.shp"
outRaster = "C:/output/outobspnt02"
zFactor = 1
useEarthCurv = "CURVED_EARTH"
refractionVal = 0.13

# Execute ObserverPoints
arcpy.ddd.ObserverPoints(inRaster, inObsPoints, outRaster, zFactor, 
                         useEarthCurv, refractionVal)

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela