Determinar red de coste de viaje óptimo (Análisis de ráster)

Resumen

Calcula la red de coste óptimo a partir de un conjunto de regiones de entrada.

Ilustración

Ilustración de la herramienta Determinar red de coste de viaje óptimo

Uso

  • Esta herramienta de portal de análisis ráster está disponible cuando se inicia sesión en un ArcGIS Enterprise Enlace a información sobre el análisis en el portal de ArcGIS Enterprise que tiene un ArcGIS Image Server enlace a Qué es ArcGIS Image Server configurado para Raster Analysis Enlace a Configurar e implementar análisis de ráster. 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 encontrar la mejor red para vehículos de emergencia.

  • En un ráster, una región es un grupo de celdas con el mismo valor que son contiguas unas a otras (adyacentes). Cuando las regiones de entrada se identifican mediante un ráster, si hay zonas (celdas con el mismo valor) que están formadas por varias regiones, preprocese los datos para asignar valores únicos a cada región.

  • Las ubicaciones de celda con NoData en el Ráster de costes de entrada actúan como barreras.

  • El Ráster de costes de entrada no puede contener valores de cero debido a que el algoritmo es un proceso multiplicativo. Si el ráster de costes contiene valores de cero y estos valores representan las áreas de más bajo coste, cambie los valores de cero a un valor positivo pequeño (como 0,01) antes de ejecutar Determinar red de gastos de viaje óptimos

  • Para la Red vecina de salida, los vecinos no se identifican mediante la Distancia euclidiana, sino por el coste-distancia. Por lo tanto, el vecino más cercano a una región será el más barato al que viajar, en lugar de serlo el más cercano en distancia.

Sintaxis

arcpy.ra.DetermineOptimumTravelCostNetwork(inputRegionsRasterOrFeatures, inputCostRaster, outputOptimumNetworkName, {outputNeighborNetworkName})
ParámetroExplicaciónTipo de datos
inputRegionsRasterOrFeatures

Las regiones de entrada que se deben conectar mediante la red de mínimo coste.

Las regiones se pueden definir mediante un servicio de imágenes o un servicio de entidades.

Si la entrada de la región es un ráster, las regiones se definen mediante grupos de celdas contiguas (adyacentes) con el mismo valor. Cada región se debe numerar de forma única. Las celdas que no formen parte de ninguna región deberán ser NoData. El tipo de ráster debe ser un número entero y los valores pueden ser positivos o negativos.

Si la entrada de la región es una entidad, puede tratarse de polígonos, líneas o puntos. Las regiones de la entidad poligonal no pueden estar compuestas por polígonos multiparte.

Raster Layer; Image Service; Feature Layer; String
inputCostRaster

Ráster que define la impedancia o el coste de hacer un movimiento planimétrico por medio de cada celda.

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
outputOptimumNetworkName

El nombre del servicio de entidades de red óptima de salida.

El servicio de entidades de polilínea de la red óptima (de mínimo coste) de rutas necesario para conectar todas las regiones de entrada.

Cada ruta (o línea) está numerada de forma única y hay campos adicionales en la tabla de atributos donde se almacena información específica sobre la ruta. Estos campos incluyen lo siguiente:

  • PATHID: identificador único de la ruta
  • PATHCOST: coste acumulado total de la ruta
  • REGION1: primera región que conecta la ruta
  • REGION2: la otra región que conecta la ruta

Esta información ofrece una perspectiva de las rutas que hay dentro de la red.

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

String
outputNeighborNetworkName
(Opcional)

El nombre del servicio de entidades de red vecina de salida.

El servicio de entidades de polilínea que identifica todas las rutas de cada región a cada uno de sus vecinos de coste más cercanos.

Cada ruta (o línea) está numerada de forma única y hay campos adicionales en la tabla de atributos donde se almacena información específica sobre la ruta. Estos campos incluyen lo siguiente:

  • PATHID: identificador único de la ruta
  • PATHCOST: coste acumulado total de la ruta
  • REGION1: primera región que conecta la ruta
  • REGION2: la otra región que conecta la ruta

Esta información ofrece una perspectiva de las rutas que hay dentro de la red y resulta especialmente útil para decidir las rutas que se deben eliminar, en caso necesario.

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

String

Salida derivada

NombreExplicaciónTipo de datos
outputOptimumNetworkFeatures

Las entidades de red óptimas de salida.

Capa ráster
outputNeighborNetworkFeatures

Las entidades de red vecinas de salida.

Clase de entidad

Muestra de código

Ejemplo 1 de DetermineOptimumTravelCostNetwork (ventana de Python)

En este ejemplo se calcula la red de gastos de viaje óptimos.

import arcpy

arcpy.DetermineOptimumTravelCostNetwork_ra(
    "https://myserver/rest/services/sources/ImageServer", 
	"https://myserver/rest/services/costsurface/ImageServer", 
    "outoptimumnetwork1")
Ejemplo 2 de DetermineOptimumTravelCostNetwork (script independiente)

En este ejemplo se calcula la red de gastos de viaje óptimos.

#-------------------------------------------------------------------------------
# Name: DetermineOptimumTravelCostNetwork_Ex_02.py
# Description: Calculates the optimum travel cost network.
# 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'
outputOptimumNetworkName = 'outNetworkRaster'
outputNeighborName = 'outNeighborRaster'

arcpy.DetermineOptimumTravelCostNetwork_ra(inputSourceLayer, zoneField, inputCostLayer,
                               outputOptimumNetworkName, outputNeighborName)

Información de licenciamiento

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

Temas relacionados