Crear cuenca visual (Análisis ráster)

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

Ilustración de 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

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

Superficie de elevación que se 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 (x,y) para calcular un factor z para el análisis de la cuenca visual. Sin un sistema de coordenadas verticales y sin información de unidad z disponible, la herramienta considera que la unidad z es la misma que la unidad x,y. El resultado es un factor z interno de 1.0 que se usará 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)

Especifica el método de optimización que se utilizará para calcular la cuenca visual.

  • VelocidadLa velocidad de procesamiento se optimizará a costa de la precisión del resultado para mejorar el rendimiento. Esta es la opción predeterminada.
  • PrecisiónLa precisión de los resultados se optimizará a expensas de un tiempo de procesamiento más largo.
String
Tipo de distancia de visualización máxima
(Opcional)

Especifica cómo se 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.

  • DistanciaLa distancia máxima se determinará en función del valor que especifique. Este es el método predeterminado.
  • CampoLa distancia máxima de cada ubicación de observador se determinará en función de los valores de un campo que especifica el usuario.
String
Distancia de visualización máxima
(Opcional)

Distancia de valor límite que se utilizará y 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)

Campo que contiene la distancia de visualización máxima correspondiente a cada observador. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad x,y 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)

Especifica cómo se 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.

  • DistanciaLa distancia mínima se determinará en función del valor que especifique. Este es el método predeterminado.
  • CampoLa distancia mínima de cada ubicación de observador se determinará en función de los valores de un campo que especifica el usuario.
String
Distancia de visualización mínima
(Opcional)

Distancia que se utilizará y 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)

Campo que contiene la distancia de visualización mínima correspondiente a cada observador. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad x,y 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
Las distancias de visualización son en 3D
(Opcional)

Especifica si los valores de los parámetros de distancia de visualización mínima y máxima se medirán en 3D o 2D. 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 proporciona un valor más realista al tener en cuenta las alturas relativas.

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

Especifica cómo se 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ónLa elevación del observador se determinará en función del valor especificado por el usuario. Este es el método predeterminado.
  • CampoLa elevación de cada ubicación de observador se determinará en función de los valores de un campo que especifica el usuario.
String
Elevación de los observadores
(Opcional)

Elevación que se utilizará para las ubicaciones de observador.

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)

Campo que contiene 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)

Especifica cómo se 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.

  • AlturaLa altura del observador se determinará en función del valor que especifique. Este es el método predeterminado.
  • CampoLa altura de cada ubicación de observador se determinará en función de los valores de un campo que especifica el usuario.
String
Altura de los observadores
(Opcional)

Altura que se utilizará para las ubicaciones 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..

El valor predeterminado es 6 pies internacionales.

Linear Unit
Campo de altura de los observadores
(Opcional)

Campo que contiene 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)

Especifica cómo se determinará la altura del objetivo.

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

  • AlturaLa altura del objetivo se determinará en función del valor que especifique. Este es el método predeterminado.
  • CampoLa altura de cada objetivo se determinará en función de los valores de un campo que especifica el usuario.
String
Altura del objetivo
(Opcional)

Altura de las estructuras o personas sobre el suelo que se utilizará 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)

Campo que contiene 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)

Nombre del 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. 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

Superficie de elevación que se 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 (x,y) para calcular un factor z para el análisis de la cuenca visual. Sin un sistema de coordenadas verticales y sin información de unidad z disponible, la herramienta considera que la unidad z es la misma que la unidad x,y. El resultado es un factor z interno de 1.0 que se usará 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)

Especifica el método de optimización que se utilizará para calcular la cuenca visual.

  • SPEEDLa velocidad de procesamiento se optimizará a costa de la precisión del resultado para mejorar el rendimiento. Esta es la opción predeterminada.
  • ACCURACYLa precisión de los resultados se optimizará a expensas de un tiempo de procesamiento más largo.
String
maximumViewingDistanceType
(Opcional)

Especifica cómo se determinará la distancia de visualización máxima.

  • DISTANCELa distancia máxima se determinará en función del valor que especifique. Este es el método predeterminado.
  • FIELDLa distancia máxima de cada ubicación de observador se determinará en función de los valores de un campo que especifica el usuario.
String
maximumViewingDistance
(Opcional)

Distancia de valor límite que se utilizará y 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)

Campo que contiene la distancia de visualización máxima correspondiente a cada observador. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad x,y 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)

Especifica cómo se determinará la distancia visible mínima.

  • DISTANCELa distancia mínima se determinará en función del valor que especifique. Este es el método predeterminado.
  • FIELDLa distancia mínima de cada ubicación de observador se determinará en función de los valores de un campo que especifica el usuario.
String
minimumViewingDistance
(Opcional)

Distancia que se utilizará y 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)

Campo que contiene la distancia de visualización mínima correspondiente a cada observador. Los valores contenidos en el campo deberán estar expresados en la misma unidad que la unidad x,y 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)

Especifica si los valores de los parámetros de distancia de visualización mínima y máxima se medirán en 3D o 2D. 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 proporciona un valor más realista al tener en cuenta las alturas relativas.

  • 2DLa distancia de visualización se medirá en la distancia 2D. Esta es la opción predeterminada.
  • 3DLa distancia de visualización se medirá en la distancia 3D
Boolean
observersElevationType
(Opcional)

Especifica cómo se determinará la elevación de los observadores.

  • ELEVATIONLa elevación del observador se determinará en función del valor especificado por el usuario. Este es el método predeterminado.
  • FIELDLa elevación de cada ubicación de observador se determinará en función de los valores de un campo que especifica el usuario.
String
observersElevation
(Opcional)

Elevación que se utilizará para las ubicaciones de observador.

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)

Campo que contiene 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)

Especifica cómo se determinará la altura de los observadores.

  • HEIGHTLa altura del observador se determinará en función del valor que especifique. Este es el método predeterminado.
  • FIELDLa altura de cada ubicación de observador se determinará en función de los valores de un campo que especifica el usuario.
String
observersHeight
(Opcional)

Altura que se utilizará para las ubicaciones de observador.

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)

Campo que contiene 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)

Especifica cómo se determinará la altura del objetivo.

  • HEIGHTLa altura del objetivo se determinará en función del valor que especifique. Este es el método predeterminado.
  • FIELDLa altura de cada objetivo se determinará en función de los valores de un campo que especifica el usuario.
String
targetHeight
(Opcional)

Altura de las estructuras o personas sobre el suelo que se utilizará 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)

Campo que contiene 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)

Nombre del 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. 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 especificada 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 especificada 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)

Información de licenciamiento

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

Temas relacionados