Disponible con una licencia de Spatial Analyst.
Resumen
Calcula la ruta de menor coste desde un origen a su destino.
Uso
La herramienta Ruta de coste produce un ráster de salida que registra la ruta o las rutas de menor coste desde las ubicaciones seleccionadas hasta la celda de origen más cercana definida dentro de la superficie de coste acumulativo, en términos de distancia de coste.
En general, se requiere que se ejecute una o más de las herramientas de coste ponderado (Distancia de coste, Vínculo de menor coste o Asignación de costes) antes de ejecutar Ruta de coste para crear los rásteres de distancia de coste y de vínculo de entrada. Éstos son rásteres de entrada obligatorios para la Ruta de coste.
A cada ruta de menor coste se le asigna un valor cuando se encuentra en el proceso de escaneado. La última celda del ráster de origen (del cual derivan los rásteres de distancia de coste y de vínculo) de una ruta de coste recibe el uno, la primera ruta recibe el tres, la segunda el cuatro y así sucesivamente. El valor dos se reserva para la porción combinada de las rutas que poseen partes de una ruta de coste en común.
Cuando los datos de destino de entrada son un ráster, el conjunto de celdas de destino consta de todas las celdas del ráster de entrada o de los datos de destino de la entidad que tengan valores válidos. Las celdas con valores NoData no se incluyen en el conjunto de origen. El valor cero se considera un destino legítimo. Se puede crear fácilmente un ráster de destino mediante las herramientas de extracción.
Cuando la entrada de la fuente es una entidad, se utilizará el primer campo disponible válido de forma predeterminada. Si no existen campos válidos, se utilizará el campo ObjectID (por ejemplo, OID o FID, dependiendo del tipo de entrada de entidad).
Al utilizar datos de entidad poligonal para los destinos de entidad de entrada, se debe tener cuidado con la manera en que el tamaño de celda de salida es cuando es grueso en relación con los detalles presentes en la entrada. En el proceso de rasterización interno que utiliza la herramienta De polígono a ráster, la configuración predeterminada de Tipo de asignación de celda será Centro de celda. Esto significa que los datos no ubicados en el centro de la celda no se incluirán en la salida de destino rasterizada intermedia, y por lo tanto no se representarán en los cálculos de distancia. Por ejemplo, si sus destinos 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 paso intermedio, podría rasterizar las entidades de entrada directamente con la herramienta De entidad a ráster y establecer el parámetro Campo. A continuación, utilice la salida resultante como entrada de la herramienta de distancia que desee usar. Alternativamente, puede seleccionar un tamaño de celda pequeño para capturar la cantidad adecuada de detalle de las entidades de entrada.
Cuando se fusionan varias rutas y siguen la distancia restante hasta un origen en la misma ruta, al segmento donde las dos rutas viajan juntas se le asigna el valor 2. A la parte fusionada de la ruta no se le puede asignar el valor de una de las rutas, ya que la parte fusionada pertenece a ambas rutas.
Ejemplo de la opción Cada zona con rutas fusionadas La Ruta de coste ignorará la configuración del entorno de Tamaño de celda y utilizará el tamaño de celda del Ráster de vínculo de menor coste de entrada para el ráster de salida. El patrón del ráster de vínculo se verá seriamente alterado si se remuestrea con una resolución diferente. Para evitar confusiones, no debe configurar el tamaño de celda cuando usa esta herramienta.
Ruta de coste se puede utilizar para determinar la ruta de flujo basada en la dirección del flujo D8. Para utilizar Ruta de coste de dicha forma, utilice el ráster de dirección del flujo D8 como entrada para el Ráster de vínculo de menor coste de entrada. También deberá proporcionar un Ráster de coste-distancia de entrada; el Ráster de coste-distancia de entrada no se utiliza para determinar la ruta. Tanto si utiliza un ráster constante como un modelo digital de elevación (DEM), su ruta será la misma; solo variará en su ruta un valor de atributo. Consulte la herramienta Dirección del flujo para obtener más información sobre los rásteres de dirección del flujo D8.
Cuando los datos de destino de entrada son una entidad, deben contener al menos un campo válido.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Sintaxis
CostPath(in_destination_data, in_cost_distance_raster, in_cost_backlink_raster, {path_type}, {destination_field}, {force_flow_direction_convention})| Parámetro | Explicación | Tipo de datos |
in_destination_data | Un dataset de entidades o ráster que identifica aquellas celdas desde donde se determina la ruta de menor coste al origen menos costoso. Si la entrada es un ráster, la entrada consta de celdas con valores válidos (cero es un valor válido) y se debe asignar NoData a las celdas restantes. | Raster Layer; Feature Layer |
in_cost_distance_raster | El nombre de un ráster de distancia de coste que se utiliza para determinar la ruta de menor coste desde las ubicaciones de destino a un origen. En general, el ráster de distancia de coste se crea con las herramientas Distancia de coste, Asignación de costes o Vínculo de menor coste. El ráster de distancia de coste almacena, para cada celda, la distancia de coste acumulativo mínimo sobre una superficie de coste desde cada celda hasta un conjunto de celdas de origen. | Raster Layer |
in_cost_backlink_raster | El nombre de un ráster de vínculo de menor coste que se utiliza para determinar la ruta para volver a un origen mediante la ruta de menor coste. Para cada celda en el ráster de vínculo, un valor identifica al vecino que es la próxima celda en la ruta de menor coste acumulativo desde la celda hasta una única celda de origen o un conjunto de celdas de origen. | Raster Layer |
path_type (Opcional) | Una palabra clave que define la manera en que se interpretarán los valores y las zonas de los datos de destino de entrada en los cálculos de la ruta de coste.
| String |
destination_field (Opcional) | El campo que se utiliza para obtener valores para las ubicaciones de destino. Los datos de entidad de entrada deben contener al menos un campo válido. | Field |
force_flow_direction_convention (Opcional) | Obliga a la herramienta a tratar el ráster de vínculo de entrada como un ráster de dirección del flujo. Los rásteres de dirección del flujo pueden tener un entero con valores de 0 a 255.
| Boolean |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster | El ráster de ruta de coste de salida. El ráster de salida no es de tipo entero. | Raster |
Muestra de código
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta CostPath.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCostPath = CostPath("observers", "costraster", "backlink2", "EACH_CELL")
outCostPath.save("c:/sapyexamples/output/costpath")Calcula la ruta de menor coste desde un origen a su destino.
# Name: CostPath_Ex_02.py
# Description: Calculates the least-cost path from a source to
# a destination.
# 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
inDestination = "observers.shp"
costDistanceRaster = "costdistraster"
backLink = "backlink2"
method = "EACH_CELL"
destField = "FID"
# Execute CostPath
outCostPath = CostPath(inDestination, costDistanceRaster, backLink, method,
destField)
# Save the output
outCostPath.save("c:/sapyexamples/output/costpath02")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst