ArcMap

Chemin de coût en polyligne

Disponible avec une licence Spatial Analyst.

Résumé

Calcule le chemin de moindre coût entre une source et une destination comme entité linéaire.

Pour en savoir plus sur la création d'un chemin de moindre coût

Utilisation

  • L’outil Chemin de coût en polyligne permet d’obtenir une entité polyligne en sortie qui enregistre le ou les chemins de plus faible coût depuis des sources jusqu’à la destination la plus proche définie dans la surface de coûts cumulés (en termes de distance de coût).

  • Il existe un ou plusieurs outils de calcul de coûts pondérés (notamment Distance de coût, Antécédence de coût ou Allocation de coût) que vous devez généralement exécuter avant d’utiliser l’outil Chemin de coût en polyligne pour créer la distance de coût en entrée et des rasters d’antécédence. Ces rasters en entrée sont obligatoires si vous souhaitez utiliser l’outil Chemin de coût en polyligne.

  • Lorsque les données de destination en entrée correspondent à un raster, l'ensemble des cellules de destination englobe toutes les cellules du raster 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. Vous pouvez facilement créer un raster de destination à l'aide des outils d'extraction.

  • Lorsque l’entrée source est une entité, par défaut, le premier champ disponible valide est utilisé. Si aucun champ valide n’existe, le champ IdObjet (par exemple, OID ou FID, selon le type de l’entité entrée) est utilisé.

  • Lorsque vous utilisez des données d’entité surfacique pour les destinations d’entité en entrée, vous devez traiter la taille de cellule en sortie avec prudence si elle est grossière par rapport au détail dans l’entrée. Dans le processus de tramage interne utilisé par l’outil Polygone vers raster, le paramètre par défaut de la méthode Cell assignment type (Type d’attribution de cellule) est CELL_CENTER. Cela signifie que les données ne figurant pas au centre de la cellule ne seront pas incluses dans la sortie de destination rasterisée intermédiaire ; elles ne seront donc pas représentées dans les calculs de distance. Par exemple, si vos destinations sont représentées par une série de petits polygones, tels que des emprises de bâtiments, dont la taille est petite par rapport à la taille de cellule en sortie, il se peut que quelques-uns d'entre eux seulement apparaissent aux centres des cellules raster en sortie et que, vraisemblablement, la plupart des autres polygones soient perdus et exclus de l'analyse.

    Pour éviter cette situation, vous pouvez entre-temps effectuer la rasterisation des entités en entrée directement avec l’outil Polygone vers raster et définir un Priority field (Champ Priorité). Ensuite, utilisez la sortie en entrée dans l'outil de distance que vous souhaitez utiliser. Vous pouvez également sélectionner une petite taille de cellule pour capturer le nombre de détails approprié à partir des entités en entrée.

  • L’entité polyligne en sortie comporte un champ appelé DestID qui identifie la destination de chaque ligne. Si la sortie est écrite dans un géodatabase fichier, un champ shape_length existe ; ce champ contient la longueur totale du chemin de moindre coût.

  • L’outil Chemin de coût en polyligne ne tient pas compte du paramètre d’environnement Taille de cellule. Il utilise la taille de cellule de Input cost backlink raster (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 Chemin de coût en polyligne pour obtenir le chemin offrant le moins de résistance à partir d’un modèle numérique de terrain (MNT). Dans ce cas, utilisez le MNT pour Input cost distance raster (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 (option Input cost backlink raster). 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 les suivantes : 1, 2, 3, 4, 5, 6, 7 et 8. Ces deux rasters sont admis.

  • Pour plus d'informations sur les environnements de géotraitement qui s'appliquent à cet outil, reportez-vous à la rubrique Environnements d'analyse et Spatial Analyst.

Syntaxe

CostPathAsPolyline (in_destination_data, in_cost_distance_raster, in_cost_backlink_raster, out_polyline_features, {path_type}, {destination_field})
ParamètreExplicationType de données
in_destination_data

Jeu de données d'entité ou raster 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 raster, 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; Feature Layer
in_cost_distance_raster

Le raster de distance de coût à utiliser pour déterminer le chemin de moindre coût reliant les sources aux destinations.

En général, vous pouvez créer un raster de distance de coût grâce aux outils Distance de coût, Allocation de coût ou Antécédence de coût. 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
in_cost_backlink_raster

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
out_polyline_features

Classe d’entités en sortie contenant le chemin de moindre coût.

Feature Class
path_type
(Facultatif)

Mot-clé définissant la façon dont les valeurs et les zones de l'entrée de destination sont interprétées dans les calculs du chemin de coût.

  • BEST_SINGLE — Pour 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.
  • EACH_ZONE — Si 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.
  • EACH_CELL — Si 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.
String
destination_field
(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 autorisé.

Field

Exemple de code

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

Le script de la fenêtre Python ci-dessous illustre l’utilisation de l’outil.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
CostPathAsPolyline("observers", "costraster", "backlink2", "c:/sapyexamples/output/outcostpth01.shp")
Exemple 2 d’utilisation de l’outil CostPathAsPolyline (script autonome)

Calcule le chemin de moindre coût entre une source et une destination.

# Name: CostPathAsPolyline_Ex_02.py
# Description: Calculates the least-cost path from a source to 
#              a destination.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inDestination = "observers.shp"
inCostRaster = "costraster"
inBacklink = "backlink2"
outCostPathFeat = "c:/sapyexamples/output.gdb/outcostpathfeat02"
method = "EACH_CELL"
destField = "FID"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute
CostPathAsPolyline(inDestination, inCostRaster, inBacklink, 
                   outCostPathFeat, method, destField)

Environnements

Informations de licence

  • ArcGIS Desktop Basic: Requiert Spatial Analyst
  • ArcGIS Desktop Standard: Requiert Spatial Analyst
  • ArcGIS Desktop Advanced: Requiert Spatial Analyst

Rubriques connexes