Ruta óptima como línea (Análisis ráster)

Resumen

Calcula la ruta óptima desde un origen hasta un destino como una línea.

Ilustración

Uso

• Esta herramienta de portal de análisis ráster está disponible cuando se inicia sesión en un ArcGIS Enterprise que tiene un ArcGIS Image Server configurado para Análisis de ráster . Cuando se invoca la herramienta, ArcGIS Pro funciona como cliente y tiene lugar el procesamiento 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 óptima como línea produce un servicio de entidades de línea de salida que registra la ruta o rutas óptimas desde destinos cuyo origen más cercano esté definido dentro de la superficie de coste acumulativo o la superficie de distancia euclidiana.

• 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 para los destinos de entrada, se debe tener cuidado con la manera en que se administra el tamaño de celda de salida, especialmente cuando es de baja resolución en relación con los detalles presentes en la entrada. Se aplica un proceso interno de rasterización con la herramienta Entidad a ráster. 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.

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

• A diferencia de muchas otras herramientas de análisis de ráster, Ruta óptima como lí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 datos de destino de entidad de entrada	Dataset de entidades o ráster que identifica ubicaciones desde las que se determina la ruta con menor coste acumulativo hasta el origen menos costoso. Para un ráster, el tipo de entrada debe ser entero y debe constar de celdas con valores válidos (cero es un valor válido). Se debe asignar NoData a las celdas restantes. En el caso de un servicio de entidades, el tipo de entrada puede ser un punto, una línea o un polígono.	Raster Layer; Image Service; Feature Layer; String
Ráster de acumulación de distancia de entrada	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; Image Service; String
Ráster de dirección de flujo o dirección hacia atrás de entrada	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 oscila entre 0 y 360 grados. El valor 0 se reserva para las celdas de origen. Hacia el este (derecha) es 90 grados y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte).	Raster Layer; Image Service; String
Ruta óptima de salida como entidad	El nombre del servicio de entidades de salida que contiene las rutas óptimas.	String
Campo de destino (Opcional)	El campo que se utilizará para obtener valores para las ubicaciones de destino. Este campo debe ser un entero.	Field
Tipo de ruta (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. Cada zona—Por cada zona en los datos de destino de entrada, se determina una ruta de menor coste y se guardará en el ráster de salida. Con esta opción, la ruta de menor coste de cada zona comienza en la celda con la ponderación de distancia de coste más baja de la zona. Esta es la opción predeterminada. 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 celda—Por cada celda con valores válidos en los datos de destino de entrada, se determinará un menor coste y se guardará en el ráster de salida. Con esta opción, cada celda de los datos de destino de entrada se trata de forma separada y se determina una ruta de menor coste para cada celda.	String
Crear rutas de red (Opcional)	Especifica si se calculan rutas completas y, posiblemente, superpuestas de los destinos a los orígenes, o si se crean rutas de red no superpuestas. Desactivado: se calculan rutas completas de los destinos a los orígenes, las cuales pueden estar superpuestas. Esta es la opción predeterminada. Activado: se calculan rutas de red no superpuestas.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Entidad de polilínea de salida	La salida de servicio de entidades con las rutas óptimas.	Capa de entidades

Python

arcpy.ra.OptimalPathAsLine(inputDestinationRasterOrFeatures, inputDistanceAccumulationRaster, inputBackDirectionRaster, outputPolylineName, {destinationField}, {pathType}, {createNetworkPaths})

Nombre	Explicación	Tipo de datos
inputDestinationRasterOrFeatures	Dataset de entidades o ráster que identifica ubicaciones desde las que se determina la ruta con menor coste acumulativo hasta el origen menos costoso. Para un ráster, el tipo de entrada debe ser entero y debe constar de celdas con valores válidos (cero es un valor válido). Se debe asignar NoData a las celdas restantes. En el caso de un servicio de entidades, el tipo de entrada puede ser un punto, una línea o un polígono.	Raster Layer; Image Service; Feature Layer; String
inputDistanceAccumulationRaster	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; Image Service; String
inputBackDirectionRaster	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 oscila entre 0 y 360 grados. El valor 0 se reserva para las celdas de origen. Hacia el este (derecha) es 90 grados y los valores aumentan en el sentido de las agujas del reloj (180 es sur, 270 es oeste y 360 es norte).	Raster Layer; Image Service; String
outputPolylineName	El nombre del servicio de entidades de salida que contiene las rutas óptimas.	String
destinationField (Opcional)	El campo que se utilizará para obtener valores para las ubicaciones de destino. Este campo debe ser un entero.	Field
pathType (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. EACH_ZONE—Por cada zona en los datos de destino de entrada, se determina una ruta de menor coste y se guardará en el ráster de salida. Con esta opción, la ruta de menor coste de cada zona comienza en la celda con la ponderación de distancia de coste más baja de la zona. Esta es la opción predeterminada. 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_CELL—Por cada celda con valores válidos en los datos de destino de entrada, se determinará un menor coste y se guardará en el ráster de salida. Con esta opción, cada celda de los datos de destino de entrada se trata de forma separada y se determina una ruta de menor coste para cada celda.	String
createNetworkPaths (Opcional)	Especifica si se calculan rutas completas y, posiblemente, superpuestas de los destinos a los orígenes, o si se crean rutas de red no superpuestas. DESTINATIONS_TO_SOURCES—Se calculan rutas completas de los destinos a los orígenes, las cuales pueden estar superpuestas. Esta es la opción predeterminada. NETWORK_PATHS—Se calculan rutas de red no superpuestas.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
outputPolylineFeatures	La salida de servicio de entidades con las rutas óptimas.	Capa de entidades

Muestra de código

Ejemplo 1 de Ruta óptima como línea (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta OptimalPathAsLine.

import arcpy

arcpy.OptimalPathAsLine_ra(
    "https://myserver/rest/services/destination/ImageServer", 
    "https://myserver/rest/services/accumulationraster/ImageServer", 
    "https://myserver/rest/services/backdirection/ImageServer", 
    "outpath")

Ejemplo 2 de Ruta óptima como línea (script independiente)

Calcula la ruta óptima desde un destino hasta un origen.

#-------------------------------------------------------------------------------
# Name: OptimalPathAsLine_Ex_02.py
# Description: Calculates the optimal 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'
inputAccumulationLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/costaccumulation/ImageServer'
inputDirectionLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/backdirection/ImageServer'
outputName = 'outTravelPaths'


arcpy.OptimalPathAsLine_ra(inputDestinationLayer, inputAccumulationLayer,
                            inputDirectionLayer, outputName)

Entornos

Sistema de coordenadas de salida

Casos especiales

Información de licenciamiento

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