Resumen
Calcula rutas específicas entre orígenes conocidos y destinos conocidos.
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.
Sintaxis
arcpy.ra.DetermineTravelCostPathsToDestinations(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputName, {destinationField}, {pathType})| Parámetro | 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 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; 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.
| String |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| outputRaster | El ráster de salida. | Capa ráster |
Muestra de código
En este ejemplo se calculan los costes 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")En este ejemplo se calculan los costes 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)Información de licenciamiento
- Basic: Requiere ArcGIS Image Server
- Standard: Requiere ArcGIS Image Server
- Advanced: Requiere ArcGIS Image Server