Conexiones de región óptimas (Análisis ráster)

Resumen

Calcula las rutas de conectividad óptima entre dos o más regiones de entrada.

Ilustración

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.

• En un ráster, una región es un grupo de celdas con el mismo valor que son contiguas unas a otras (adyacentes). Cuando las regiones de entrada se identifican mediante un ráster, si hay zonas (celdas con el mismo valor) formadas por varias regiones, ejecute primero la herramienta Grupo de regiones de Spatial Analyst como paso de preprocesamiento para asignar valores únicos a cada región. Utilice el ráster resultante como las regiones de entrada de la herramienta Conexiones de región óptimas.

• Si las regiones de entrada son de ráster y el rango de los Id. de fila es muy grande (incluso si hay apenas unas pocas regiones), el rendimiento de esta herramienta puede verse perjudicado.

• Cuando la entrada de región es un servicio de entidades, las regiones se convierten internamente en un ráster antes de realizar el análisis.

  La resolución del ráster se puede controlar con el entorno Tamaño de celda. De forma predeterminada, si no se especifica ningún otro ráster en la herramienta, la resolución se determinará por medio del valor más bajo del ancho o la altura de la extensión de la entidad de entrada, en la referencia espacial de entrada, dividido entre 250.

• Si la entrada de la región es una entidad, se utilizará el campo ObjectID como identificadores de la región.

• Las ubicaciones identificadas por el parámetro Ráster de entrada o barreras de entidad o ubicaciones de celda con NoData en el parámetro Ráster de costes de entrada actúan como barreras.

• La extensión de procesamiento predeterminada es la misma que la del Ráster de costes de entrada, si se proporciona alguna, de lo contrario, se definirá según la extensión de las regiones de entrada.

• Los valores de ráster de costes que son negativos o cero no son válidos, pero se tratarán como valores positivos pequeños. El algoritmo de coste acumulativo es un proceso multiplicativo y no se puede calcular correctamente el coste acumulativo si los valores de coste son negativos o cero. Si el ráster de costes contiene esos valores y esas ubicaciones representan áreas que se van a excluir del análisis, active esas celdas en NoData antes de ejecutar la herramienta. Puede hacerlo con la herramienta Establecer nulos de la extensión de ArcGIS Spatial Analyst. El valor NoData se considera como una barrera en el análisis, por lo que las ubicaciones que sean NoData en la entrada serán NoData en el resultado.

• En lo que respecta al parámetro Nombre de líneas de conexiones vecinas de salida, si no se especifica una superficie de coste, los vecinos se identifican por medio de la distancia euclidiana y el vecino más cercano de la región es el más próximo en la distancia. Sin embargo, cuando se proporciona una superficie de coste, los vecinos se identifican por el coste según la distancia y el vecino más cercano de una región es el menos caro al que puede desplazarse. Se lleva a cabo una operación de asignación de costes para identificar las regiones vecinas entre sí.

• El entorno de Máscara de análisis puede configurarse como una entidad o un dataset ráster. Si la máscara es una de entidades, se convertirá en un ráster. Las celdas que tienen un valor definen las ubicaciones que se encuentren dentro del área de la máscara. Las celdas NoData definen las ubicaciones que están fuera del área de la máscara y que se tratarán como unabarrera.

• Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster o regiones de entidades de entrada	Las regiones de entrada que se conectarán mediante la red óptima. Las regiones se pueden definir mediante ráster o datos de entidades. Si la entrada de la región es ráster, las regiones se definen mediante grupos de celdas contiguas (adyacentes) con el mismo valor. Cada región se debe numerar de forma única. Las celdas que no formen parte de ninguna región deberán ser NoData. El tipo de ráster debe ser un número entero y los valores pueden ser positivos o negativos. Si la entrada de la región es datos de entidades, puede tratarse de polígonos, líneas o puntos. Las regiones de la entidad poligonal no pueden estar compuestas por polígonos multiparte.	Raster Layer; Image Service; Feature Layer; String
Nombre de líneas de conexiones óptimas de salida	Nombre del servicio de entidades de línea de salida que conecta cada región de entrada. Cada ruta (o línea) está numerada de forma única y hay campos adicionales en la tabla de atributos donde se almacena información específica sobre la ruta. Estos campos adicionales son los siguientes: PATHID— Identificador único de la ruta PATHCOST— Distancia o coste acumulado total de la ruta REGION1- primera región que conecta la ruta REGION2- la otra región que conecta la ruta Esta información ofrece una perspectiva de las rutas que hay dentro de la red. Como cada ruta se representa mediante una línea única, habrá varias líneas en las ubicaciones donde las rutas transcurren por el mismo camino.	String
Ráster de entrada o barreras de entidad (Opcional)	El dataset que define las barreras. Las barreras pueden definirse mediante un servicio de imágenes de entero o de punto flotante o mediante un servicio de entidades. En el caso de un servicio de entidades, el tipo de entrada puede ser un punto, una línea o un polígono. En el caso de una barrera de un servicio de imágenes, la barrera debe tener un valor válido, incluido cero, y las áreas que no son barreras deben ser NoData.	Raster Layer; Image Service; Feature Layer; String
Ráster de costes de entrada	Servicio de imágenes que define la impedancia o el coste de un movimiento planimétrico a través de cada celda. El valor de cada ubicación de celda representa el coste-distancia por unidad para moverse a través de la celda. Cada valor de ubicación de celda se multiplica por la resolución de la celda mientras que también se compensa por el movimiento diagonal para obtener el coste total de pasar por medio de la celda. Los valores del ráster de costes pueden ser de tipo entero o punto flotante. Los valores de ráster de costes que son negativos o cero no son válidos, pero se tratarán como valores de costes positivos pequeños.	Raster Layer; Image Service; String
Nombre de líneas de conexiones vecinas de salida (Opcional)	La clase de entidad de polilínea de salida que identifica todas las rutas de cada región hacia sus vecinos de coste o más próximos. Cada ruta (o línea) está numerada de forma única y hay campos adicionales en la tabla de atributos donde se almacena información específica sobre la ruta. Estos campos adicionales son los siguientes: PATHID— Identificador único de la ruta PATHCOST— Distancia o coste acumulado total de la ruta REGION1- primera región que conecta la ruta REGION2- la otra región que conecta la ruta Esta información ofrece una perspectiva de las rutas que hay dentro de la red y resulta útil a la hora de decidir las rutas q se deberían eliminar, en caso necesario. Como cada ruta se representa mediante una línea única, habrá varias líneas en las ubicaciones donde las rutas transcurren por el mismo camino.	String
Método de distancia (Opcional)	Especifica si la distancia se calculará mediante un método planar (Tierra plana) o geodésico (elipsoide). Planar—El cálculo de distancia se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada. Geodésica—El cálculo de distancia se realizará en el elipsoide. Los resultados no cambiarán, con independencia de la proyección de entrada o salida.	String
Conexiones dentro de las regiones (Opcional)	Especifica si las rutas continuarán y se conectarán dentro de las regiones de entrada. Generar conexiones—Las rutas continuarán dentro de las regiones de entrada para conectar todas las rutas que se adentran en una región. Sin conexiones—Las rutas se detendrán en los bordes de las regiones de entrada y no continuarán ni se conectarán dentro de ellas.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Líneas de conexión óptimas de salida	Líneas que conectan de manera óptima las regiones.	Feature Class
Líneas de conexión vecinas de salida	Entidades de conexión vecinas de salida.	Feature Class

Python

arcpy.ra.OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})

