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

Ilustración de la herramienta Conexiones de región óptimas

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 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í.

  • 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 válidos para esta herramienta.

Parámetros

EtiquetaExplicaciónTipo 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. 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 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 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 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)

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).

  • PlanarEl cálculo de distancia se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada.
  • GeodésicaEl 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 conexionesLas rutas continuarán dentro de las regiones de entrada para conectar todas las rutas que se adentran en una región.
  • Sin conexionesLas 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

EtiquetaExplicaciónTipo de datos
Líneas de conectividad óptima de salida

Líneas que conectan de manera óptima las regiones.

Feature Class
Conexiones vecinas de salida

Entidades de conexión vecinas de salida.

Feature Class

arcpy.ra.OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})
NombreExplicaciónTipo 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 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)

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).

  • PLANAREl cálculo de distancia se realizará sobre un plano proyectado usando un sistema de coordenadas cartesianas 2D. Esta es la opción predeterminada.
  • GEODESICEl 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_CONNECTIONSLas rutas continuarán dentro de las regiones de entrada para conectar todas las rutas que se adentran en una región.
  • NO_CONNECTIONSLas 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

NombreExplicaciónTipo 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)

Información de licenciamiento

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

Temas relacionados