Corredor de menor coste (Spatial Analyst)

Disponible con una licencia de 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 desde 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 distancia. Las unidades de los rásteres pueden ser, entre otras, dólares por metro, preferencia por pie o minutos por metro, según la aplicación. Estas unidades de coste se capturan en la superficie de coste. Para obtener información adicional, consulte Ajustar la distancia encontrada utilizando una superficie de coste.

  • Los corredores no son direccionales, lo que significa que viajar desde el primer origen hasta el segundo cuesta lo mismo que viajar desde el segundo origen hasta el primero. Al crear los rásteres de coste-distancia acumulativo y de dirección hacia atrás, no especifique valores para ningún parámetro que dependa de la direccionalidad, los que sean el factor horizontal, el factor vertical y la 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 coste-distancia acumulativo y de dirección hacia atrás del primer origen, así como los rásteres de coste-distancia acumulativo y de dirección hacia atrás del segundo origen.

  • Los valores del corredor de salida representan la suma del coste acumulativo para llegar a 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 del entorno Tamaño de celda y el tamaño de celda de los rásteres de costes acumulativos de entrada se utilizará para calcular el ráster de salida. El patrón de los rásteres de entrada se alteraría si la salida se remuestrease con una resolución diferente.

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de coste-distancia acumulativo de entrada 1

El 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 siguiente 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 siguiente 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 umbralNo 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 costeEl umbral se definirá como un porcentaje del valor mínimo de los rásteres de coste-distancia acumulativo sumados.
  • Coste acumulativoEl umbral se definirá en unidades de coste-distancia acumulativo.
String
Umbral

Un umbral de coste acumulativo o porcentaje que determinará 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

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de corredor de salida que contiene la celda con valores por debajo del umbral en unidades de coste-distancia acumulativo.

El ráster de salida es de tipo de punto flotante.

Raster

LeastCostCorridor(in_accumulative_cost_distance_raster1, in_back_direction_raster1, in_accumulative_cost_distance_raster2, in_back_direction_raster2, threshold_method, threshold)
NombreExplicaciónTipo de datos
in_accumulative_cost_distance_raster1

El 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 siguiente 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 siguiente 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_THRESHOLDNo 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_COSTEl umbral se definirá como un porcentaje del valor mínimo de los rásteres de coste-distancia acumulativo sumados.
  • ACCUMULATIVE_COSTEl umbral se definirá en unidades de coste-distancia acumulativo.
String
threshold

Un umbral de coste acumulativo o porcentaje que determinará 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 si el parámetro threshold_method está establecido en PERCENT_OF_LEAST_COST o ACCUMULATIVE_COST.

Double

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de corredor de salida que contiene la celda con valores por debajo del umbral en unidades de coste-distancia acumulativo.

El ráster de salida es de tipo de punto flotante.

Raster

Muestra de código

Ejemplo 1 de LeastCostCorridor (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la herramienta Corredor de menor coste.

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 LeastCostCorridor (script independiente)

Calcula 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")