Chemin optimal comme ligne (Outils Spatial Analyst)

Résumé

Calcule le chemin optimal depuis une source vers une destination en tant que ligne.

En savoir plus sur la connexion de localisations à des chemins optimaux

Utilisation

L’outil Optimal Path As Line (Chemin optimal comme ligne) produit une entité polyligne en sortie qui constitue le chemin optimal de la source à la destination.
Lorsque les données de destination en entrée correspondent à un raster, l’ensemble des cellules de destination englobe toutes les cellules de la valeur du paramètre Input Raster or Feature Destination (Données raster ou d’entités de destination en entrée) comportant des valeurs valides. Les cellules associées à la valeur NoData ne figurent pas dans la source. Zéro est une valeur autorisée. Un raster de destination peut être créé à l’aide des outils d’extraction.
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, notamment si elle est grossière par rapport au détail dans l’entrée. Un processus de rastérisation interne utilisant l’outil Polygon to Raster (Polygone vers raster) est appliqué avec Cell assignment type (Type d’attribution de cellule) défini par défaut sur Cell center (Centre de cellule). 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, et ne seront donc pas représentées dans les calculs de distance. Si, par exemple, les 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 rastérisation des entités en entrée directement avec l’outil Feature to Raster (Entités vers rasters) et définir le paramètre Field (Champ). 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.
Avant la génération d’un chemin optimal, l’un des outils suivants est généralement utilisé pour créer un raster d’accumulation de distance et un raster de direction arrière : Distance Accumulation (Accumulation de distance) ou Distance Allocation (Allocation de distance). Un raster d’accumulation de distance et un raster de direction arrière sont des entrées requises pour générer un chemin optimal.
Le chemin optimal créé peut être un chemin de flux basé sur la direction de flux D8. Pour générer un chemin optimal de cette manière, utilisez un raster de direction de flux D8 en entrée pour le paramètre Input Back Direction or Flow Direction Raster (Raster de direction arrière ou de direction de flux en entrée). Vous devez également renseigner le champ Input Distance Accumulation Raster (Raster d’accumulation de distance en entrée). Si le paramètre Create Network Paths (Créer des chemins de réseau) n’est pas activé, le champ Input Distance Accumulation Raster (Raster d’accumulation de distance en entrée) n’est pas utilisé pour déterminer le chemin. Ainsi, votre chemin sera le même que vous utilisiez un raster constant ou un modèle numérique d’élévation (MNE). Seule une valeur attributaire sur votre chemin sera différente. Toutefois, si le paramètre Create Network Paths (Créer des chemins de réseau) est activé, le paramètre indiqué pour Input Distance Accumulation Raster (Raster d’accumulation de distance en entrée) doit être de type Output flow accumulation (Accumulation de flux en sortie). Reportez-vous à la documentation de l’outil Flow Direction (Direction de flux) pour plus d’informations sur les rasters de direction de flux D8 et à la documentation de l’outil Flow Accumulation (Accumulation de flux) pour créer le raster d’accumulation.
L’entité polyligne en sortie comprend un champ DestID et un champ PathCost. Le champ DestID identifie la destination vers laquelle chaque ligne conduit. Le champ PathCost indique le coût cumulé total de chaque chemin. Si la sortie est écrite dans une géodatabase fichier, il existe un champ shape_length contenant la longueur totale du chemin de moindre coût.
Pour pouvoir créer des chemins qui traversent le tronçon de la projection, les rasters utilisés comme entrées des paramètres Input Distance Accumulation Raster (Raster d’accumulation de distance en entrée) et Input Back Direction Raster (Raster de direction arrière en entrée) doivent avoir été créés à l’étendue globale complète, dans une projection cylindrique ou un système de coordonnées géographiques en sortie et l’option Geodesic (Géodésique) doit être utilisée pour le paramètre Distance Method (Méthode de distance).
Pour générer des chemins optimaux corrects, les paramètres d’environnement Taille de cellule, Raster de capture et Étendue sont ignorés. La taille de cellule, l’origine et l’étendue des rasters de direction arrière ou de sens de circulation en entrée sont utilisées lors du traitement.
Lorsque le paramètre d’environnement Système de coordonnées en sortie est spécifié, il est appliqué au cours du post-traitement afin que les résultats ne soient pas dégradés.
Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Etiqueter	Explication	Type de données
Raster ou entités de destination en entrée	Raster d’entiers ou entité (ponctuelle, linéaire ou surfacique) identifiant les emplacements à partir desquels le chemin optimal est déterminé par rapport à la source de plus faible coût. Si l’entrée est un raster, il doit comporter des cellules qui ont des valeurs admises pour les destinations et les cellules restantes doivent avoir la valeur NoData. Zéro est une valeur autorisée.	Raster Layer; Feature Layer
Raster d’accumulation de distance en entrée	Le raster d’accumulation de distance est utilisé pour déterminer le chemin optimal entre les sources et les destinations. Le raster d’accumulation de distance est généralement créé avec l’outil Distance Accumulation (Accumulation de distance) ou Distance Allocation (Allocation de distance). Chaque cellule du raster d’accumulation de distance représente la distance de coût cumulée minimum sur une surface allant de chaque cellule à un ensemble de cellules source.	Raster Layer
Raster de direction arrière ou de direction de flux en entrée	Le raster de direction arrière contient des directions calculées en degrés. La direction identifie la cellule suivante sur le chemin optimal de retour vers la source de plus faible coût cumulé, en évitant les interruptions. La plage de valeurs s’étend de 0 à 360 degrés, 0 étant réservé pour aux cellules source. La direction plein est correspond à 90 et les valeurs augmentent dans le sens horaire (180 correspond au sud, 270 à l’ouest et 360 au nord).	Raster Layer
Chemin optimal en sortie comme ligne	Classe d’entités en sortie constituant le ou les chemins optimaux.	Feature Class
Champ de destination (Facultatif)	Champ entier permettant d’obtenir des valeurs relatives aux emplacements de destination.	Field
Type de chemin (Facultatif)	Spécifie un 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. Chaque zone—Pour chaque zone des données de destination en entrée, un chemin de moindre coût est déterminé et enregistré 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ûteux—Pour toutes les cellules des données de destination en entrée, le chemin de plus faible coût est dérivé de la cellule dont le chemin de plus faible coût vers les cellules source est le plus faible. Chaque cellule—Pour chaque cellule contenant des valeurs valides dans les données de destination en entrée, un chemin de moindre coût est déterminé et enregistré dans le raster en sortie. Avec cette option, chaque cellule de l’entrée est traitée séparément et un chemin de moindre coût est déterminé pour chaque cellule.	String
Créer des chemins de réseau (Facultatif)	Spécifie si des chemins complets, qui peuvent se superposer, depuis les destinations vers les sources, sont calculés, ou si des chemins de réseau sans superposition sont créés. Activé—Des chemins de réseau sans superposition sont calculés. Décoché—Des chemins complets depuis les destinations vers les sources sont calculés et peuvent se superposer. Il s’agit de l’option par défaut.	Boolean

