Ruta de coste como polilínea (Análisis ráster)

Resumen

Calcula la ruta de menor coste desde un origen a su destino como una entidad de línea.

Heredado:

Esta herramienta está obsoleta y se eliminará en una versión futura.

La herramienta Ruta óptima como línea proporciona una funcionalidad o rendimiento mejorados.

Más información sobre cómo crear la ruta de menor coste

Ilustración

Uso

• Esta herramienta del portal de análisis de ráster está disponible al iniciar sesión en un portal de ArcGIS Enterprise que tenga configurado ArcGIS Image Server para Análisis de ráster. Cuando se ejecuta la herramienta, ArcGIS Pro funciona como cliente y el procesamiento tiene lugar en los servidores federados con ArcGIS Enterprise. La herramienta del portal acepta las capas de su portal como entrada y crea la salida en su portal.

  La capa ráster de entrada admite una capa del portal, una URI o URL de un servicio de imágenes o la salida procedente de la herramienta Crear capa de servidor de imágenes. La capa de entidades de entrada puede ser una capa del portal o una URI o URL de un servicio de entidades. Esta herramienta no admite capas o datos ráster locales. Aunque puede usar las capas y los datos de entidades locales como entradas de esta herramienta del portal, la práctica recomendada es usar capas del portal como entrada.

• La herramienta Ruta de coste como polilínea produce un servicio de entidades de polilínea de salida que registra la ruta o las rutas de menor coste desde orígenes cuyo destino más cercano esté definido dentro de la superficie de coste acumulativo o la superficie de distancia euclidiana.

• Si tiene entidades de destino, puede convertirlas a un servicio de imágenes con la función ráster Rasterizar entidades. Use el Ráster de coste-distancia existente como el Ráster de entrada en la función de rasterización. De esta manera, se garantiza que las entidades se conviertan adecuadamente a un servicio de imágenes con el mismo tamaño de celda, extensión y referencia espacial.

• Los valores NoData que existen en el Ráster de destino no se incluyen como valores válidos en la función. El valor 0 se considera un valor legítimo en el ráster de destino.

• Se necesitan dos servicios de imágenes de entrada para poder ejecutar Ruta de coste como polilínea. El modo de generar las entradas depende del tipo de análisis que desee completar.

  • Análisis de costes genera una ruta de coste. Ejecute las funciones ráster Vínculo de menor coste y Coste-distancia para generar las entradas necesarias.
  • Análisis euclidiano genera rutas en línea recta y rutas alrededor de barreras. Ejecute la herramienta Calcular distancia para generar Dirección euclidiana hacia atrás y Distancia euclidiana. Como alternativa, ejecute las funciones ráster Dirección euclidiana hacia atrás y Distancia euclidiana.
  • Análisis de flujo genera rutas de flujo. Ejecute la función ráster Dirección de flujo con la opción D8. Utilice un ráster de dirección de 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.

• El servicio de entidades de salida tiene un campo denominado DestID que identifica el destino al que se dirige cada línea.

• A diferencia de la mayoría de herramientas de Análisis de ráster, Ruta de coste como polilínea ignorará la siguiente configuración del entorno: Sistema de coordenadas de salida, Extensión, Tamaño de celda y Ráster de alineación. El patrón del ráster de vínculo se verá considerablemente alterado si se remuestrea o reproyecta, lo cual genera una ruta incorrecta.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Ráster o entidades de destino de entrada	Un servicio de imágenes o servicio de entidades que identifica aquellas ubicaciones desde donde se determina la ruta de menor coste al origen menos costoso. Si la entrada es un servicio de imágenes, 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; Image Service; Feature Layer; String
Ráster de distancia euclidiana o coste-distancia de entrada	El ráster distancia euclidiana o coste-distancia que se utiliza para determinar la ruta de menor coste desde los orígenes hasta los destinos.	Raster Layer; Image Service; String
Ráster de vínculo de menor coste de entrada, dirección hacia atrás o dirección del flujo de entrada	El nombre del ráster utilizado para determinar la ruta para volver a un origen mediante la ruta de menor coste o la ruta más corta. Para cada celda en el ráster de vínculo o dirección, un valor identifica al vecino que es la próxima celda en la ruta desde la celda hasta una celda de origen.	Raster Layer; Image Service; String
Nombre de la polilínea de salida	El servicio de entidades de salida que contendrá la ruta de menor coste.	String
Tipo de ruta (Opcional)	Especifica 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. Mejor simple—Para todas las celdas en los datos de destino de entrada, la ruta de menor coste derivará de la celda con las rutas de menor coste mínimas a las celdas de origen. Cada zona—Por cada zona en los datos de destino de entrada, se determina una ruta de menor coste y se guarda en el ráster de salida. Con esta opción, la ruta de menor coste de cada zona comenzará en la celda con la ponderación de coste-distancia más baja de la zona. Cada celda—Por cada celda con valores válidos en los datos de destino de entrada, se determina una ruta de menor coste y se guarda en el ráster de salida. Con esta opción, cada celda de los datos de destino de entrada se tratará de forma separada y se determinará una ruta de menor coste para cada una desde la celda.	String
Campo de destino (Opcional)	El campo que se utilizará para obtener valores para las ubicaciones de destino.	Field

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidad de polilínea de salida	Las entidades de polilínea.	Feature Layer

