| Etiqueta | Explicación | Tipo de datos |
Datos de entrada de región en forma de ráster o entidad | Las regiones de entrada que se conectarán mediante la red óptima. Las regiones se pueden definir mediante un dataset ráster o un dataset de entidades. Si la entrada de la región es un 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 un dataset de entidades, puede ser de polígonos, polilíneas o puntos. Las regiones de la entidad poligonal no pueden estar compuestas por polígonos multiparte. | Raster Layer; Feature Layer |
Líneas de conectividad óptima de salida | La clase de entidad de polilínea de salida de la red de rutas óptima para conectar cada una de las regiones 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:
Esta información ofrece una perspectiva de las rutas que hay en 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. | Feature Class |
Datos de entidad o ráster de barrera de entrada (Opcional) | El dataset que define las barreras. Las barreras pueden definirse mediante un ráster entero o de punto flotante, o mediante una entidad de punto, línea o polígono. | Raster Layer; Feature Layer |
Ráster de costes de entrada (Opcional) | Ráster que define la impedancia o el coste de hacer un movimiento planimétrico por medio 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 |
Clase de entidad de salida de conexiones vecinas (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:
Esta información ofrece una perspectiva de las rutas que hay en 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. | Feature Class |
Método de distancia (Opcional) | Especifica si la distancia se calculará mediante un método planar (Tierra plana) o geodésico (elipsoide).
| String |
Conexiones dentro de las regiones (Opcional) | Especifica si las rutas continuarán y se conectarán dentro de las regiones de entrada.
| String |
Disponible con una licencia de Spatial Analyst.
Resumen
Calcula la red de conectividad óptima entre dos o más regiones de entrada.
Más información sobre cómo conectar regiones con la red óptima
Uso
Las regiones de entrada pueden ser datos ráster o datos de entidad.
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 como paso de preprocesamiento para asignar valores únicos a cada región. A continuación, utilice el ráster resultante como las regiones de entrada de la herramienta Conexiones de región óptimas.
Si las regiones de entrada se identifican mediante datos de polígonos, líneas o puntos, estos se convierten a ráster utilizando el Id. de entidad para garantizar que las regiones resultantes tengan valores únicos. No se pueden utilizar polígonos multiparte como entrada. Si se introducen datos multipunto, la herramienta Conexiones de región óptimas selecciona aleatoriamente uno de los puntos de la ubicación como el valor de la región.
No puede controlar la resolución de las regiones de la entidad de entrada rasterizada con el entorno de Tamaño de celda. De forma predeterminada, la resolución se establece como la resolución del ráster de costes de entrada, si se proporciona uno.
Al utilizar datos de entidad poligonal para los datos de regiones de entrada, se debe tener cuidado con la manera en que el tamaño de celda de salida se maneja cuando es grueso en relación con los detalles presentes en la entrada. El proceso de rasterización interno utiliza el mismo método Tipo de asignación de celda predeterminado que la herramienta De polígono a ráster, que es Centro de celda. Esto significa que los datos que no se encuentren en el centro de la celda no se incluirán en la región rasterizada intermedia y, por lo tanto, no se representarán en los cálculos de distancia. Por ejemplo, si sus regiones son una serie de polígonos pequeños, como huellas de edificios, que son pequeñas en relación con el tamaño de celda de salida, quizá solo algunos de ellos caigan debajo de los centros de las celdas ráster de salida, ocasionando aparentemente que la mayor parte de los otros se pierdan en el análisis.
Para evitar esta situación, como paso intermedio, rasterice las entidades de entrada directamente con la herramienta De polígono a ráster, defina un valor de Campo de prioridad y utilice el resultado obtenido como entrada para la herramienta Conexiones de región óptimas. Como alternativa, seleccione un tamaño de celda lo suficientemente pequeño para capturar la cantidad adecuada de detalle de las entidades de entrada.
Si la entrada de la región es una entidad, se utilizará el campo ObjectID como identificadores de la región.
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 la herramienta Conexiones de región óptimas puede verse perjudicado.
Las ubicaciones identificadas por el parámetro Datos de entidad o ráster de barrera de entrada, las ubicaciones de celda con NoData en el parámetro Ráster de costes de entrada o las ubicaciones que no están incluidas en la Máscara actúan todas como barreras.
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.
La extensión de procesamiento predeterminada es la misma que la del valor 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 parámetro 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 costes contiene valores de cero y estos valores representan áreas de coste más bajo, cambie los valores de cero a un valor positivo bajo (como 0,01) antes de ejecutar esta herramienta.
Puede usar la herramienta Evaluación condicional para cambiar las celdas de cero a otro valor. Si las áreas con un valor de cero representan áreas que deberían excluirse del análisis, convierta estos valores a NoData primero ejecutando la herramienta Establecer nulos.
Para el parámetro Clase de entidad de salida de conexiones vecinas, si no se especifica ninguna superficie de coste, los vecinos se identifican por distancia euclidiana. En tal caso, el vecino más cercano a una región es el más cercano en cuando a distancia. Sin embargo, cuando se proporciona una superficie de coste, los vecinos se identifican por el coste-distancia, lo que hace que el vecino más cercano de una región sea 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í.
La red de salida óptima se crea a partir de las rutas generadas en la salida opcional de conexiones vecinas. Las rutas generadas en la salida opcional de conexiones vecinas se convierten en una teoría de grafos. Las regiones son los vértices, las rutas son los bordes y las distancias o costes acumulados son los pesos de los bordes. El árbol de expansión mínima se calcula a partir de la representación gráfica de las rutas para determinar la red de ruta óptima necesaria para viajar entre las regiones.
Cada ruta óptima llega primero al límite exterior del polígono o región de varias celdas. Desde el perímetro de la región, la herramienta sigue las rutas con segmentos de línea adicionales, permitiendo la entrada y salida de puntos entre las regiones y el movimiento dentro de ellas. No existe distancia ni coste de movimiento adicional entre estos segmentos de línea.
En función de la configuración de las regiones de entrada y sus vecinos de asignación, una ruta puede atravesar una región intermedia para alcanzar una región vecina. Dicha ruta generará costes a medida que se mueve por esa región intermedia.
La salida opcional de conexiones vecinas se puede utilizar como red alternativa a la red del árbol de expansión mínima. Dicha salida conecta cada región con sus regiones de coste vecinas, lo que produce una red más compleja con muchas rutas. La clase de entidad se puede utilizar tal cual o como base desde la cual crear su propia red. Para ello, seleccione las rutas específicas que desee incluir dentro de la red utilizando el botón Seleccionar por atributos, el grupo Seleccionar de la pestaña Mapa o la herramienta Seleccionar capa por atributos. La selección de las rutas se puede basar en el conocimiento del área y en las estadísticas asociadas con las rutas de la tabla de atributos resultante.
Esta herramienta admite el procesamiento en paralelo. Si su equipo tiene varios procesadores o procesadores con varios núcleos, puede conseguir un mayor rendimiento, especialmente en los datasets mayores. Consulte el tema de ayuda Procesamiento en paralelo con Spatial Analyst para obtener más detalles acerca de esta posibilidad y cómo configurarla.
Al utilizar el procesamiento en paralelo, se escriben datos temporales para administrar los lotes de datos a medida que se procesan. La ubicación de la carpeta temporal predeterminada será su unidad C: local. Es posible controlar la ubicación de esta carpeta cambiando el valor de una variable de entorno del sistema denominada TempFolders y especificando la ruta de la carpeta que se desea usar (por ejemplo, E:\RasterCache). Si tiene privilegios de administrador en su equipo, puede usar una clave de registro (por ejemplo, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).
De forma predeterminada, esta herramienta usará el 50 por ciento de los núcleos disponibles. Si los datos de entrada tienen un tamaño inferior a 5.000 x 5.000 celdas, es posible que se utilicen menos núcleos. Es posible controlar el número de núcleos empleados por la herramienta, a través de la configuración de entorno de Factor de procesamiento en paralelo.
La red resultante, ya sea a partir del árbol de expansión mínima o a partir de las conexiones vecinas opcionales, se puede convertir a una red de Network Analyst para análisis de red adicionales.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Parámetros
OptimalRegionConnections(in_regions, out_feature_class, {in_barrier_data}, {in_cost_raster}, {out_neighbor_paths}, {distance_method}, {connections_within_regions})| Nombre | Explicación | Tipo de datos |
in_regions | Las regiones de entrada que se conectarán mediante la red óptima. Las regiones se pueden definir mediante un dataset ráster o un dataset de entidades. Si la entrada de la región es un 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 un dataset de entidades, puede ser de polígonos, polilíneas o puntos. Las regiones de la entidad poligonal no pueden estar compuestas por polígonos multiparte. | Raster Layer; Feature Layer |
out_feature_class | La clase de entidad de polilínea de salida de la red de rutas óptima para conectar cada una de las regiones 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:
Esta información ofrece una perspectiva de las rutas que hay en 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. | Feature Class |
in_barrier_data (Opcional) | El dataset que define las barreras. Las barreras pueden definirse mediante un ráster entero o de punto flotante, o mediante una entidad de punto, línea o polígono. | Raster Layer; Feature Layer |
in_cost_raster (Opcional) | Ráster que define la impedancia o el coste de hacer un movimiento planimétrico por medio 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 |
out_neighbor_paths (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:
Esta información ofrece una perspectiva de las rutas que hay en 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. | Feature Class |
distance_method (Opcional) | Especifica si la distancia se calculará mediante un método planar (Tierra plana) o geodésico (elipsoide).
| String |
connections_within_regions (Opcional) | Especifica si las rutas continuarán y se conectarán dentro de las regiones de entrada.
| String |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la herramienta OptimalRegionConnections.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outOptRegConnect = OptimalRegionConnections("sources.shp", "cost_surface.tif")
outOptRegConnect.save("C:/sapyexamples/output/optregconnect.tif")Genere la red óptima de rutas de menor coste que conecten las regiones de entrada entre sí.
# Name: OptimalRegionConnections_Ex_02.py
# Description: Calculates the optimal network of connections for the sources.
#
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inSourceData = "sources.shp"
inBarrier = "barriers.tif"
inCostRaster = "cost_surface.tif"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute the tool
outOptRegConnect = OptimalRegionConnections(inSourceData, inBarrier, inCostRaster)
# Save the output
outOptRegConnect.save("C:/sapyexamples/output/optregconnect.tif")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst