Cuenca visual (3D Analyst)

Nivel de licencia:BasicStandardAdvanced

Resumen

Determina las ubicaciones de superficies de ráster visibles a un conjunto de entidades de observación.

Más información sobre cómo funciona Cuenca visual

Uso

Sintaxis

Viewshed_3d (in_raster, in_observer_features, out_raster, {z_factor}, {curvature_correction}, {refractivity_coefficient}, {out_agl_raster})
ParámetroExplicaciónTipo de datos
in_raster

Ráster de entrada de superficie.

Raster Layer
in_observer_features

La clase de entidad que identifica las ubicaciones del observador.

La entrada puede ser entidades de punto o polilínea.

Feature Layer
out_raster

El ráster de salida.

La salida solo registrará la cantidad de veces que los puntos de observación de entrada (o vértices para polilíneas) pueden ver cada ubicación de celda en el ráster de superficie de entrada. La frecuencia de observación se registrará en el elemento VALOR en la tabla de atributos del ráster de salida.

Raster Dataset
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

Ejemplo de código

Ejemplo 1 de Cuenca visual (ventana de Python)

En este ejemplo se determinan las ubicaciones de superficie visibles para un conjunto de observadores definidos en un shapefile.

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Viewshed_3d("elevation", "observers.shp", "C:/output/outvwshd01", 2,
                  "CURVED_EARTH", 0.15)
Ejemplo 2 de Cuenca visual (secuencia de comandos independiente)

En este ejemplo se determinan las ubicaciones de superficie visibles para un conjunto de observadores definidos en un shapefile.

# Name: Viewshed_3d_Ex_02.py
# Description: Determines the raster surface locations visible to a set of
#              observer features.
# 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"
inObserverFeatures = "observers.shp"
outViewshed = "C:/output/outvwshd02"
zFactor = 2
useEarthCurvature = "CURVED_EARTH"
refractivityCoefficient = 0.15

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

# Execute Viewshed
arcpy.Viewshed_3d(inRaster, inObserverFeatures, outViewshed, zFactor,
                  useEarthCurvature, refractivityCoefficient)

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Requiere 3D Analyst o Spatial Analyst
ArcGIS for Desktop Standard: Requiere 3D Analyst o Spatial Analyst
ArcGIS for Desktop Advanced: Requiere 3D Analyst o Spatial Analyst
5/9/2014