Puntos de observador (Spatial Analyst)

Nivel de licencia:BasicStandardAdvanced

Resumen

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

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

Uso

Sintaxis

ObserverPoints (in_raster, in_observer_point_features, {z_factor}, {curvature_correction}, {refractivity_coefficient}, {out_agl_raster})
ParámetroExplicaciónTipo de datos
in_raster

Gá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
z_factor
(Opcional)

Cantidad de unidades x,y de suelo en una unidad z de superficie.

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 z y las unidades x,y 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)

Permite correcciones en 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)

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

Valor de retorno

NombreExplicaciónTipo 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

Ejemplo 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

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

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

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

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Requiere Spatial Analyst o 3D Analyst
ArcGIS for Desktop Standard: Requiere Spatial Analyst o 3D Analyst
ArcGIS for Desktop Advanced: Requiere Spatial Analyst o 3D Analyst
9/11/2013