Determinar ruta de coste de viaje como polilínea (Análisis ráster)

Resumen

Calcula la ruta de polilínea de menor coste entre orígenes y destinos.

Heredado:

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

Las herramientas Acumulación de distancia y Ruta óptima como línea proporcionan una funcionalidad o rendimiento mejorados.

Ilustración

Ilustración de la herramienta Determinar ruta de coste de viaje como polilínea

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 Determinar ruta de coste de viaje como polilínea produce una entidad de salida de rutas de menor coste desde los orígenes hasta los destinos.

  • Si el origen de la entrada de destino es un servicio de imágenes, las celdas que no sean orígenes ni destinos deben tener el valor NoData. Las celdas de estas entradas que tengan un valor, aunque sea cero, se utilizarán como orígenes o destinos válidos.

  • La superficie de coste de entrada no puede tener valores que sean cero ni negativos.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster o entidades de origen 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 a los destinos.

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 costes de entrada

El nombre de un servicio de imágenes ráster de costes que se utiliza para determinar la ruta de menor coste desde los orígenes a los destinos.

El valor de cada ubicación de celda representa la distancia de coste por unidad para moverse a través de la celda. Cada valor de ubicación de celda se multiplica por la resolución de la celda mientras que también se compensa por el movimiento diagonal para obtener el coste total de pasar por medio de la celda.

Los valores del ráster de coste pueden ser enteros o de punto flotante, pero no pueden ser negativos o cero (no puede tener un coste negativo o cero).

Raster Layer; Image Service; String
Ráster o entidades de destino de entrada

Un servicio de imágenes o un servicio de entidades que identifica las celdas en las que se calcula la ruta de menor coste.

Raster Layer; Image Service; Feature Layer; String
Nombre de la polilínea de salida

El nombre del servicio de entidades de polilínea de salida.

El servicio de entidades de polilínea de las rutas óptimas (de menor coste) que conectan orígenes y destinos.

Cada ruta (o línea) está numerada de forma única y cuenta con un campo adicional en la tabla de atributos denominado DestID, que vuelve a conectarla con el identificador único del ráster de destino.

Como cada ruta se representa mediante una línea única, puede haber varias líneas en las ubicaciones donde las rutas transcurren por el mismo camino.

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.

  • A cada celdaPor cada celda o ubicación con valores válidos en los datos de destino de entrada, se determina una ruta de menor coste y se guarda en la salida. Con esta opción, cada celda o ubicación de los datos de destino de entrada se tratan de forma separada y se determina una ruta de menor coste para cada una desde la celda.
  • A cada zonaPor cada zona en los datos de destino de entrada, se determina una ruta de menor coste y se guarda en la salida. Con esta opción, la ruta de menor coste de cada zona comienza en la ubicación con la ponderación de coste-distancia más baja de la zona.
  • Mejor simplePara todas las ubicaciones de los datos de destino de entrada, la ruta de menor coste deriva de la ubicación con el mínimo de rutas de menor coste a las ubicaciones de origen. Esta es la opción predeterminada.
String
Campo de destino
(Opcional)

El campo que se utiliza para obtener valores para las ubicaciones de destino.

Los datos de entidad de entrada deben contener al menos un campo de tipo entero válido.

Field

Salida derivada

EtiquetaExplicaciónTipo de datos
Entidades de polilínea de salida

Las entidades de polilínea de salida.

Feature Class

arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})
NombreExplicaciónTipo de datos
inputSourceRasterOrFeatures

Un servicio de imágenes o un servicio de entidades que identifica las celdas desde las que se determina la ruta de menor coste a los destinos.

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
inputCostRaster

El nombre de un servicio de imágenes ráster de costes que se utiliza para determinar la ruta de menor coste desde los orígenes a los destinos.

El valor de cada ubicación de celda representa la distancia de coste por unidad para moverse a través de la celda. Cada valor de ubicación de celda se multiplica por la resolución de la celda mientras que también se compensa por el movimiento diagonal para obtener el coste total de pasar por medio de la celda.

Los valores del ráster de coste pueden ser enteros o de punto flotante, pero no pueden ser negativos o cero (no puede tener un coste negativo o cero).

Raster Layer; Image Service; String
inputDestinationRasterOrFeatures

Un servicio de imágenes o un servicio de entidades que identifica las celdas en las que se calcula la ruta de menor coste.

Raster Layer; Image Service; Feature Layer; String
outputPolylineName

El nombre del servicio de entidades de polilínea de salida.

El servicio de entidades de polilínea de las rutas óptimas (de menor coste) que conectan orígenes y destinos.

Cada ruta (o línea) está numerada de forma única y cuenta con un campo adicional en la tabla de atributos denominado DestID, que vuelve a conectarla con el identificador único del ráster de destino.

Como cada ruta se representa mediante una línea única, puede haber varias líneas en las ubicaciones donde las rutas transcurren por el mismo camino.

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.

  • EACH_CELLPor cada celda o ubicación con valores válidos en los datos de destino de entrada, se determina una ruta de menor coste y se guarda en la salida. Con esta opción, cada celda o ubicación de los datos de destino de entrada se tratan de forma separada y se determina una ruta de menor coste para cada una desde la celda.
  • EACH_ZONEPor cada zona en los datos de destino de entrada, se determina una ruta de menor coste y se guarda en la salida. Con esta opción, la ruta de menor coste de cada zona comienza en la ubicación con la ponderación de coste-distancia más baja de la zona.
  • BEST_SINGLEPara todas las ubicaciones de los datos de destino de entrada, la ruta de menor coste deriva de la ubicación con el mínimo de rutas de menor coste a las ubicaciones de origen. Esta es la opción predeterminada.
String
destinationField
(Opcional)

El campo que se utiliza para obtener valores para las ubicaciones de destino.

Los datos de entidad de entrada deben contener al menos un campo de tipo entero válido.

Field

Salida derivada

NombreExplicaciónTipo de datos
outputPolylineFeatures

Las entidades de polilínea de salida.

Feature Class

Muestra de código

Ejemplo 1 de DetermineTravelCostPathAsPolyline (ventana de Python)

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

import arcpy

arcpy.ra.DetermineTravelCostPathAsPolyline(
    "https://myserver/rest/services/sources/ImageServer", 
    "https://myserver/rest/services/costsurface/ImageServer", 
    "https://myserver/rest/services/destination/ImageServer", 
    "outpath", "BEST_SINGLE")
Ejemplo 2 de DetermineTravelCostPathAsPolyline (script independiente)

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

#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathAsPolyline_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'
inputDestinationLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/destinationras/ImageServer'
outputName = 'outTravelPaths'
pathType = 'BEST_SINGLE'

arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceLayer, inputCostLayer,
                                           inputDestinationLayer, outputName, pathType)

Información de licenciamiento

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

Temas relacionados