Résumé
Calcule le réseau de coût optimal à partir d’un ensemble de régions en entrée.
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 meilleur réseau pour les véhicules d’urgence.
Dans un raster, une région est un groupe de cellules de même valeur qui sont contiguës (adjacentes). Lorsque vos régions en entrée sont identifiées par un raster, si des zones (cellules de même valeur) sont constituées de plusieurs régions, prétraitez les données pour affecter des valeurs uniques à chaque région.
Les emplacements de cellule ayant la valeur NoData dans le raster de coût en entrée agissent comme des interruptions.
La valeur Input cost raster (Raster de coût en entrée) ne peut pas contenir de valeurs égales à zéro, puisque l’algorithme est un processus multiplicatif. Si le raster de coût contient des valeurs nulles et que ces valeurs représentent des superficies de plus faible coût, choisissez une petite valeur positive (par exemple, 0,01) avant d’exécuter l’outil Déterminer le réseau de coût de déplacement optimal.
Pour Ouput neighbor network (Réseau de voisins en sortie), les voisins ne sont pas identifiés par la distance euclidienne, mais par la distance de coût. Ainsi, le voisin le plus proche d’une région est le moins coûteux à atteindre, mais pas le plus proche en termes de distance.
Syntaxe
arcpy.ra.DetermineOptimumTravelCostNetwork(inputRegionsRasterOrFeatures, inputCostRaster, outputOptimumNetworkName, {outputNeighborNetworkName})| Paramètre | Explication | Type de données |
inputRegionsRasterOrFeatures | Les régions en entrée qui doivent être connectées par le réseau de connectivité de moindre coût. Les régions peuvent être définies par un service d’imagerie ou un service d’entités. Si la région en entrée est un raster, les régions sont définies par groupes de cellules contiguës (adjacentes) de même valeur. Un numéro unique doit être attribué à chaque région. Les cellules qui ne font pas partie d'une région doivent être de type NoData. Le type raster doit être un entier et les valeurs peuvent être positives ou négatives. Si la région en entrée est une entité, il peut s’agir de polygones, de lignes ou de points. Les régions d'entités surfaciques ne peuvent être constituées de polygones multi-parties. | Raster Layer; Image Service; Feature Layer; String |
inputCostRaster | Raster définissant l'impédance ou le coût de déplacement planimétrique à travers chaque cellule. 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 |
outputOptimumNetworkName | Nom du service d’entités de réseau optimal en sortie. Service d’entités polylignes en sortie du réseau de chemins optimal (moindre coût) nécessaire pour connecter chacune des régions en entrée. Chaque chemin (ou ligne) est numéroté de manière unique et les champs supplémentaires dans la table attributaire stockent des informations spécifiques concernant le chemin. Parmi ces champs, on compte les suivants :
Ces informations vous permettent de mieux comprendre les chemins du réseau. Comme chaque chemin est représenté par une ligne unique, plusieurs lignes seront présentes aux emplacements où les chemins empruntent le même itinéraire. | String |
outputNeighborNetworkName (Facultatif) | Nom du service d’entités de réseau de voisins en sortie. Service d’entités polylignes qui identifie tous les chemins depuis chaque région jusqu’à ses voisins les plus proches en termes de coût. Chaque chemin (ou ligne) est numéroté de manière unique et les champs supplémentaires dans la table attributaire stockent des informations spécifiques concernant le chemin. Parmi ces champs, on compte les suivants :
Ces informations vous permettent de mieux comprendre les chemins du réseau, et elles sont particulièrement utiles lorsque vous devez identifier les chemins à supprimer, le cas échéant. Comme chaque chemin est représenté par une ligne unique, plusieurs lignes seront présentes aux emplacements où les chemins empruntent le même itinéraire. | String |
Sortie dérivée
| Nom | Explication | Type de données |
| outputOptimumNetworkFeatures | Les entités du réseau optimal en sortie. | Couche raster |
| outputNeighborNetworkFeatures | Les entités du réseau de voisins en sortie. | Classe d’entités |
Exemple de code
Cet exemple calcule le réseau de coût de déplacement optimal.
import arcpy
arcpy.DetermineOptimumTravelCostNetwork_ra(
"https://myserver/rest/services/sources/ImageServer",
"https://myserver/rest/services/costsurface/ImageServer",
"outoptimumnetwork1")Cet exemple calcule le réseau de coût de déplacement optimal.
#-------------------------------------------------------------------------------
# Name: DetermineOptimumTravelCostNetwork_Ex_02.py
# Description: Calculates the optimum travel cost network.
# 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'
outputOptimumNetworkName = 'outNetworkRaster'
outputNeighborName = 'outNeighborRaster'
arcpy.DetermineOptimumTravelCostNetwork_ra(inputSourceLayer, zoneField, inputCostLayer,
outputOptimumNetworkName, outputNeighborName)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 ?