Déterminer les chemins de coût de déplacement vers des destinations (Analyse raster)

Synthèse

Calcule les chemins spécifiques entre les sources et les destinations connues.

Héritage :

Cet outil est obsolète et sera retiré dans une version ultérieure.

L’outil Chemin optimal comme raster fournit des fonctionnalités ou des performances améliorées.

Illustration

Illustration de l’outil Déterminer les chemins de coût de déplacement vers des destinations

Utilisation

  • Cet outil de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS EnterpriseArcGIS Image Server est configuré pour l'Analyse raster. Si cet outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur les serveurs fédérés avec ArcGIS Enterprise. L'outil de portail accepte les couches de votre portail en entrée et crée la sortie dans votre portail.

    La couche raster en entrée prend en charge une couche du portail, un URI ou une URL vers un service d'imagerie, ou la sortie de l'outil Make Image Server Layer (Créer une couche de serveur d’imagerie). La couche d'entités en entrée peut correspondre à une couche du portail, un URI ou une URL vers un service d'entités. Cet outil ne prend pas en charge les couches ou données raster locales. Vous pouvez utiliser des couches et données d'entités locales en entrée dans cet outil de portail, mais il est recommandé d’utiliser les couches de votre portail en entrée.

  • Un exemple d’application de cet outil est la recherche du coût de déplacement pour parvenir à certaines destinations.

  • L’outil Déterminer les chemins de coût de déplacement vers des destinations génère un raster en sortie qui enregistre le chemin de plus faible coût ou les chemins correspondant aux emplacements sélectionnés par rapport à la cellule de la source la plus proche que vous avez définie dans la surface de coûts cumulés (nous tenons compte des distances de coût).

  • L’exécution de l’outil Calcul du coût de déplacement est généralement requise avant d’exécuter l’outil Déterminer les chemins de coût de déplacement vers des destinations pour créer des services d’imagerie de distance de coût en entrée et d’antécédence. Ces services d’imagerie en entrée sont obligatoire pour l’outil Déterminer les chemins de coût de déplacement vers des destinations.

  • Chaque chemin de plus faible coût est attribué à une valeur issue du processus d'analyse. La dernière cellule dans la source d’origine (celle qui a permis de calculer la distance de coût et l’antécédence) dans un chemin de coût est associée à la valeur un. Le premier chemin est associé à la valeur trois, le deuxième à la valeur quatre, et ainsi de suite. La valeur deux est réservée pour la portion combinée des chemins qui ont des portions d'un chemin de coût en commun.

  • Lorsque les données de destination en entrée correspondent à un service d’imagerie, l’ensemble des cellules de destination englobe toutes les cellules du service d’imagerie en entrée ou les entités de destination comprenant des valeurs autorisées. Les cellules associées à la valeur NoData ne figurent pas dans la source. La valeur zéro est une destination pertinente.

  • Lorsque l’entrée source est un service d’entités, par défaut, le premier champ disponible valide est utilisé. Si aucun champ n’est valide, le champ ObjectID (par exemple, OID ou FID) est utilisé.

  • Lorsque plusieurs chemins sont combinés et sont conformes à la distance source sur le même trajet, le segment qui comprend les deux chemins est associé à la valeur 2. Vous ne pouvez pas attribuer la partie combinée du chemin à la valeur de l'un de ces chemins, car la partie combinée dépend des deux itinéraires.

    Exemple d’utilisation de l’option Chaque zone avec des chemins combinés
    Exemple d’utilisation de l’option Chaque zone avec des chemins combinés
  • L'outil Déterminer les chemins de coût de déplacement vers des destinations ne tient pas compte des paramètres d’environnement Taille de cellule. Il utilise la taille de cellule du raster d’antécédence de coût en entrée dans le raster en sortie. Vous risquez de modifier considérablement la configuration du raster d'antécédence en sortie si vous modifiez la résolution. Pour éviter toute confusion, la taille de cellule ne doit pas être définie lors de l'utilisation de cet outil.

  • Vous pouvez également utiliser l’outil Déterminer les chemins de coût de déplacement vers des destinations pour modifier le chemin offrant le moins de résistance et le ramener à un modèle numérique de terrain. Dans ce cas, utilisez le MNT avec le raster de distance de coût en entrée et les résultats obtenus via l’outil Direction de flux pour traiter le raster d’antécédence de coût en entrée. Les valeurs d’un raster de direction de flux autorisées sont les suivantes : 1, 2, 4, 8, 16, 32, 64 et 128. Les valeurs autorisées pour les rasters d’antécédence sont 0 et 360. Ces deux services d’imagerie sont admis.

  • Lorsque les données de destination en entrée sont une entité, vous devez pouvoir utiliser au moins un champ.

Paramètres

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

Service d’imagerie ou d’entités identifiant les cellules à partir desquelles le chemin de plus faible coût est déterminé par rapport à la source de plus faible coût.

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 distance de coût en entrée

Nom du service d’imagerie de distance de coût à utiliser pour déterminer le chemin de plus faible coût entre les emplacements cibles par rapport aux sources.

Le raster de distance de coût est généralement créé à l’aide de l’outil Calcul du coût de déplacement. Pour chaque cellule, le raster de distance de coût cumulée minimale sur une surface de coût entre chaque cellule et un ensemble de cellules source.

