Resumen
Calcula la ruta de polilínea de menor coste entre orígenes y destinos.
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.
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.
Sintaxis
arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})| Parámetro | 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.
| 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. | Clase de entidad |
Muestra de código
En este ejemplo se calculan los costes de viaje hasta los destinos.
import arcpy
arcpy.DetermineTravelCostPathAsPolyline_ra(
"https://myserver/rest/services/sources/ImageServer",
"https://myserver/rest/services/costsurface/ImageServer",
"https://myserver/rest/services/destination/ImageServer",
"outpath", "BEST_SINGLE")En este ejemplo se calculan los costes 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.DetermineTravelCostPathAsPolyline_ra(inputSourceLayer, inputCostLayer,
inputDestinationLayer, outputName, pathType)Información de licenciamiento
- Basic: Requiere ArcGIS Image Server
- Standard: Requiere ArcGIS Image Server
- Advanced: Requiere ArcGIS Image Server