Coste-conectividad—Ayuda

Disponible con una licencia de Spatial Analyst.

Resumen
Ilustración
Uso
Sintaxis
Muestra de código
Entornos
Información sobre licencias

Resumen

Genera la red de conectividad de mínimo coste entre dos o más regiones de entrada.

Obtenga más información sobre cómo funciona la herramienta Coste-conectividad

Ilustración

Entrada y salida de Coste-conectividad — CostConnectivity(Regiones, Cost_Ras, Cost_Connect)

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 a otras (adyacentes). Cuando las regiones de entrada se identifican mediante un ráster y si hay zonas (celdas con el mismo valor) que están formadas por varias regiones, ejecute primero la herramienta 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 para la herramienta Conectividad-coste.
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 la entidad para garantizar que las regiones resultantes tengan valores únicos. Por lo tanto, los polígonos multiparte no se pueden utilizar como entrada. Si se introducen datos multipunto, la herramienta Conectividad-coste 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 coste de entrada.
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 emplea el mismo método Tipo de asignación de celda predeterminado que la herramienta De polígono a ráster, que es CELL_CENTER. Esto significa que los datos no ubicados en el centro de la celda no se incluirán en la región rasterizada intermedia y, por lo tanto, no se representan 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 la celda de salida, es posible que 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 un paso intermedio, podría rasterizar las entidades de entrada directamente con la herramienta De polígono a ráster, definir un campo de Prioridad y utilizar la salida resultante como entrada para la herramienta Coste-conectividad. Alternativamente, puede seleccionar un tamaño de celda lo suficientemente pequeña 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 (por ejemplo, OID o FID, dependiendo del tipo de entrada de entidad).
Las ubicaciones de celda con NoData en el Ráster de costes de entrada actúan como barreras.
Si los datos de la región de entrada y el ráster de costes son extensiones diferentes, la extensión de salida predeterminada es la intersección de los dos.
Si se ha establecido una Máscara en el entorno, todas las celdas no identificadas por la máscara se tratarán como valores NoData.
Cuando se ha definido una máscara y existe una región o parte de una región que no se ha incluido en la máscara, los cálculos se realizarán en las celdas de la región restantes. Las celdas de la región que no estén en la máscara no se tendrán en cuenta en los cómputos.
El ráster de costes no puede contener valores de cero debido a que el algoritmo es un proceso multiplicativo. Si el ráster de costes contiene valores cero y estos valores representan áreas de coste más bajo, cambie los valores cero a un valor positivo pequeño (como 0,01) antes de ejecutar la herramienta Coste-conectividad, ejecutando primero la herramienta Evaluación condicional. Si las áreas con un valor cero representan áreas que deberían excluirse del análisis, estos valores deberían cambiarse a NoData antes de ejecutar la herramienta Coste-conectividad, ejecutando primero la herramienta Establecer nulos.
Para la Clase de entidad de salida de conexiones vecinas, los vecinos no se identifican mediante el coste de distancia. Por lo tanto, el vecino más cercano a una región será el más barato al que viajar, en lugar de serlo el más cercano en distancia. 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 los 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 de menor coste necesaria para viajar entre las regiones.
Cada ruta de menor coste 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 coste de movimiento adicional entre estos segmentos de línea.
Se pueden utilizar las herramientas Coste de distancia y Ruta de coste para conectar regiones que no están conectadas directamente en el árbol de expansión mínima según la información previa. Por ejemplo, puede que una determinada región necesite una ruta de escape alternativa para que los bomberos puedan evacuar la región. Dado que las rutas resultado de la Ruta de coste solo llegan hasta el borde de una región, si desea utilizar estas rutas adicionales en la red integrada para realizar otros análisis de red, necesitará ampliar estas rutas dentro de la región a fin de conectarlas a las rutas de la red del árbol de expansión mínima.
La salida opcional de conexiones vecinas se puede utilizar para crear su propia red, eliminando rutas específicas según el conocimiento del área y las estadísticas asociadas a las rutas en la tabla de atributos resultante.
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 realizar un análisis de red adicional.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Sintaxis

CostConnectivity (in_regions, in_cost_raster, out_feature_class, {out_neighbor_paths})

Parámetro	Explicación	Tipo de datos
in_regions	Las regiones de entrada que se deben conectar mediante la red de mínimo coste. 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 tratarse de polígonos, líneas o puntos. Las regiones de la entidad poligonal no pueden estar formadas por polígonos multiparte.	Raster Layer \| Feature Layer
in_cost_raster	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 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
out_feature_class	Clase de entidad de polilínea de salida que corresponde a la red óptima (de mínimo coste) de rutas necesaria para conectar todas 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 incluyen lo siguiente: PATHID: identificador único de la ruta PATHCOST: 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. Puesto que 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
out_neighbor_paths (Opcional)	Clase de entidad de polilínea de salida que identifica todas las rutas de cada región hacia sus vecinos 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 incluyen lo siguiente: PATHID: identificador único de la ruta PATHCOST: 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 de utilidad para decidir las rutas que se deben eliminar, en caso necesario. Puesto que 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

Muestra de código

Ejemplo 1 de CostConnectivity (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta CostConnectivity.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
CostConnectivity("regions.shp", "cost_ras", "C:/sapyexamples/output/costnetwork", "C:/sapyexamples/output/costneigh")

Ejemplo de CostConnectivity 2 (secuencia de comandos independiente)

Genera la red óptima de rutas de menor coste que conectan las regiones de entrada entre sí.

# Name: CostConnectivity_Ex_02.py
# Description: Calculates the least-cost network
# 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
inRegionData = "regions.shp"
inCostRaster = "cost_ras"
outCostNetwork = "C:/sapyexamples/output/costnetwork"
outOptCostNeigh = "C:/sapyexamples/output/costneigh"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Cost Connectivity
CostConnectivity(inRegionData, inCostRaster, outCostNetwork, outOptCostNeigh)

Información sobre licencias

ArcGIS Desktop Basic: Requiere Análisis espacial
ArcGIS Desktop Standard: Requiere Análisis espacial
ArcGIS Desktop Advanced: Requiere Análisis espacial

ArcMap

Coste-conectividad