Determinar rutas de gastos de viaje hasta destinos (Análisis ráster)—ArcGIS Pro

Resumen

Calcula rutas específicas entre orígenes conocidos y destinos conocidos.

La herramienta Ruta óptima como ráster proporciona una funcionalidad o rendimiento mejorados.

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 Raster Analysis . 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.
Un ejemplo de aplicación de esta herramienta es hallar los gastos de viaje para llegar a determinados destinos.
La herramienta Determinar rutas de gastos de viaje hasta destinos 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 coste-distancia.
Generalmente, es necesario ejecutar Calcular gastos de viaje antes de ejecutar Determinar rutas de gastos de viaje hasta destinos para crear los servicios de imágenes de vínculo de menor coste y de coste-distancia de entrada. Son servicios de imágenes de entrada obligatorios para Determinar rutas de gastos de viaje hasta destinos.
A cada ruta de menor coste se le asigna un valor cuando se encuentra en el proceso de escaneado. La última celda del origen inicial (del cual derivan los rásteres de coste-distancia 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 servicio de imágenes, el conjunto de celdas de destino consta de todas las celdas del servicio de imágenes 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.
Cuando la entrada de origen es un servicio de entidades, de manera predeterminada se utilizará el primer campo disponible válido. Si no existen otros campos válidos, se utilizará el campo ObjectID (por ejemplo, OID o FID).
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 herramienta Determinar rutas de gastos de viaje hasta destinos 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.
Determinar rutas de gastos de viaje hasta destinos también se puede utilizar para derivar la ruta de menor resistencia a un modelo digital de elevación (DEM). En este caso, utilice el DEM para el Ráster de coste-distancia de entrada y la salida de la herramienta Dirección de flujo para el Ráster de vínculo de menor coste de entrada. Los valores válidos para el ráster de dirección del flujo son 1, 2, 4, 8, 16, 32, 64 y 128; los valores válidos para el ráster de vínculo son los números del 0 al 360. Los servicios de imágenes son aceptables.
Cuando los datos de destino de entrada son una entidad, deben contener al menos un campo válido.

Parámetros

Etiqueta	Explicación	Tipo de datos
Ráster o entidades de destino de entrada	Un servicio de imágenes o un servicio de entidades que identifica las celdas desde las que se determina la ruta de menor coste para el 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 coste-distancia de entrada	El nombre de un servicio de imágenes de coste-distancia que se utiliza para determinar la ruta de menor coste desde las ubicaciones de destino a un origen. El ráster de coste-distancia se crea generalmente con la herramienta Calcular gastos de viaje. El ráster de coste-distancia almacena, para cada celda, el coste-distancia acumulativo mínimo sobre una superficie de coste desde cada celda hasta un conjunto de celdas de origen.	Raster Layer; Image Service; String
Ráster de vínculo de menor coste de entrada	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; Image Service; String
Nombre de salida	El nombre del servicio ráster de rutas de gastos de viaje de salida. El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.	String
Campo de destino (Opcional)	Un campo en la capa de destino que contiene los valores que definen cada destino. El servicio de entidades de entrada debe contener al menos un campo válido.	String
Tipo de ruta (Opcional)	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. A 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 trata de forma separada y se determina una ruta de menor coste para cada una desde la celda. Esta es la opción predeterminada. A 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 comienza en la celda con la ponderación de distancia de coste más baja de la zona. Mejor simple—Para todas las celdas en los datos de destino de entrada, la ruta de menor coste deriva de la celda con las rutas de menor coste mínimas a las celdas de origen.	String

Salida derivada

Etiqueta	Explicación	Tipo de datos
Ráster de salida	El ráster de salida.	Raster Layer

arcpy.ra.DetermineTravelCostPathsToDestinations(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputName, {destinationField}, {pathType})

Nombre	Explicación	Tipo de datos
inputDestinationRasterOrFeatures	Un servicio de imágenes o un servicio de entidades que identifica las celdas desde las que se determina la ruta de menor coste para el 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 nombre de un servicio de imágenes de coste-distancia que se utiliza para determinar la ruta de menor coste desde las ubicaciones de destino a un origen. El ráster de coste-distancia se crea generalmente con la herramienta Calcular gastos de viaje. El ráster de coste-distancia almacena, para cada celda, el coste-distancia acumulativo mínimo sobre una superficie de coste desde cada celda hasta un conjunto de celdas de origen.	Raster Layer; Image Service; String
inputCostBacklinkRaster	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; Image Service; String
outputName	El nombre del servicio ráster de rutas de gastos de viaje de salida. El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.	String
destinationField (Opcional)	Un campo en la capa de destino que contiene los valores que definen cada destino. El servicio de entidades de entrada debe contener al menos un campo válido.	String
pathType (Opcional)	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_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 trata de forma separada y se determina una ruta de menor coste para cada una desde la celda. Esta es la opción predeterminada. 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 comienza en la celda con la ponderación de distancia de coste más baja de la zona. BEST_SINGLE—Para todas las celdas en los datos de destino de entrada, la ruta de menor coste deriva de la celda con las rutas de menor coste mínimas a las celdas de origen.	String

Salida derivada

Nombre	Explicación	Tipo de datos
outputRaster	El ráster de salida.	Raster Layer

Muestra de código

Ejemplo 1 de DetermineTravelCostPathsToDestinations (ventana de Python)

En este ejemplo se calculan los gastos de viaje hasta los destinos.

import arcpy

arcpy.DetermineTravelCostPathstoDestinations_ra(
    "https://myserver/rest/services/sources/ImageServer", 
    "https://myserver/rest/services/costsurface/ImageServer", 
    "https://myserver/rest/services/backlinkras/ImageServer", 
    "outpath", "destField", "EACH_ZONE")

Ejemplo 2 de DetermineTravelCostPathsToDestinations (script independiente)

En este ejemplo se calculan los gastos de viaje hasta los destinos.

#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathstoDestinations_Ex_02.py
# Description: Calculates the optimum travel cost path.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputSourceLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
inputCostLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/costraster/ImageServer'
inputBackLinkLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/backlinkras/ImageServer'
outputName = 'outTravelPathsRaster'
destField = 'dest1'
pathType = 'BEST_SINGLE'

arcpy.DetermineTravelCostPathstoDestinations_ra(inputSourceLayer, inputCostLayer,
                                                inputBackLinkLayer, outputName, 
						destField, pathType)

Entornos

Tamaño de celda, Extensión, Máscara, Sistema de coordenadas de salida, Alinear ráster

Resumen

Ilustración

Uso

Parámetros

Salida derivada

Salida derivada

Muestra de código

Entornos

Casos especiales

Información de licenciamiento

Temas relacionados

En este tema