Déterminer le chemin de coût de déplacement sous forme d’une polyligne (Analyse raster)

Synthèse

Calcule le chemin de moindre coût sous forme d’une polyligne entre les sources et les destinations.

Conseil :

Les outils Accumulation de distance et Chemin optimal comme ligne fournissent des fonctions ou des performances améliorées.

Illustration

Illustration de l’outil Déterminer le chemin de coût de déplacement sous forme d’une polyligne

Utilisation

  • Cet outil de portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise disposant d’un ArcGIS Image Server configuré pour Analyse raster. Lorsque cet outil est appelé, ArcGIS Pro est utilisé comme client et le traitement est effectué dans les serveurs fédérés avec ArcGIS Enterprise. Cet outil du portail prend en charge les couches de votre portail en entrée et crée la sortie dans le portail.

    La couche raster en entrée prend en charge les éléments suivants : couche du portail, URI ou URL d’un service d’imagerie ou sortie de l’outil Créer une couche de serveur d’imagerie. La couche d’entités en entrée peut être une couche du portail, ou une URI ou une URL d’un service d’entités. Cet outil ne prend pas en charge les données raster ou les couches locales. Bien que vous ayez la possibilité d’utiliser des données d’entité et des couches locales en entrée dans cet outil du portail, il est recommandé d’utiliser les couches de votre portail en entrée.

  • L’outil Déterminer le chemin de coût de déplacement sous forme d’une polyligne produit une entité en sortie des chemins de moindre coût, des sources jusqu’aux destinations.

  • Lorsque les données de destination source ou en entrée représentent un service d’imagerie, les cellules qui ne sont ni des sources ni des destinations doivent comporter la valeur NoData. Toute cellule dans l’une de ces entrées ayant une valeur, y compris la valeur zéro, sera utilisée comme une source ou une destination valide.

  • La surface de coût en entrée ne peut pas avoir une valeur nulle ou négative.

Paramètres

ÉtiquetteExplicationType de données
Entités ou raster source en entrée

Service d’imagerie ou d’entités identifiant les cellules à partir desquelles le chemin de moindre coût est déterminé par rapport aux destinations.

Si l’entrée est un service d’imagerie, elle comporte des cellules qui ont des valeurs admises (zéro est une valeur autorisée) et les cellules restantes doivent avoir la valeur NoData.

Raster Layer; Image Service; Feature Layer; String
Raster de coût en entrée

Nom du service d’imagerie de raster de coût à utiliser pour déterminer le chemin de moindre coût entre les sources et les destinations.

La valeur de chaque emplacement de cellule représente le coût par unité de distance du déplacement à travers la cellule. Chaque valeur d'emplacement de cellule est multipliée par la résolution de cellule (avec également une compensation simultanée pour mouvement diagonal) afin d'obtenir le coût total du passage à travers la cellule.

Les valeurs du raster de coût peuvent être des entiers ou valeurs à virgule flottante, mais elles ne peuvent pas être négatives ni nulles (un coût ne peut pas être négatif ou nul).

Raster Layer; Image Service; String
Entités ou raster de destination en entrée

Service d’imagerie ou d’entités identifiant les cellules sur lesquelles le chemin de moindre coût est calculé.

Raster Layer; Image Service; Feature Layer; String
Nom de polyligne en sortie

Nom du service d’entités de polyligne en sortie.

Service d’entités de polyligne pour les chemins optimaux (moindre coût) reliant les sources aux destinations.

Chaque chemin (ou ligne) est numéroté de façon unique et comporte un champ supplémentaire dans la table attributaire intitulé DestID, qui le reconnecte à l’identifiant unique sur le raster de destination.

Comme chaque chemin est représenté par une ligne unique, plusieurs lignes sont présentes aux emplacements où les chemins empruntent le même itinéraire.

String
Type de chemin
(Facultatif)

Spécifie la façon dont les valeurs et les zones des données de destination en entrée sont interprétées dans les calculs du chemin de coût.

  • Vers chaque cellulePour chaque cellule ou emplacement avec des valeurs valides sur les données de destination en entrée, le système calcule le chemin de moindre coût et l’enregistre en sortie. Avec cette option, chaque cellule ou emplacement des données de destination en entrée est traité séparément et un chemin de moindre coût est déterminé à partir de chaque cellule.
  • Vers chaque zonePour chaque zone dans les données de destination en entrée, le système calcule le chemin de moindre coût et l’enregistre en sortie. Avec cette option, pour chaque zone, le chemin de moindre coût commence à l’emplacement dont la pondération de distance de coût est la plus faible dans la zone.
  • Le moins coûteuxPour tous les emplacements des données de destination en entrée, le chemin de moindre coût découle de l’emplacement contenant le minimum des chemins de moindre coût vers les emplacements source. Il s’agit de l’option par défaut.
