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

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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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 celda—Por 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 zona—Por 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 simple—Para 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

Etiqueta	Explicación	Tipo de datos
Entidades de polilínea de salida	Las entidades de polilínea de salida.	Feature Class

Python

arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})

Nombre	Explicación	Tipo 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_CELL—Por 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_ZONE—Por 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_SINGLE—Para 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

Nombre	Explicación	Tipo 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)

Entornos

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

Información de licenciamiento

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