Résumé
Calcule le chemin de moindre coût sous forme d’une polyligne entre les sources et les destinations.
Illustration
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 Créer une couche de serveur d’imagerie. La couche d’entités en entrée peut être une couche du portail. Il peut également s’agir de l’URI ou de l’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.
L’outil Déterminer le chemin de coût de déplacement sous forme d’une polyligne produit une entité en sortie des chemins de moindre coût, des sources jusqu’aux destinations.
Lorsque les données de destination source ou en entrée représentent un service d’imagerie, les cellules qui ne sont ni des sources ni des destinations doivent comporter la valeur NoData. Toute cellule dans l’une de ces entrées ayant une valeur, y compris la valeur zéro, sera utilisée comme une source ou une destination valide.
La surface de coût en entrée ne peut pas avoir une valeur nulle ou négative.
Syntaxe
DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})
Paramètre | Explication | Type de données |
inputSourceRasterOrFeatures | Service d’imagerie ou d’entités identifiant les cellules à partir desquelles le chemin de moindre coût est déterminé par rapport aux destinations. 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 |
inputCostRaster | Nom du service d’imagerie de raster de coût à utiliser pour déterminer le chemin de moindre coût entre les sources et les destinations. La valeur de chaque emplacement de cellule représente le coût par unité de distance du déplacement à travers la cellule. Chaque valeur d'emplacement de cellule est multipliée par la résolution de cellule (avec également une compensation simultanée pour mouvement diagonal) afin d'obtenir le coût total du passage à travers la cellule. Les valeurs du raster de coût peuvent être des entiers ou valeurs à virgule flottante, mais elles ne peuvent pas être négatives ni nulles (un coût ne peut pas être négatif ou nul). | Raster Layer; Image Service; String |
inputDestinationRasterOrFeatures | Service d’imagerie ou d’entités identifiant les cellules sur lesquelles le chemin de moindre coût est calculé. | Raster Layer; Image Service; Feature Layer; String |
outputPolylineName | Nom du service d’entités de polyligne en sortie. Service d’entités de polyligne pour les chemins optimaux (moindre coût) reliant les sources aux destinations. Chaque chemin (ou ligne) est numéroté de façon unique et comporte un champ supplémentaire dans la table attributaire intitulé DestID, qui le reconnecte à l’identifiant unique sur le raster de destination. Comme chaque chemin est représenté par une ligne unique, plusieurs lignes sont présentes aux emplacements où les chemins empruntent le même itinéraire. | String |
pathType (Facultatif) | Spécifie 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.
| String |
destinationField (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 entier autorisé. | Field |
Sortie dérivée
Nom | Explication | Type de données |
outputPolylineFeatures | Les entités de type polyligne en sortie. | Classe d’entités |
Exemple de code
Cet exemple calcule le coût de déplacement vers des destination.
import arcpy
arcpy.DetermineTravelCostPathAsPolyline_ra(
"https://myserver/rest/services/sources/ImageServer",
"https://myserver/rest/services/costsurface/ImageServer",
"https://myserver/rest/services/destination/ImageServer",
"outpath", "BEST_SINGLE")
Cet exemple calcule le coût de déplacement vers des destination.
#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathAsPolyline_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'
inputDestinationLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/destinationras/ImageServer'
outputName = 'outTravelPaths'
pathType = 'BEST_SINGLE'
arcpy.DetermineTravelCostPathAsPolyline_ra(inputSourceLayer, inputCostLayer,
inputDestinationLayer, outputName, pathType)
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 ?