Chemin optimal comme raster (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Calcule le chemin optimal entre une source et une destination en tant que raster.

En savoir plus sur la connexion des emplacements avec des chemins optimaux

Utilisation

• L’outil Chemin optimal comme raster génère un raster en sortie.

• 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 data (Données raster ou vecteur de destination en entrée) 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 créer un raster de destination à 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 Polygone vers raster est appliqué, avec un paramètre par défaut pour Cell assignment type (Type d’attribution de cellule) défini 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 Entité vers raster 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 : Accumulation de distance ou Allocation de distance. Il s’agit d’entrées obligatoires 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 sens de circulation D8 en entrée pour le paramètre Input back direction or flow direction raster (Raster de direction d’antécédence ou de sens de circulation en entrée). Vous devez également fournir une valeur Input distance accumulation raster (Raster d’accumulation de distance en entrée) ; la valeur Input distance accumulation raster (Raster d’accumulation de distance en entrée) n’est pas utilisée pour déterminer le chemin. Le chemin sera le même que vous utilisiez un raster constant ou un modèle numérique de terrain (MNT) ; seule une valeur attributaire sur le chemin sera différente. Reportez-vous à la documentation de l’outil Sens de circulation pour plus d’informations sur les rasters de sens de circulation D8.

• Les valeurs du chemin optimal en sortie représentent le nombre de chemins à un emplacement donné. Dans de nombreux cas, les chemins suivent le même itinéraire, quittant une source et divergeant pour se rendre à des destinations différentes. Par exemple, la valeur un indique qu’il n’existe qu’un seul chemin optimal à un emplacement donné, tandis que la valeur cinq indique qu’à cet emplacement, il existe cinq chemins optimaux traversant cette cellule dans la zone d’étude.

• Pour générer un chemin optimal, le paramètre d’environnement Cell size (Taille de cellule) est ignoré et la taille de cellule de la valeur Input cost backlink raster (Raster d’antécédence de coût en entrée) est utilisée pour calculer le raster en sortie. Vous risquez de modifier la configuration du raster d’antécédence 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.

• Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.

• 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.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Données raster ou vecteur 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 Accumulation de distance ou 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 d’antécédence ou de sens de circulation 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 (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).	Raster Layer
Champ de destination (Facultatif)	Champ 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

Valeur renvoyée

Étiquette	Explication	Type de données
Chemin d’accumulation optimal en sortie	Raster en sortie.	Raster

Python

OptimalPathAsRaster(in_destination_data, in_distance_accumulation_raster, in_back_direction_raster, {destination_field}, {path_type})

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 Accumulation de distance ou 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 (droite) est de 90 et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord).	Raster Layer
destination_field (Facultatif)	Champ 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

Valeur renvoyée

Nom	Explication	Type de données
out_path_accumulation_raster	Raster en sortie.	Raster

Exemple de code

Exemple 1 d’utilisation de la fonction OptimalPathAsRaster (fenêtre Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outOptimalRasPath = OptimalPathAsRaster("observers", "distAccum.tif", "backDir2", "IdField", "EACH_CELL")
outOptimalRasPath.save("c:/sapyexamples/output/bestpaths.tif")

Exemple 2 d’utilisation de la fonction OptimalPathAsRaster (script autonome)

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

# Name: OptimalPathAsRaster_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"
distAccumRaster = "distAccum.tif"
backDir = "backDir2.tif"
destField = "FID"
pathType = "EACH_CELL"

# Execute CostPath
outOptimalRasPath = OptimalPathAsRaster(inDestination, distAccumRaster, backDir, destField,
                       pathType)

# Save the output 
outOptimalRasPath.save("c:/sapyexamples/output/optimalraspath02.tif")

Environnements

Validation automatique, Compression, Espace de travail courant, Mot-clé CONFIG en sortie, Pyramide, Espace de travail temporaire, Taille de tuile

Informations de licence

• Basic: Nécessite Spatial Analyst
• Standard: Nécessite Spatial Analyst
• Advanced: Nécessite Spatial Analyst