Corredor de menor coste (Spatial Analyst)

Resumen

Calcula la suma de dos rásteres de coste-distancia acumulativo con la opción de aplicar un umbral basado en el porcentaje o el coste acumulativo.

Más información sobre cómo conectar ubicaciones con corredores

Uso

• Los rásteres de entrada deben ser la salida de rásteres de acumulación de distancia y dirección hacia atrás de las herramientas Acumulación de distancia o Asignación de distancia.

• Utilice la versión de coste de los rásteres de acumulación de distancias. Las unidades de los rásteres pueden ser, entre otras, dólares por metro, preferencia por pie o minutos por metro, dependiendo de la aplicación. Estas unidades de coste se recogen en la superficie de coste. Para obtener más información, consulte Ajustar la distancia encontrada usando una superficie de coste.

• Los corredores son no direccionales, lo que significa que viajar del primer origen al segundo cuesta lo mismo que viajar del segundo origen al primero. Al crear rásteres de distancia de coste acumulado y de dirección de retorno, no especifique valores para ningún parámetro que dependa de la direccionalidad: factor horizontal, factor vertical y dirección del viaje.

• Utilice la misma configuración de parámetros para la herramienta Acumulación de distancia o Asignación de distancia al crear los rásteres de distancia de coste acumulativo y de dirección hacia atrás del primer origen, así como los rásteres de distancia de coste acumulativo y de dirección hacia atrás del segundo origen.

• Todos los rásteres de entrada deben ser de tipo punto flotante y deben tener el mismo tamaño de celda, extensión y referencia espacial.

• Los valores del corredor de salida representan la suma del coste acumulativo para alcanzar una ubicación determinada con las mismas unidades que los rásteres de coste-distancia acumulativo de entrada.

• Si un valor de umbral especificado es mayor que el coste acumulativo máximo cuando se suman los dos rásteres de acumulación de distancia, el ráster de corredor de salida abarcará la misma área que los rásteres acumulativos de entrada.

• Si un valor de umbral especificado es menor que el valor mínimo del ráster de corredor, se devuelve un mensaje de advertencia y el ráster de salida estará vacío.

• El ráster de corredor de salida puede contener celdas con costes acumulativos ligeramente mayores que el valor de umbral. Procede de los rásteres de dirección hacia atrás que utilizan celdas que tienen asignados costes ligeramente mayores que el umbral para conectar celdas desconectadas al corredor. Para obtener más información, consulte Conectar ubicaciones con corredores.

• Para generar un corredor, se ignora la configuración de entorno Tamaño de celda, y se utilizará el tamaño de celda de los rásteres de coste acumulativo de entrada para calcular el ráster de salida. El patrón de los rásteres de entrada se vería alterado si la salida se muestreara de nuevo a una resolución diferente.

• Cuando el formato de ráster de salida es .crf, esta herramienta admite el entorno de almacenamiento ráster Pirámide. De forma predeterminada, se crearán pirámides en la salida. Para cualquier otro formato de salida, este entorno no es compatible y no se crearán pirámides.

• Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster de coste-distancia acumulativo de entrada 1	Ráster de entrada que representa el coste-distancia acumulativo desde el primer origen. Utilice la salida de acumulación de distancia de la herramienta Acumulación de distancia o Asignación de distancia.	Raster Layer
Ráster de dirección hacia atrás de entrada 1	El ráster de dirección hacia atrás de entrada desde el primer origen. Las unidades son grados que identifican la próxima celda a lo largo de la ruta de menor coste que vuelve al primer origen. Utilice la salida de dirección hacia atrás de la herramienta Acumulación de distancia o Asignación de distancia. El rango de valores es de 0 grados hasta 360 grados, con el 0 reservado para las celdas de origen. Hacia el este (derecha) es 90 y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte).	Raster Layer
Ráster de coste-distancia acumulativo de entrada 2	El ráster de entrada que representa el coste-distancia acumulativo desde el segundo origen. Utilice la salida de acumulación de distancia de la herramienta Acumulación de distancia o Asignación de distancia.	Raster Layer
Ráster de dirección hacia atrás de entrada 2	El ráster de dirección hacia atrás de entrada desde el segundo origen. Las unidades son grados que identifican la próxima celda a lo largo de la ruta de menor coste que vuelve al segundo origen. Utilice la salida de dirección hacia atrás de la herramienta Acumulación de distancia o Asignación de distancia. El rango de valores es de 0 grados hasta 360 grados, con el 0 reservado para las celdas de origen. Hacia el este (derecha) es 90 y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte).	Raster Layer
Método de umbral	Especifica cómo se definirá el umbral. Sin umbral—No se aplicará ningún umbral y el corredor resultante abarcará la extensión completa de los rásteres de entrada. Esta es la opción predeterminada. Porcentaje del menor coste—El umbral se definirá como un porcentaje del valor mínimo de los rásteres de coste-distancia acumulativo sumados. Coste acumulativo—El umbral se definirá en unidades de coste-distancia acumulativo.	String
Umbral	Umbral de coste acumulativo o porcentaje que determina si una celda determinada se incluirá en el ráster de corredor de salida. Cuando el parámetro Método de umbral se establece en Porcentaje del menor coste, el valor especificado indica el aumento porcentual que se debe aplicar desde el valor mínimo de los rásteres de coste-distancia acumulativo sumados. Cuando el parámetro Método de umbral se establece en Coste acumulativo, el valor indica las celdas que tienen un coste acumulativo sumado igual o inferior al valor que se incluirá en el corredor. Este parámetro solo está activo si el parámetro Método de umbral está establecido en Porcentaje de menor coste o Coste acumulativo.	Double

