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 lo siguiente: 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. También puede ser 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.
Sintaxis
OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})| Parámetro | 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:
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 la distancia de coste 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:
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).
| String |
connectionsWithinRegions (Opcional) | Especifica si las rutas continuarán y se conectarán dentro de las regiones de entrada.
| 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
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")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)Información de licenciamiento
- Basic: Requiere ArcGIS Image Server
- Standard: Requiere ArcGIS Image Server
- Advanced: Requiere ArcGIS Image Server