Raster Layer; Image Service; String
Raster d'antécédence de coût en entrée

Nom du raster d'antécédence de coût utilisé pour déterminer le chemin afin de revenir vers une source via le chemin de plus faible coût.

Pour chaque cellule contenue dans le raster d'antécédence, une valeur identifie la voisine, à savoir la cellule sur le chemin de plus faible coût cumulé à partir de la cellule vers une seule cellule ou un jeu de cellules sources.

Raster Layer; Image Service; String
Nom en sortie

Nom du service raster des chemins de coût de déplacement en sortie.

Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.

String
Champ de destination
(Facultatif)

Champ sur la couche de destination qui contient les valeurs définissant chaque destination.

Le service d’entités en entrée doit contenir au moins un champ valide.

String
Type de chemin
(Facultatif)

Définit 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 celluleSi une cellule contient des entrées autorisées avec des données de destination, le système calcule le chemin du plus faible coût et l'enregistre dans le raster en sortie. Avec cette option, chaque cellule de l'entrée est traitée séparément et un chemin de plus faible coût est déterminé pour chaque cellule de départ. Il s’agit de l’option par défaut.
  • Vers chaque zoneSi une zone contient des entrées autorisées avec des données de destination, le système calcule le chemin du plus faible coût et l'enregistre dans le raster en sortie. Avec cette option, pour chaque zone, le chemin de plus faible coût commence à la cellule avec la pondération de distance de plus faible coût dans la zone.
  • Le moins coûteuxPour toutes les cellules de l'entrée de destination, le chemin de plus faible coût est dérivé de la cellule contenant le chemin de plus faible coût minimal des chemins de coût vers les cellules source.
String

Sortie obtenue

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie.

Raster Layer

arcpy.ra.DetermineTravelCostPathsToDestinations(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputName, {destinationField}, {pathType})
NomExplicationType de données
inputDestinationRasterOrFeatures

Service d’imagerie ou d’entités identifiant les cellules à partir desquelles le chemin de plus faible coût est déterminé par rapport à la source de plus faible coût.

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
inputCostDistanceRaster

Nom du service d’imagerie de distance de coût à utiliser pour déterminer le chemin de plus faible coût entre les emplacements cibles par rapport aux sources.

Le raster de distance de coût est généralement créé à l’aide de l’outil Calcul du coût de déplacement. Pour chaque cellule, le raster de distance de coût cumulée minimale sur une surface de coût entre chaque cellule et un ensemble de cellules source.

Raster Layer; Image Service; String
inputCostBacklinkRaster

Nom du raster d'antécédence de coût utilisé pour déterminer le chemin afin de revenir vers une source via le chemin de plus faible coût.

Pour chaque cellule contenue dans le raster d'antécédence, une valeur identifie la voisine, à savoir la cellule sur le chemin de plus faible coût cumulé à partir de la cellule vers une seule cellule ou un jeu de cellules sources.

Raster Layer; Image Service; String
outputName

Nom du service raster des chemins de coût de déplacement en sortie.

Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom.

String
destinationField
(Facultatif)

Champ sur la couche de destination qui contient les valeurs définissant chaque destination.

Le service d’entités en entrée doit contenir au moins un champ valide.

String
pathType
(Facultatif)

Définit 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_CELLSi une cellule contient des entrées autorisées avec des données de destination, le système calcule le chemin du plus faible coût et l'enregistre dans le raster en sortie. Avec cette option, chaque cellule de l'entrée est traitée séparément et un chemin de plus faible coût est déterminé pour chaque cellule de départ. Il s’agit de l’option par défaut.
  • EACH_ZONESi une zone contient des entrées autorisées avec des données de destination, le système calcule le chemin du plus faible coût et l'enregistre dans le raster en sortie. Avec cette option, pour chaque zone, le chemin de plus faible coût commence à la cellule avec la pondération de distance de plus faible coût dans la zone.
  • BEST_SINGLEPour toutes les cellules de l'entrée de destination, le chemin de plus faible coût est dérivé de la cellule contenant le chemin de plus faible coût minimal des chemins de coût vers les cellules source.
String

Sortie obtenue

NomExplicationType de données
outputRaster

Raster en sortie.

Raster Layer

Exemple de code

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

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

import arcpy

arcpy.ra.DetermineTravelCostPathstoDestinations(
    "https://myserver/rest/services/sources/ImageServer", 
    "https://myserver/rest/services/costsurface/ImageServer", 
    "https://myserver/rest/services/backlinkras/ImageServer", 
    "outpath", "destField", "EACH_ZONE")
Exemple 2 d’utilisation de l’outil DetermineTravelCostPathsToDestinations (script autonome)

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

#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathstoDestinations_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'
inputBackLinkLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/backlinkras/ImageServer'
outputName = 'outTravelPathsRaster'
destField = 'dest1'
pathType = 'BEST_SINGLE'

arcpy.ra.DetermineTravelCostPathstoDestinations(inputSourceLayer, inputCostLayer,
                                                inputBackLinkLayer, outputName, 
                                                destField, pathType)

Informations de licence

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

Rubriques connexes