OptimalPathAsLine(in_destination_data, in_distance_accumulation_raster, in_back_direction_raster, out_polyline_features, {destination_field}, {path_type}, {create_network_paths})

Nom	Explication	Type de données
in_destination_data	Raster d’entiers ou entité (ponctuelle, linéaire ou surfacique) identifiant les emplacements à partir desquels le chemin optimal est déterminé par rapport à la source de plus faible coût. Si l’entrée est un raster, il doit comporter des cellules qui ont des valeurs admises pour les destinations et les cellules restantes doivent avoir la valeur NoData. Zéro est une valeur autorisée.	Raster Layer; Feature Layer
in_distance_accumulation_raster	Le raster d’accumulation de distance est utilisé pour déterminer le chemin optimal entre les sources et les destinations. Le raster d’accumulation de distance est généralement créé avec l’outil Distance Accumulation (Accumulation de distance) ou Distance Allocation (Allocation de distance). Chaque cellule du raster d’accumulation de distance représente la distance de coût cumulée minimum sur une surface allant de chaque cellule à un ensemble de cellules source.	Raster Layer
in_back_direction_raster	Le raster de direction arrière contient des directions calculées en degrés. La direction identifie la cellule suivante sur le chemin optimal de retour vers la source de plus faible coût cumulé, en évitant les interruptions. La plage de valeurs s’étend de 0 à 360 degrés, 0 étant réservé pour aux cellules source. La direction plein est correspond à 90 et les valeurs augmentent dans le sens horaire (180 correspond au sud, 270 à l’ouest et 360 au nord).	Raster Layer
out_polyline_features	Classe d’entités en sortie constituant le ou les chemins optimaux.	Feature Class
destination_field (Facultatif)	Champ entier permettant d’obtenir des valeurs relatives aux emplacements de destination.	Field
path_type (Facultatif)	Spécifie un 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. `EACH_ZONE`—Pour chaque zone des données de destination en entrée, un chemin de moindre coût est déterminé et enregistré 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_SINGLE`—Pour toutes les cellules des données de destination en entrée, le chemin de plus faible coût est dérivé de la cellule dont le chemin de plus faible coût vers les cellules source est le plus faible. `EACH_CELL`—Pour chaque cellule contenant des valeurs valides dans les données de destination en entrée, un chemin de moindre coût est déterminé et enregistré dans le raster en sortie. Avec cette option, chaque cellule de l’entrée est traitée séparément et un chemin de moindre coût est déterminé pour chaque cellule.	String
create_network_paths (Facultatif)	Spécifie si des chemins complets, qui peuvent se superposer, depuis les destinations vers les sources, sont calculés, ou si des chemins de réseau sans superposition sont créés. `NETWORK_PATHS`—Des chemins de réseau sans superposition sont calculés. `DESTINATIONS_TO_SOURCES`—Des chemins complets depuis les destinations vers les sources sont calculés et peuvent se superposer. Il s’agit de l’option par défaut.	Boolean

Exemple de code

OptimalPathAsLine Exemple 1 (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l'utilisation de cette fonction.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
OptimalPathAsLine("observers.shp", "distaccum.tif", "backdir.tif",
                  "c:/sapyexamples/output/outOptimalPath01.shp")

OptimalPathAsLine Exemple 2 (script autonome)

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

# Name: OptimalPathAsLine_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"
inDistAccum = "accumraster.tif"
inBackDir = "backdir2.tif"
outPathFeat = "c:/sapyexamples/output.gdb/optimalfeaturepaths02"
destField = "FID"
method = "EACH_CELL"

# Run
OptimalPathAsLine(inDestination, inDistAccum, inBackDir,
                  outPathFeat, destField, method)

Environnements

Validation automatique, Espace de travail courant, Valeur Z en sortie par défaut, Transformations géographiques, Résolution M, Tolérance M, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Valeurs M en sortie, Valeurs Z en sortie, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Espace de travail temporaire, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z

Informations de licence