Résumé
Calcule des chemins spécifiques entre des sources connues et des destinations connues.
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 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.
Un exemple d’application de cet outil est la recherche du coût de déplacement pour parvenir à certaines destinations.
L’outil Déterminer les chemins de coût de déplacement vers des destinations génère un raster en sortie qui enregistre le chemin de plus faible coût ou les chemins correspondant aux emplacements sélectionnés par rapport à la cellule de la source la plus proche que vous avez définie dans la surface de coûts cumulés (nous tenons compte des distances de coût).
L’exécution de l’outil Calcul du coût de déplacement est généralement requise avant d’exécuter l’outil Déterminer les chemins de coût de déplacement vers des destinations pour créer des services d’imagerie de distance de coût en entrée et d’antécédence. Ces services d’imagerie en entrée sont obligatoire pour l’outil Déterminer les chemins de coût de déplacement vers des destinations.
Chaque chemin de plus faible coût est attribué à une valeur issue du processus d'analyse. La dernière cellule dans la source d’origine (celle qui a permis de calculer la distance de coût et l’antécédence) dans un chemin de coût est associée à la valeur un. Le premier chemin est associé à la valeur trois, le deuxième à la valeur quatre, et ainsi de suite. La valeur deux est réservée pour la portion combinée des chemins qui ont des portions d'un chemin de coût en commun.
Lorsque les données de destination en entrée correspondent à un service d’imagerie, l’ensemble des cellules de destination englobe toutes les cellules du service d’imagerie 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.
Lorsque l’entrée source est un service d’entités, par défaut, le premier champ disponible valide est utilisé. Si aucun champ n’est valide, le champ IdObjet (par exemple, OID ou FID) est utilisé.
Lorsque plusieurs chemins sont combinés et sont conformes à la distance source sur le même trajet, le segment qui comprend les deux chemins est associé à la valeur 2. Vous ne pouvez pas attribuer la partie combinée du chemin à la valeur de l'un de ces chemins, car la partie combinée dépend des deux itinéraires.
Exemple d’utilisation de l’option Chaque zone avec des chemins combinés L'outil Déterminer les chemins de coût de déplacement vers des destinations ne tient pas compte des paramètres d’environnement Taille de cellule. Il utilise la taille de cellule du 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 Déterminer les chemins de coût de déplacement vers des destinations pour modifier le chemin offrant le moins de résistance et le ramener à un modèle numérique de terrain. Dans ce cas, utilisez le MNT avec le 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. 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 0 et 360. Ces deux services d’imagerie sont admis.
Lorsque les données de destination en entrée sont une entité, vous devez pouvoir utiliser au moins un champ.
Syntaxe
arcpy.ra.DetermineTravelCostPathsToDestinations(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputName, {destinationField}, {pathType})| Paramètre | Explication | Type de données |
inputDestinationRasterOrFeatures | Service d’imagerie ou d’entités 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 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 |
inputCostDistanceRaster | Nom du service d’imagerie de distance de coût à utiliser pour déterminer le chemin de plus faible coût entre les emplacements cibles par rapport aux sources. Le raster de distance de coût est généralement créé à l’aide de l’outil Calcul du coût de déplacement. 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; Image Service; String |
inputCostBacklinkRaster | 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; Image Service; String |
outputName | Nom du service raster des chemins de coût de déplacement en sortie. Le nom par défaut repose sur le nom de l'outil et sur le nom de la couche en entrée. Si le nom de la couche existe déjà, vous êtes invité à fournir un autre nom. | String |
destinationField (Facultatif) | Champ sur la couche de destination qui contient les valeurs définissant chaque destination. Le service d’entités en entrée doit contenir au moins un champ valide. | String |
pathType (Facultatif) | Définit 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 |
Sortie dérivée
| Nom | Explication | Type de données |
| outputRaster | Raster en sortie. | Couche raster |
Exemple de code
Cet exemple calcule le coût de déplacement vers des destination.
import arcpy
arcpy.DetermineTravelCostPathstoDestinations_ra(
"https://myserver/rest/services/sources/ImageServer",
"https://myserver/rest/services/costsurface/ImageServer",
"https://myserver/rest/services/backlinkras/ImageServer",
"outpath", "destField", "EACH_ZONE")Cet exemple calcule le coût de déplacement vers des destination.
#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathstoDestinations_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'
inputBackLinkLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/backlinkras/ImageServer'
outputName = 'outTravelPathsRaster'
destField = 'dest1'
pathType = 'BEST_SINGLE'
arcpy.DetermineTravelCostPathstoDestinations_ra(inputSourceLayer, inputCostLayer,
inputBackLinkLayer, outputName,
destField, 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 ?