Résumé
Calcule le chemin optimal entre une source et une destination en tant que raster.
Utilisation
Cet outil du portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise
comportant un ArcGIS Image Server configuré pour Raster Analysis . 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 Make Image Server Layer (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.
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 (Input raster or feature destination data) 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é pour les destinations en entrée, vous devez gérer la taille de cellule en sortie avec prudence, notamment si elle est grossière par rapport aux détails dans l’entrée. Un processus de tramage interne utilisant l’outil Feature to Raster (Entité vers raster) est appliqué. 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. Si, par exemple, 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 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 de générer 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). 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 direction de flux D8 en entrée pour le raster de direction arrière ou de direction de flux en entrée (Input back direction or flow direction raster). Vous devez également fournir un Input distance accumulation raster (Raster d’accumulation de distance en entrée) ; le Input distance accumulation raster (Raster d’accumulation de distance en entrée) n’est pas utilisé pour déterminer le chemin. Votre 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 votre chemin sera différente. Reportez-vous à l’outil Direction de flux pour de plus amples informations sur les rasters de direction de flux 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 puis divergeant vers 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 du Input cost back direction raster (Raster de direction d’antécédence de coût en entrée) est utilisée pour calculer le raster en sortie. Vous risquez de modifier considérablement la configuration du raster de direction 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.
Contrairement à la plupart des autres outils d’analyse raster, l’outil Optimal Path As Line (Chemin optimal comme ligne) ignore les paramètres d’environnement suivants : Output Coordinate System (Système de coordonnées en sortie), Extent (Étendue), Cell Size (Taille de cellule) et Snap Raster (Raster de capture). Vous risquez de modifier considérablement la configuration du raster d’antécédence s’il a été rééchantillonné ou reprojeté, entraînant un chemin incorrect.
Syntaxe
arcpy.ra.OptimalPathAsRaster(inputDestinationRasterOrFeatures, inputDistanceAccumulationRaster, inputBackDirectionRaster, outputRasterName, {destinationField}, {pathType})| Paramètre | Explication | Type de données |
inputDestinationRasterOrFeatures | Jeu de classes d’entités ou raster identifiant les emplacements à partir desquels le chemin de plus faible coût cumulé est déterminé par rapport à la source de plus faible coût. Pour un raster, l’entrée doit être de type entier et être constituée de cellules qui possèdent des valeurs admises (zéro est une valeur valide). Les cellules restantes doivent avoir la valeur NoData. | Raster Layer; Feature Layer |
inputDistanceAccumulationRaster | 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 les outils 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 |
inputBackDirectionRaster | 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 est comprise entre 0 et 360 degrés. La valeur 0 est réservée aux cellules source. La direction plein Est (droite) est de 90 degrés et les valeurs augmentent dans le sens horaire (180, Sud ; 270, Ouest et 360, Nord). | Raster Layer |
outputRasterName | Nom du service raster en sortie qui contient les chemins optimaux. | String |
destinationField (Facultatif) | Champ permettant d'obtenir des valeurs relatives aux emplacements de destination. | Field |
pathType (Facultatif) | Spécifie un mot-clé définissant la manière 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.
| String |
Sortie dérivée
| Nom | Explication | Type de données |
| outputRaster | Raster en sortie. | Raster |
Exemple de code
Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil OptimalPathAsRaster.
import arcpy
arcpy.OptimalPathAsRaster_ra(
"https://myserver/rest/services/destination/ImageServer",
"https://myserver/rest/services/accumulationraster/ImageServer",
"https://myserver/rest/services/backdirection/ImageServer",
"outpath")Calculez le chemin optimal entre les destinations et les sources.
#-------------------------------------------------------------------------------
# Name: OptimalPathAsRaster_Ex_02.py
# Description: Calculates the optimal path from a source to a destination.
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inputDestinationLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/destination/ImageServer'
inputAccumulationLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/costaccumulation/ImageServer'
inputDirectionLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/backdirection/ImageServer'
outOptimalPathName = 'OptimalPath'
arcpy.OptimalPathAsRaster_ra(inputDestinationLayer, inputAccumulationLayer,
inputDirectionLayer, outOptimalPathName)Environnements
Informations de licence
- Basic: Requiert ArcGIS Image Server
- Standard: Requiert ArcGIS Image Server
- Advanced: Requiert ArcGIS Image Server
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?