Disponible con una licencia de Spatial Analyst.
Resumen
Calcula la ruta óptima desde un origen a su destino como un ráster.
Uso
La herramienta Ruta óptima como ráster produce un ráster de salida.
Cuando los datos de destino de entrada son un ráster, el conjunto de celdas de destino consta de todas las celdas de Ráster o datos de destino de entidad de entrada 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 un ráster de destino con las herramientas de extracción.
Al utilizar datos de entidad poligonal para los destinos de entidad de entrada, se debe tener cuidado con la manera en que se gestiona el tamaño de celda de salida, especialmente cuando es grueso en relación con los detalles presentes en la entrada. Se aplica un proceso de rasterización interno que utiliza la herramienta De polígono a ráster, con un valor predeterminado de Tipo de asignación de celdas de Centro de celda. Significa que los datos no ubicados en el centro de la celda no se incluirán en la salida de destino rasterizada intermedia y 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 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 muchos 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.
Antes de generar una ruta óptima, se suele utilizar una de las siguientes herramientas para crear un ráster de acumulación de distancia y un ráster de dirección hacia atrás: Acumulación de distancia o Asignación de distancia. Son entradas obligatorias para generar una ruta óptima.
La ruta óptima que se crea puede ser una ruta de flujo basada en la dirección del flujo D8. Para generar una ruta óptima de esta forma, utilice el ráster de dirección del flujo D8 como entrada para el Ráster de dirección de flujo o dirección hacia atrás de entrada. También deberá proporcionar un Ráster de acumulación de distancia de entrada; el Ráster de acumulación de 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.
Los valores de la ruta óptima de salida representan el número de rutas en una ubicación determinada. En muchos casos, las vías siguen las mismas rutas, abandonan un origen y divergen para ir a destinos diferentes. Por ejemplo, un valor de uno indica que solo hay una ruta óptima en una ubicación determinada, mientras que un valor de cinco significa que hay cinco rutas óptimas en la ubicación que atraviesan esa celda en el área de estudio.
Para generar una ruta óptima, la configuración del entorno Tamaño de celda se ignora y se utiliza el tamaño de celda del Ráster de vínculo de menor coste de entrada para calcular 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.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Sintaxis
OptimalPathAsRaster(in_destination_data, in_distance_accumulation_raster, in_back_direction_raster, {destination_field}, {path_type})| Parámetro | Explicación | Tipo de datos |
in_destination_data | Ráster entero o dataset de entidades que identifica ubicaciones desde las que se determina la ruta óptima al origen menos costoso. Si la entrada es un ráster, debe constar de celdas con valores válidos para los destinos, y se debe asignar NoData a las celdas restantes. Cero es un valor válido. | Raster Layer; Feature Layer |
in_distance_accumulation_raster | El ráster de acumulación de distancia se utiliza para determinar la ruta óptima desde los orígenes hasta los destinos. El ráster de acumulación de distancia se suele crear con las herramientas Acumulación de distancia o Asignación de distancia. Cada celda del ráster de acumulación de distancia representa el coste-distancia acumulativo mínimo sobre una superficie desde cada celda hasta un conjunto de celdas de origen. | Raster Layer |
in_back_direction_raster | El ráster de dirección hacia atrás contiene direcciones calculadas en grados. La dirección identifica la siguiente celda a lo largo de la ruta óptima, de vuelta al origen de menor coste-distancia acumulado, a la vez que se evitan barreras. 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 |
destination_field (Opcional) | El campo que se utiliza para obtener valores para las ubicaciones de destino. | Field |
path_type (Opcional) | Especifica 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 |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_path_accumulation_raster | El ráster de salida. | Raster |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la herramienta OptimalPathAsRaster.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outOptimalRasPath = OptimalPathAsRaster("observers", "distAccum.tif", "backDir2", "IdField", "EACH_CELL")
outOptimalRasPath.save("c:/sapyexamples/output/bestpaths.tif")Calcular la ruta de menor coste desde un origen a su destino.
# Name: OptimalPathAsRaster_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"
distAccumRaster = "distAccum.tif"
backDir = "backDir2.tif"
destField = "FID"
pathType = "EACH_CELL"
# Execute CostPath
outOptimalRasPath = OptimalPathAsRaster(inDestination, distAccumRaster, backDir, destField,
pathType)
# Save the output
outOptimalRasPath.save("c:/sapyexamples/output/optimalraspath02.tif")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst