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 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

EtiquetaExplicaciónTipo 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 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

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

EtiquetaExplicaciónTipo 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

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

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_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

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

NombreExplicaciónTipo 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")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados