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

Resumen

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

Ilustración

Uso

Esta herramienta de portal de análisis ráster está disponible cuando se inicia sesión en un ArcGIS Enterprise que tiene un ArcGIS Image Server configurado para Raster Analysis . Cuando se invoca la herramienta, ArcGIS Pro funciona como cliente y tiene lugar el procesamiento 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 Spatial Analyst Grupo de regiones 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 o entidades de barrera de entrada o las 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.
El Ráster de costes de entrada no puede contener valores de cero debido a que el algoritmo es un proceso multiplicativo. Si el ráster de coste contiene valores de cero y estos valores representan áreas de bajo coste, cambie esas celdas a un valor positivo pequeño (como 0,01) antes de ejecutar esta herramienta.
En lo que respecta al parámetro Nombre 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í.
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

Etiqueta	Explicación	Tipo de datos
Ráster o entidades de regiones 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 conectividad óptima 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. Los campos adicionales son los siguientes: PATHID: identificador único de la ruta PATHCOST: distancia o coste acumulados totales 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 o entidades de barrera de entrada (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 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 coste pueden ser enteros o de punto flotante, pero no pueden ser negativos o cero (no puede tener un coste negativo o cero).	Raster Layer; Image Service; String
Nombre de conexiones vecinas de salida (Opcional)	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. Los campos adicionales son los siguientes: PATHID: identificador único de la ruta PATHCOST: distancia o coste acumulados totales 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 que 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 va a calcular basándose en un método planar (Tierra plana) o geodésico (elipsoide). Planar—El cálculo de distancia se realizará sobre un plano 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. Por lo tanto, independientemente de la proyección de entrada o salida, los resultados no cambian.	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 entren en una región. No hay 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 conectividad óptima de salida	Líneas que conectan de manera óptima las regiones.	Clase de entidad
Conexiones vecinas de salida	Entidades de conexión vecinas de salida.	Clase de entidad

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. Los campos adicionales son los siguientes: PATHID: identificador único de la ruta PATHCOST: distancia o coste acumulados totales 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 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 coste pueden ser enteros o de punto flotante, pero no pueden ser negativos o cero (no puede tener un coste negativo o cero).	Raster Layer; Image Service; String
outputNeighborConnectionsName (Opcional)	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. Los campos adicionales son los siguientes: PATHID: identificador único de la ruta PATHCOST: distancia o coste acumulados totales 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 que 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 va a calcular basándose en un método planar (Tierra plana) o geodésico (elipsoide). PLANAR—El cálculo de distancia se realizará sobre un plano 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. Por lo tanto, independientemente de la proyección de entrada o salida, los resultados no cambian.	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 entren 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.	Clase de entidad
outputNeighborConnectionFeatures	Entidades de conexión vecinas de salida.	Clase de entidad

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.OptimalRegionConnections_ra(
    "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.OptimalRegionConnections_ra(inputRegionsLayer, outputName, inputBarriersLayer,
                                  inputCostLayer, outputName02, distanceMethod,connectionsWithinRegions)

Entornos

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

Resumen

Ilustración

Uso

Parámetros

Salida derivada

Salida derivada

Muestra de código

Entornos

Casos especiales

Información de licenciamiento

Temas relacionados

En este tema