Nombre	Explicación	Tipo de datos
inputRegionRasterOrFeatures	Las regiones de entrada que se conectarán mediante la red óptima. Las regiones se pueden definir mediante ráster o datos de entidades. Si la entrada de la región es ráster, las regiones se definen mediante grupos de celdas contiguas (adyacentes) con el mismo valor. Cada región se debe numerar de forma única. Las celdas que no formen parte de ninguna región deberán ser NoData. El tipo de ráster debe ser un número entero y los valores pueden ser positivos o negativos. Si la entrada de la región es datos de entidades, puede tratarse de polígonos, líneas o puntos. Las regiones de la entidad poligonal no pueden estar compuestas por polígonos multiparte.	Raster Layer; Image Service; Feature Layer; String
outputOptimalLinesName	Nombre del servicio de entidades de línea de salida que conecta cada región de entrada. Cada ruta (o línea) está numerada de forma única y hay campos adicionales en la tabla de atributos donde se almacena información específica sobre la ruta. Estos campos adicionales son los siguientes: PATHID— Identificador único de la ruta PATHCOST— Distancia o coste acumulado total de la ruta REGION1- primera región que conecta la ruta REGION2- la otra región que conecta la ruta Esta información ofrece una perspectiva de las rutas que hay dentro de la red. Como cada ruta se representa mediante una línea única, habrá varias líneas en las ubicaciones donde las rutas transcurren por el mismo camino.	String
inputBarrierRasterOrFeatures (Opcional)	El dataset que define las barreras. Las barreras pueden definirse mediante un servicio de imágenes de entero o de punto flotante o mediante un servicio de entidades. En el caso de un servicio de entidades, el tipo de entrada puede ser un punto, una línea o un polígono. En el caso de una barrera de un servicio de imágenes, la barrera debe tener un valor válido, incluido cero, y las áreas que no son barreras deben ser NoData.	Raster Layer; Image Service; Feature Layer; String
inputCostRaster	Servicio de imágenes que define la impedancia o el coste de un movimiento planimétrico a través de cada celda. El valor de cada ubicación de celda representa el coste-distancia por unidad para moverse a través de la celda. Cada valor de ubicación de celda se multiplica por la resolución de la celda mientras que también se compensa por el movimiento diagonal para obtener el coste total de pasar por medio de la celda. Los valores del ráster de costes pueden ser de tipo entero o punto flotante. Los valores de ráster de costes que son negativos o cero no son válidos, pero se tratarán como valores de costes positivos pequeños.	Raster Layer; Image Service; String
outputNeighborConnectionsName (Opcional)	La clase de entidad de polilínea de salida que identifica todas las rutas de cada región hacia sus vecinos de coste o más próximos. Cada ruta (o línea) está numerada de forma única y hay campos adicionales en la tabla de atributos donde se almacena información específica sobre la ruta. Estos campos adicionales son los siguientes: PATHID— Identificador único de la ruta PATHCOST— Distancia o coste acumulado total de la ruta REGION1- primera región que conecta la ruta REGION2- la otra región que conecta la ruta Esta información ofrece una perspectiva de las rutas que hay dentro de la red y resulta útil a la hora de decidir las rutas q se deberían eliminar, en caso necesario. Como cada ruta se representa mediante una línea única, habrá varias líneas en las ubicaciones donde las rutas transcurren por el mismo camino.	String
distanceMethod (Opcional)	Especifica si la distancia se calculará mediante un método planar (Tierra plana) o geodésico (elipsoide). PLANAR—El cálculo de distancia se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada. GEODESIC—El cálculo de distancia se realizará en el elipsoide. Los resultados no cambiarán, con independencia de la proyección de entrada o salida.	String
connectionsWithinRegions (Opcional)	Especifica si las rutas continuarán y se conectarán dentro de las regiones de entrada. GENERATE_CONNECTIONS—Las rutas continuarán dentro de las regiones de entrada para conectar todas las rutas que se adentran en una región. NO_CONNECTIONS—Las rutas se detendrán en los bordes de las regiones de entrada y no continuarán ni se conectarán dentro de ellas.	String

Salida derivada

Nombre	Explicación	Tipo de datos
outputOptimalLinesFeatures	Líneas que conectan de manera óptima las regiones.	Feature Class
outputNeighborConnectionFeatures	Entidades de conexión vecinas de salida.	Feature Class

Muestra de código

Ejemplo 1 de Conexiones de región óptimas (ventana de Python)

En este ejemplo se calculan las conexiones óptimas entre regiones.

import arcpy

arcpy.ra.OptimalRegionConnections(
    "https://myserver/rest/services/regions/ImageServer", "outOptimalConnections",
    "https://myserver/rest/services/barriers/ImageServer",
    "https://myserver/rest/services/cost/ImageServer",
    "outNeighborConnections")

Ejemplo 2 de Conexiones de región óptimas (script independiente)

En este ejemplo se calculan las conexiones óptimas entre regiones.

#-------------------------------------------------------------------------------
# Name: OptimalRegionConnections_Ex_02.py
# Description: Calculates the optimal connections between regions.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputRegionsLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/regions/ImageServer'
outputName = 'outOptimalConnections'
inputBarriersLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/barriers/ImageServer'
inputCostLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer'
outputName02 = 'outNeighborConnections'
distanceMethod = 'GEODESIC'
connectionsWithinRegions = 'GENERATE_CONNECTIONS' 

arcpy.ra.OptimalRegionConnections(inputRegionsLayer, outputName, inputBarriersLayer,
                                  inputCostLayer, outputName02, distanceMethod,connectionsWithinRegions)

Entornos

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

Información de licenciamiento

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