Volver al principio

Crear cuenca visual (Análisis ráster)

En este tema

  1. Resumen
  2. Ilustración
  3. Uso
  4. Parámetros
  5. Entornos
  6. Información de licenciamiento

Resumen

Crea áreas en las que un observador puede ver objetos sobre el terreno. Los puntos de observador de entrada pueden representar observadores (como por ejemplo, personas en el suelo o puestos de vigilancia en una torre de control de incendios) u objetos observados (como por ejemplo aerogeneradores, torres de agua, vehículos u otras personas).

Tanto los observadores como los objetos observados pueden tener una altura por encima del suelo y estas alturas se utilizan para determinar la visibilidad. Por ejemplo, una cuenca visual calculada para aerogeneradores de 90 metros y una persona de 1,80 m de pie en el suelo normalmente será mayor que una cuenca visual calculada para aerogeneradores de 60 metros y una persona de 1,50 m.

La capa de resultados registra la cantidad de veces que los puntos de observación de entrada pueden ver cada ubicación de celda en el ráster de superficie de entrada. Las celdas no visibles reciben valores NoData.

Ilustración

Herramienta Crear cuenca visual

Uso

  • Esta herramienta del portal de análisis de ráster está disponible al iniciar sesión en un portal de ArcGIS Enterprise que tenga configurado ArcGIS Image Server para Análisis de ráster. Cuando se ejecuta la herramienta, ArcGIS Pro funciona como cliente y el procesamiento tiene lugar en los servidores federados con ArcGIS Enterprise. La herramienta del portal acepta las capas de su portal como entrada y crea la salida en su portal.

    La capa ráster de entrada admite una capa del portal, una URI o URL de un servicio de imágenes o la salida procedente de la herramienta Crear capa de servidor de imágenes. La capa de entidades de entrada puede ser una capa del portal o una URI o URL de un servicio de entidades. Esta herramienta no admite capas o datos ráster locales. Aunque puede usar las capas y los datos de entidades locales como entradas de esta herramienta del portal, la práctica recomendada es usar capas del portal como entrada.

  • La visibilidad de cada centro de celda viene determinada por una prueba de línea de visión entre el destino y el observador.

Parámetros

Cuadro de diálogoPython

EtiquetaExplicaciónTipo de datos
Superficie de elevación de entrada

La superficie de elevación que se va a utilizar para calcular la cuenca visual.

Si la unidad vertical de la superficie de entrada es distinta de la unidad horizontal, por ejemplo, cuando los valores de elevación se representan en pies, pero el sistema de coordenadas está en metros, la superficie debe tener definido un sistema de coordenadas verticales. Esto se debe a que la herramienta utiliza las unidades verticales (Z) y horizontales (XY) para calcular un factor z para el análisis de la cuenca visual. Sin un sistema de coordenadas verticales y, por lo tanto, sin información de unidad Z disponible, la herramienta considerará que la unidad Z es la misma que la unidad XY. Como resultado, se utilizará un factor z interno de 1.0 para el análisis, lo que puede dar lugar a resultados inesperados.

La superficie de elevación puede ser un entero o un punto flotante.

Raster Layer; Image Service; String
Entidades de observador

Las entidades de puntos que representan las ubicaciones del observador al calcular las cuencas visuales.

Feature Set
Nombre de salida

Nombre del servicio ráster de salida.

El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.

String
Optimizar para
(Opcional)

El método de optimización que se va a utilizar para calcular la cuenca visual.

  • Velocidad—Este método optimiza la velocidad de procesamiento y ajusta la exactitud del resultado para obtener un mayor rendimiento. Esta es la opción predeterminada.
  • Precisión—Este método está optimizado para la exactitud en los resultados, en detrimento de un tiempo de procesamiento más largo.
String
Tipo de distancia de visualización máxima
(Opcional)

El método que se usará para determinar la distancia de visualización máxima.

Si cambia el tipo de Distancia a Campo, el parámetro Distancia de visualización máxima cambiará a Campo de distancia de visualización máxima.

  • Distancia—La distancia máxima viene definida por un valor especificado por el usuario. Este es el método predeterminado.
  • Campo—La distancia máxima de cada ubicación de observador viene determinada por los valores de un campo especificado por el usuario.
String
Distancia de visualización máxima
(Opcional)