Python

arcpy.ra.CostPathAsPolyline(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputPolylineName, {pathType}, {destinationField})

Nombre	Explicación	Tipo de datos
inputDestinationRasterOrFeatures	Un servicio de imágenes o servicio de entidades que identifica aquellas ubicaciones desde donde se determina la ruta de menor coste al origen menos costoso. Si la entrada es un servicio de imágenes, 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; Image Service; Feature Layer; String
inputCostDistanceRaster	El ráster distancia euclidiana o coste-distancia que se utiliza para determinar la ruta de menor coste desde los orígenes hasta los destinos.	Raster Layer; Image Service; String
inputCostBacklinkRaster	El nombre del ráster utilizado para determinar la ruta para volver a un origen mediante la ruta de menor coste o la ruta más corta. Para cada celda en el ráster de vínculo o dirección, un valor identifica al vecino que es la próxima celda en la ruta desde la celda hasta una celda de origen.	Raster Layer; Image Service; String
outputPolylineName	El servicio de entidades de salida que contendrá la ruta de menor coste.	String
pathType (Opcional)	Especifica 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. BEST_SINGLE—Para todas las celdas en los datos de destino de entrada, la ruta de menor coste derivará de la celda con las rutas de menor coste mínimas a las celdas de origen. EACH_ZONE—Por cada zona en los datos de destino de entrada, se determina una ruta de menor coste y se guarda en el ráster de salida. Con esta opción, la ruta de menor coste de cada zona comenzará en la celda con la ponderación de coste-distancia más baja de la zona. EACH_CELL—Por cada celda con valores válidos en los datos de destino de entrada, se determina una ruta de menor coste y se guarda en el ráster de salida. Con esta opción, cada celda de los datos de destino de entrada se tratará de forma separada y se determinará una ruta de menor coste para cada una desde la celda.	String
destinationField (Opcional)	El campo que se utilizará para obtener valores para las ubicaciones de destino.	Field

Salida derivada

Nombre	Explicación	Tipo de datos
outputPolylineFeatures	Las entidades de polilínea.	Feature Layer

Muestra de código

Ejemplo 1 de CostPathAsPolyline (ventana de Python)

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

import arcpy

arcpy.ra.CostPathAsPolyline(
    "https://myserver/rest/services/destination/ImageServer", 
    "https://myserver/rest/services/costsurface/ImageServer", 
    "https://myserver/rest/services/direction/ImageServer", 
    "outpath", "BEST_SINGLE")

Ejemplo 2 de CostPathAsPolyline (script independiente)

Calcula la ruta de menor coste desde un origen a su destino.

#-------------------------------------------------------------------------------
# Name: CostPathAsPolyline_Ex_02.py
# Description: Calculates the least-cost path from a source to a destination.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputDestinationLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/destination/ImageServer'
inputCostLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/costraster/ImageServer'
inputDirectionLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/direction/ImageServer'
outputName = 'outTravelPaths'
pathType = 'BEST_SINGLE'

arcpy.ra.CostPathAsPolyline(inputDestinationLayer, inputCostLayer,
                            inputDirectionLayer, outputName, pathType)

Entornos

Sistema de coordenadas de salida

Información de licenciamiento

• Basic: Requiere ArcGIS Image Server
• Standard: Requiere ArcGIS Image Server
• Advanced: Requiere ArcGIS Image Server