Valor de retorno

Etiqueta	Explicación	Tipo de datos
Ráster de salida	Ráster del corredor de salida que contiene celdas con valores por debajo del umbral en unidades de distancia de coste acumulativo. El ráster de salida es de tipo de punto flotante.	Raster

Python

LeastCostCorridor(in_accumulative_cost_distance_raster1, in_back_direction_raster1, in_accumulative_cost_distance_raster2, in_back_direction_raster2, threshold_method, threshold)

Nombre	Explicación	Tipo de datos
in_accumulative_cost_distance_raster1	Ráster de entrada que representa el coste-distancia acumulativo desde el primer origen. Utilice la salida de acumulación de distancia de la herramienta Acumulación de distancia o Asignación de distancia.	Raster Layer
in_back_direction_raster1	El ráster de dirección hacia atrás de entrada desde el primer origen. Las unidades son grados que identifican la próxima celda a lo largo de la ruta de menor coste que vuelve al primer origen. Utilice la salida de dirección hacia atrás de la herramienta Acumulación de distancia o Asignación de distancia. El rango de valores es de 0 grados hasta 360 grados, con el 0 reservado para las celdas de origen. Hacia el este (derecha) es 90 y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte).	Raster Layer
in_accumulative_cost_distance_raster2	El ráster de entrada que representa el coste-distancia acumulativo desde el segundo origen. Utilice la salida de acumulación de distancia de la herramienta Acumulación de distancia o Asignación de distancia.	Raster Layer
in_back_direction_raster2	El ráster de dirección hacia atrás de entrada desde el segundo origen. Las unidades son grados que identifican la próxima celda a lo largo de la ruta de menor coste que vuelve al segundo origen. Utilice la salida de dirección hacia atrás de la herramienta Acumulación de distancia o Asignación de distancia. El rango de valores es de 0 grados hasta 360 grados, con el 0 reservado para las celdas de origen. Hacia el este (derecha) es 90 y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte).	Raster Layer
threshold_method	Especifica cómo se definirá el umbral. NO_THRESHOLD—No se aplicará ningún umbral y el corredor resultante abarcará la extensión completa de los rásteres de entrada. Esta es la opción predeterminada. PERCENT_OF_LEAST_COST—El umbral se definirá como un porcentaje del valor mínimo de los rásteres de coste-distancia acumulativo sumados. ACCUMULATIVE_COST—El umbral se definirá en unidades de coste-distancia acumulativo.	String
threshold	Umbral de coste acumulativo o porcentaje que determina si una celda determinada se incluirá en el ráster de corredor de salida. Cuando el parámetro threshold_method se establece en PERCENT_OF_LEAST_COST, el valor especificado indica el aumento porcentual que se debe aplicar desde el valor mínimo de los rásteres de coste-distancia acumulativo sumados. Cuando el parámetro threshold_method se establece en ACCUMULATIVE_COST, el valor indica las celdas que tienen un coste acumulativo sumado igual o inferior al valor que se incluirá en el corredor. Este parámetro solo está habilitado cuando el parámetro threshold_method está establecido en PERCENT_OF_LEAST_COST o ACCUMULATIVE_COST.	Double

Valor de retorno

Nombre	Explicación	Tipo de datos
out_raster	Ráster del corredor de salida que contiene celdas con valores por debajo del umbral en unidades de distancia de coste acumulativo. El ráster de salida es de tipo de punto flotante.	Raster

Muestra de código

Ejemplo 1 de Corredor de menor coste (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función LeastCostCorridor.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data"
out_LCC_raster = LeastCostCorridor("DistAccumRaster1.tif", "BackDirRaster1.tif",
                                   "DistAccumRaster2.tif", "BackDirRaster2.tif") 
out_LCC_raster.save("c:/arcpyexamples/output/corridor.tif")

Ejemplo 2 de Corredor de menor coste (secuencia de comandos independiente)

Calcular un corredor entre dos áreas.

# Name: LeastCostCorridor_Ex_02.py
# Description: Calculates a potential wildlife corridor between two known 
#               protected areas.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

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

# Set environment settings
env.workspace = "C:/arcpyexamples/data"

# Set local variables
in_accumulative_cost_distance_raster1 = "distaccum_s1.tif"
in_back_direction_raster1 = "backdir_s1.tif"
in_accumulative_cost_distance_raster2 = "distaccum_s2.tif"
in_back_direction_raster2 = "backdir_s2.tif"
threshold_method = "ACCUMULATIVE_COST" 
threshold = 500

# Run Least Cost Corridor
out_LCC_raster = LeastCostCorridor(
    in_accumulative_cost_distance_raster1, in_back_direction_raster1, 
    in_accumulative_cost_distance_raster2, in_back_direction_raster2, 
    "ACCUMULATIVE_COST", "500")

# Save the output 
out_LCC_raster.save("c:/arcpyexamples/output/corridor.tif")

Entornos

Auto ejecución, Compresión, Espacio de trabajo actual, Palabra clave CONFIG de salida, Factor de procesamiento en paralelo, Pirámide, Espacio de trabajo temporal, Tamaño de tesela