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

Resumen

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

Heredado:

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

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

Ilustración

Ilustración de la herramienta Determinar rutas de gastos de viaje hasta destinos

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.

  • 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
    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

EtiquetaExplicaciónTipo 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 celdaPor 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 zonaPor 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 simplePara 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

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida.

Raster Layer

arcpy.ra.DetermineTravelCostPathsToDestinations(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputName, {destinationField}, {pathType})
NombreExplicaciónTipo 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_CELLPor 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_ZONEPor 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_SINGLEPara 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

NombreExplicaciónTipo 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.ra.DetermineTravelCostPathstoDestinations(
    "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.ra.DetermineTravelCostPathstoDestinations(inputSourceLayer, inputCostLayer,
                                                inputBackLinkLayer, outputName, 
                                                destField, pathType)

Entornos

Información de licenciamiento

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

Temas relacionados