Es una distancia de valor límite en la que se detiene el cómputo de las áreas visibles. Más allá de esta distancia, no se sabe si los puntos de observador y el resto de objetos pueden verse mutuamente.

Los valores de unidad son: kilómetros, metros, millas terrestres, yardas internacionales, pies internacionales, millas de agrimensura de EE. UU., yardas topográficas de EE. UU. y pies de agrimensura de EE. UU..

El valor predeterminado es 9 millas terrestres.

Linear Unit
Campo de distancia de visualización máxima
(Opcional)

Este campo se puede usar para especificar la distancia de visualización máxima para cada observador. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad XY de la superficie de elevación de entrada.

La distancia de visualización máxima es una distancia de valor límite en la que se detiene el cómputo de las áreas visibles. Más allá de esta distancia, no se sabe si los puntos de observador y el resto de objetos pueden verse mutuamente.

Field
Tipo de distancia de visualización mínima
(Opcional)

Elija el método que se usará para determinar la distancia visible mínima.

Si cambia el tipo de Distancia a Campo, el parámetro Distancia de visualización mínima cambiará a Campo de distancia de visualización mínima.

  • Distancia—La distancia mínima viene definida por un valor especificado por el usuario. Este es el método predeterminado.
  • Campo—La distancia mínima de cada ubicación de observador viene determinada por los valores de un campo especificado por el usuario.
String
Distancia de visualización mínima
(Opcional)

Es la distancia en la que empieza el cómputo de las áreas visibles. Las celdas de la superficie que están a menos de esta distancia no son visibles en la salida, pero pueden seguir bloqueando la visibilidad de las celdas situadas entre la distancia de visualización mínima y la máxima.

Los valores de unidad son: kilómetros, metros, millas terrestres, yardas internacionales, pies internacionales, millas de agrimensura de EE. UU., yardas topográficas de EE. UU. y pies de agrimensura de EE. UU..

Linear Unit
Campo de distancia de visualización mínima
(Opcional)

Este campo se puede usar para especificar la distancia de visualización mínima para cada observador. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad XY de la superficie de elevación de entrada.

La distancia de visualización mínima define dónde empieza el cómputo de las áreas visibles. Las celdas de la superficie que están a menos de esta distancia no son visibles en la salida, pero pueden seguir bloqueando la visibilidad de las celdas situadas entre la distancia de visualización mínima y la máxima.

Field
La distancia de visualización es 3D
(Opcional)

Especifique si los parámetros de distancia de visualización mínima y máxima se van a medir de forma tridimensional o bidimensional. Una distancia 2D es la distancia lineal simple medida entre un observador y el objetivo utilizando sus ubicaciones proyectadas a nivel del mar. Una distancia 3D ofrece un valor más realista al tener en cuenta las alturas relativas.

  • Activado: la distancia de visualización se mide en la distancia 3D.
  • Desactivado: la distancia de visualización se mide en la distancia 2D. Esta es la opción predeterminada.
Boolean
Tipo de elevación de observador
(Opcional)

El método que se usará para determinar la elevación de los observadores.

Si cambia el tipo de Elevación a Campo, el parámetro Elevación de los observadores cambiará a Campo de elevación de los observadores.

  • Elevación—La elevación del observador viene definida por un valor especificado por el usuario. Este es el método predeterminado.
  • Campo—La elevación de cada ubicación de observador viene determinada por los valores de un campo especificado por el usuario.
String
Elevación de los observadores
(Opcional)

Es la elevación de las ubicaciones de los observadores.

Si no se especifica este parámetro, la elevación del observador se obtendrá del ráster de superficie mediante interpolación bilineal. Si se establece un valor para este parámetro, ese valor se aplicará a todos los observadores. Para especificar valores diferentes para cada observador, establezca este parámetro en un campo en las entidades de observador de entrada.

Los valores de unidad son: kilómetros, metros, millas terrestres, yardas internacionales, pies internacionales, millas de agrimensura de EE. UU., yardas topográficas de EE. UU. y pies de agrimensura de EE. UU..

Linear Unit
Campo de elevación de los observadores
(Opcional)

Este campo se puede usar para especificar la elevación de los observadores. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad Z de la superficie de elevación de entrada.

Si no se especifica este parámetro, la elevación del observador se obtendrá del ráster de superficie mediante interpolación bilineal.

Field
Tipo de altura de observadores
(Opcional)

El método que se usará para determinar la altura de los observadores.