String
Champ de destination
(Facultatif)

Champ permettant d'obtenir des valeurs relatives aux emplacements de destination.

Les données d’entité en entrée doivent contenir au moins un champ entier autorisé.

Field

Sortie obtenue

ÉtiquetteExplicationType de données
Entités polylignes en sortie

Les entités de type polyligne en sortie.

Feature Class

arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})
NomExplicationType de données
inputSourceRasterOrFeatures

Service d’imagerie ou d’entités identifiant les cellules à partir desquelles le chemin de moindre coût est déterminé par rapport aux destinations.

Si l’entrée est un service d’imagerie, elle comporte des cellules qui ont des valeurs admises (zéro est une valeur autorisée) et les cellules restantes doivent avoir la valeur NoData.

Raster Layer; Image Service; Feature Layer; String
inputCostRaster

Nom du service d’imagerie de raster de coût à utiliser pour déterminer le chemin de moindre coût entre les sources et les destinations.

La valeur de chaque emplacement de cellule représente le coût par unité de distance du déplacement à travers la cellule. Chaque valeur d'emplacement de cellule est multipliée par la résolution de cellule (avec également une compensation simultanée pour mouvement diagonal) afin d'obtenir le coût total du passage à travers la cellule.

Les valeurs du raster de coût peuvent être des entiers ou valeurs à virgule flottante, mais elles ne peuvent pas être négatives ni nulles (un coût ne peut pas être négatif ou nul).

Raster Layer; Image Service; String
inputDestinationRasterOrFeatures

Service d’imagerie ou d’entités identifiant les cellules sur lesquelles le chemin de moindre coût est calculé.

Raster Layer; Image Service; Feature Layer; String
outputPolylineName

Nom du service d’entités de polyligne en sortie.

Service d’entités de polyligne pour les chemins optimaux (moindre coût) reliant les sources aux destinations.

Chaque chemin (ou ligne) est numéroté de façon unique et comporte un champ supplémentaire dans la table attributaire intitulé DestID, qui le reconnecte à l’identifiant unique sur le raster de destination.

Comme chaque chemin est représenté par une ligne unique, plusieurs lignes sont présentes aux emplacements où les chemins empruntent le même itinéraire.

String
pathType
(Facultatif)

Spécifie la façon dont les valeurs et les zones des données de destination en entrée sont interprétées dans les calculs du chemin de coût.

  • EACH_CELLPour chaque cellule ou emplacement avec des valeurs valides sur les données de destination en entrée, le système calcule le chemin de moindre coût et l’enregistre en sortie. Avec cette option, chaque cellule ou emplacement des données de destination en entrée est traité séparément et un chemin de moindre coût est déterminé à partir de chaque cellule.
  • EACH_ZONEPour chaque zone dans les données de destination en entrée, le système calcule le chemin de moindre coût et l’enregistre en sortie. Avec cette option, pour chaque zone, le chemin de moindre coût commence à l’emplacement dont la pondération de distance de coût est la plus faible dans la zone.
  • BEST_SINGLEPour tous les emplacements des données de destination en entrée, le chemin de moindre coût découle de l’emplacement contenant le minimum des chemins de moindre coût vers les emplacements source. Il s’agit de l’option par défaut.
String
destinationField
(Facultatif)

Champ permettant d'obtenir des valeurs relatives aux emplacements de destination.

Les données d’entité en entrée doivent contenir au moins un champ entier autorisé.

Field

Sortie obtenue

NomExplicationType de données
outputPolylineFeatures

Les entités de type polyligne en sortie.

Feature Class

Exemple de code

Exemple 1 d’utilisation de l’outil DetermineTravelCostPathAsPolyline (fenêtre Python)

Cet exemple calcule le coût de déplacement vers des destination.

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")
Exemple 2 d’utilisation de l’outil DetermineTravelCostPathAsPolyline (script autonome)

Cet exemple calcule le coût de déplacement vers des destination.

#-------------------------------------------------------------------------------
# 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)

Informations de licence

  • Basic: Nécessite ArcGIS Image Server
  • Standard: Nécessite ArcGIS Image Server
  • Advanced: Nécessite ArcGIS Image Server

Rubriques connexes