Si cambia el tipo de Altura a Campo, el parámetro Altura de los observadores cambiará a Campo de altura de los observadores.

  • Altura—La altura del observador se obtiene del valor especificado. Este es el método predeterminado.
  • Campo—La altura de cada ubicación de observador viene determinada por los valores de un campo especificado por el usuario.
String
Altura de los observadores
(Opcional)

Es la altura utilizada para las ubicaciones de los observadores.

Los valores de unidad son: kilómetros, metros, millas terrestres, yardas internacionales, pies internacionales, millas de agrimensura de EE. UU., yardas topográficas de EE. UU. y pies de agrimensura de EE. UU..

El valor predeterminado es 6 pies internacionales.

Linear Unit
Campo de altura de los observadores
(Opcional)

Este campo se puede usar para especificar la altura de los observadores. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad Z de la superficie de elevación de entrada.

Field
Tipo de altura del objetivo
(Opcional)

El método que se usará para determinar la altura de los objetivos.

Si cambia el tipo de Altura a Campo, el parámetro Altura del objetivo cambiará a Campo de altura del objetivo.

  • Altura—La altura del objetivo se obtiene del valor especificado. Este es el método predeterminado.
  • Campo—La altura de cada objetivo viene determinada por los valores de un campo especificado por el usuario.
String
Altura del objetivo
(Opcional)

Es la altura de estructuras o personas en el suelo, utilizada para establecer la visibilidad. La cuenca visual resultante se compone de las áreas en las que un punto de observador puede ver estos otros objetos. Lo contrario también es cierto; los objetos pueden ver un punto de observador.

Los valores de unidad son: kilómetros, metros, millas terrestres, yardas internacionales, pies internacionales, millas de agrimensura de EE. UU., yardas topográficas de EE. UU. y pies de agrimensura de EE. UU..

Linear Unit
Campo de altura del objetivo
(Opcional)

Este campo se usa para especificar la altura de los objetivos. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad Z de la superficie de elevación de entrada.

Field
Nombre de salida sobre el nivel del suelo
(Opcional)

El nombre del ráster sobre el nivel del 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. Se asignará 0 a las celdas que ya estaban visibles en este ráster de salida.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de cuenca visual de salida.

Raster Layer
Ráster sobre el nivel del suelo de salida

El ráster sobre el nivel del suelo de salida.

Raster Layer

arcpy.ra.CreateViewshed(inputElevationSurface, inputObserverFeatures, outputName, {optimizeFor}, {maximumViewingDistanceType}, {maximumViewingDistance}, {maximumViewingDistanceField}, {minimumViewingDistanceType}, {minimumViewingDistance}, {minimumViewingDistanceField}, {viewingDistanceIs3D}, {observersElevationType}, {observersElevation}, {observersElevationField}, {observersHeightType}, {observersHeight}, {observersHeightField}, {targetHeightType}, {targetHeight}, {targetHeightField}, {aboveGroundLevelOutputName})
NombreExplicaciónTipo de datos
inputElevationSurface

La superficie de elevación que se va a utilizar para calcular la cuenca visual.

Si la unidad vertical de la superficie de entrada es distinta de la unidad horizontal, por ejemplo, cuando los valores de elevación se representan en pies, pero el sistema de coordenadas está en metros, la superficie debe tener definido un sistema de coordenadas verticales. Esto se debe a que la herramienta utiliza las unidades verticales (Z) y horizontales (XY) para calcular un factor z para el análisis de la cuenca visual. Sin un sistema de coordenadas verticales y, por lo tanto, sin información de unidad Z disponible, la herramienta considerará que la unidad Z es la misma que la unidad XY. Como resultado, se utilizará un factor z interno de 1.0 para el análisis, lo que puede dar lugar a resultados inesperados.

La superficie de elevación puede ser un entero o un punto flotante.

Raster Layer; Image Service; String
inputObserverFeatures

Las entidades de puntos que representan las ubicaciones del observador al calcular las cuencas visuales.

Feature Set
outputName

Nombre del servicio ráster de salida.

El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.

String
optimizeFor
(Opcional)

El método de optimización que se va a utilizar para calcular la cuenca visual.

  • SPEED—Este método optimiza la velocidad de procesamiento y ajusta la exactitud del resultado para obtener un mayor rendimiento. Esta es la opción predeterminada.
  • ACCURACY—Este método está optimizado para la exactitud en los resultados, en detrimento de un tiempo de procesamiento más largo.
String
maximumViewingDistanceType
(Opcional)

El método que se usará para determinar la distancia de visualización máxima.

  • DISTANCE—La distancia máxima viene definida por un valor especificado por el usuario. Este es el método predeterminado.
  • FIELD—La distancia máxima de cada ubicación de observador viene determinada por los valores de un campo especificado por el usuario.
String
maximumViewingDistance
(Opcional)

Es una distancia de valor límite en la que se detiene el cómputo de las áreas visibles. Más allá de esta distancia, no se sabe si los puntos de observador y el resto de objetos pueden verse mutuamente.

Los valores de unidad son Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards y Feet.

El valor predeterminado es 9 millas terrestres.

Linear Unit
maximumViewingDistanceField
(Opcional)

Este campo se puede usar para especificar la distancia de visualización máxima para cada observador. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad XY de la superficie de elevación de entrada.

La distancia de visualización máxima es una distancia de valor límite en la que se detiene el cómputo de las áreas visibles. Más allá de esta distancia, no se sabe si los puntos de observador y el resto de objetos pueden verse mutuamente.

Field
minimumViewingDistanceType
(Opcional)

Elija el método que se usará para determinar la distancia visible mínima.

  • DISTANCE—La distancia mínima viene definida por un valor especificado por el usuario. Este es el método predeterminado.
  • FIELD—La distancia mínima de cada ubicación de observador viene determinada por los valores de un campo especificado por el usuario.
String
minimumViewingDistance
(Opcional)

Es la distancia en la que empieza el cómputo de las áreas visibles. Las celdas de la superficie que están a menos de esta distancia no son visibles en la salida, pero pueden seguir bloqueando la visibilidad de las celdas situadas entre la distancia de visualización mínima y la máxima.

Los valores de unidad son Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards y Feet.

Linear Unit
minimumViewingDistanceField
(Opcional)

Este campo se puede usar para especificar la distancia de visualización mínima para cada observador. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad XY de la superficie de elevación de entrada.

La distancia de visualización mínima define dónde empieza el cómputo de las áreas visibles. Las celdas de la superficie que están a menos de esta distancia no son visibles en la salida, pero pueden seguir bloqueando la visibilidad de las celdas situadas entre la distancia de visualización mínima y la máxima.

Field
viewingDistanceIs3D
(Opcional)

Especifique si los parámetros de distancia de visualización mínima y máxima se van a medir de forma tridimensional o bidimensional. Una distancia 2D es la distancia lineal simple medida entre un observador y el objetivo utilizando sus ubicaciones proyectadas a nivel del mar. Una distancia 3D ofrece un valor más realista al tener en cuenta las alturas relativas.

  • 2D—La distancia de visualización se mide en la distancia 2D. Esta es la opción predeterminada.
  • 3D—La distancia de visualización se mide en la distancia 3D
Boolean
observersElevationType
(Opcional)

El método que se usará para determinar la elevación de los observadores.

  • ELEVATION—La elevación del observador viene definida por un valor especificado por el usuario. Este es el método predeterminado.
  • FIELD—La elevación de cada ubicación de observador viene determinada por los valores de un campo especificado por el usuario.
String
observersElevation
(Opcional)

Es la elevación de las ubicaciones de los observadores.

Si no se especifica este parámetro, la elevación del observador se obtendrá del ráster de superficie mediante interpolación bilineal. Si se establece un valor para este parámetro, ese valor se aplicará a todos los observadores. Para especificar valores diferentes para cada observador, establezca este parámetro en un campo en las entidades de observador de entrada.

Los valores de unidad son Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards y Feet.

Linear Unit
observersElevationField
(Opcional)

Este campo se puede usar para especificar la elevación de los observadores. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad Z de la superficie de elevación de entrada.

Si no se especifica este parámetro, la elevación del observador se obtendrá del ráster de superficie mediante interpolación bilineal.

Field
observersHeightType
(Opcional)

El método que se usará para determinar la altura de los observadores.

  • HEIGHT—La altura del observador se obtiene del valor especificado. Este es el método predeterminado.
  • FIELD—La altura de cada ubicación de observador viene determinada por los valores de un campo especificado por el usuario.
String
observersHeight
(Opcional)

Es la altura utilizada para las ubicaciones de los observadores.

Los valores de unidad son Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards y Feet.

El valor predeterminado es 6 pies internacionales.

Linear Unit
observersHeightField
(Opcional)

Este campo se puede usar para especificar la altura de los observadores. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad Z de la superficie de elevación de entrada.

Field
targetHeightType
(Opcional)

El método que se usará para determinar la altura de los objetivos.

  • HEIGHT—La altura del objetivo se obtiene del valor especificado. Este es el método predeterminado.
  • FIELD—La altura de cada objetivo viene determinada por los valores de un campo especificado por el usuario.
String
targetHeight
(Opcional)

Es la altura de estructuras o personas en el suelo, utilizada para establecer la visibilidad. La cuenca visual resultante se compone de las áreas en las que un punto de observador puede ver estos otros objetos. Lo contrario también es cierto; los objetos pueden ver un punto de observador.

Los valores de unidad son Kilometers, Meters, MilesInt, YardsInt, FeetInt, Miles, Yards y Feet.

Linear Unit
targetHeightField
(Opcional)

Este campo se usa para especificar la altura de los objetivos. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad Z de la superficie de elevación de entrada.

Field
aboveGroundLevelOutputName
(Opcional)

El nombre del ráster sobre el nivel del 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. Se asignará 0 a las celdas que ya estaban visibles en este ráster de salida.

String

Salida derivada

NombreExplicaciónTipo de datos
outputRaster

El ráster de cuenca visual de salida.

Raster Layer
outputAboveGroundLevelRaster

El ráster sobre el nivel del suelo de salida.

Raster Layer

Muestra de código

Ejemplo 1 de CreateViewshed (ventana de Python)

En este ejemplo se crea un servicio de imágenes de cuenca visual usando la superficie dada y puntos de observador.

import arcpy

arcpy.ra.CreateViewshed(
    "https://myserver/rest/services/elevation/ImageServer", 
    "https://myserver/rest/services/destination/FeatureServer/0", 
    "outview1", "SPEED", "DISTANCE", "9 Miles", "#", "DISTANCE",
    "0 Meters", "#", "2D", "ELEVATION", "#", "#", "HEIGHT",
    "6 Feet", "#", "HEIGHT", "3 Feet", "#", "outagl1")
Ejemplo 2 de CreateViewshed (script independiente)

En este ejemplo se crea un servicio de imágenes de cuenca visual usando la superficie dada y puntos de observador.

#---------------------------------------------------------------------------
# Name: CreateViewshed_example02.py
# Description: Creates a viewshed image service raster from given surface
#   and observer points.
#
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inSurface = "https://myserver/rest/services/elevation/ImageServer"
inObservers = "https://myserver/rest/services/destination/FeatureServer/0"
outputViewshed = "outview1"
optimizeFor = "Speed"
maxDistType = "Distance"
maxDist = "9 Miles"
maxDistField = "#"
minDistType = "Distance"
minDist = "0 Miles"
minDistField = "#"
distanceIs3D = "2D"
obsElevationType = "Elevation"
obsElevation = "#"
obsElevationField = "#"
obsOffsetType = "Height"
obsOffset = "6 Feet"
obsOffsetField = "#"
surfOffsetType = "Height"
surfOffset = "3 Feet"
surfOffsetField = "#"
outputAgl = "outagl1"

# Execute Create Viewshed raster analysis tool
arcpy.ra.CreateViewshed(
    inSurface, inObservers, outputViewshed, optimizeFor,
    maxDistType, maxDist, maxDistField, minDistType, minDist,
    minDistField, distanceIs3D, obsElevationType, obsElevation,
    obsElevationField, obsOffsetType, obsOffset, obsOffsetField,
    surfOffsetType, surfOffset, surfOffsetField, outputAgl)

Entornos

Extensión, Tamaño de celda, Máscara, Sistema de coordenadas de salida, Pirámide, Alinear ráster

Información de licenciamiento

  • Basic: Requiere ArcGIS Image Server
  • Standard: Requiere ArcGIS Image Server
  • Advanced: Requiere ArcGIS Image Server

Temas relacionados

  • Descripción general del conjunto de herramientas Analizar terreno
  • Buscar una herramienta de geoprocesamiento
  • Cuenca visual geodésica
  • Función Cuenca visual

¿Algún comentario sobre este tema?

En este tema
  1. Resumen
  2. Ilustración
  3. Uso
  4. Parámetros
  5. Entornos
  6. Información de licenciamiento