Résumé
Calcule la connexion optimale des chemins entre deux régions en entrée ou plus.
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.
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, exécutez au préalable l'outil Spatial Analyst Region Group (Groupes par régions) pour procéder à un prétraitement et affecter des valeurs uniques à chaque région. Utilisez le raster obtenu comme régions en entrée dans l’outil Optimal Region Connections (Connexions optimales des régions).
Si les régions en entrée sont des rasters et que la plage des identifiants de ligne est très étendue (même avec seulement quelques régions), les performances de cet outil peuvent être détériorées.
Si l’entrée de la région correspond à un service d’entités, les régions sont converties en interne en raster avant l’analyse.
La résolution du raster peut être contrôlée à l'aide du paramètre d'environnement Taille de cellule. Par défaut, si aucun autre raster n’est spécifié dans l’outil, la résolution est déterminée par la valeur la plus petite entre la largeur et la hauteur de l’étendue de l’entité en entrée, dans la référence spatiale en entrée, divisée par 250.
Lorsque la région en entrée est une entité, le champ ObjectID est utilisé comme identifiant de la région.
Les emplacements identifiés par le paramètre Input Barrier Raster or Features (Entités ou raster d’interruption en entrée) ou les emplacements de cellule ayant la valeur NoData dans le paramètre Input Cost Raster (Raster de coût en entrée) agissent comme des interruptions.
L’étendue de traitement par défaut est la même que celle du paramètre Input Cost Raster (Raster de coût en entrée) s’il en existe un ; dans le cas contraire, elle est définie sur l’étendue des régions en entrée.
Le paramètre Input cost raster (Raster de coût en entrée) ne peut pas contenir de valeurs nulles, puisque l’algorithme est un processus multiplicatif. Si votre raster de coût contient des valeurs nulles et que ces valeurs représentent des surfaces de plus faible coût, remplacez-les par une petite valeur positive (comme 0,01) avant d'exécuter cet outil.
Pour le paramètre Output Neighboring Connections Name (Nom des connexions voisines en sortie), si aucune surface de coût n’est spécifiée, les voisins sont identifiés par une distance euclidienne et le voisin le plus proche d’une région est celui le plus proche en termes de distance. Toutefois, si une surface de coût est fournie, les voisins sont identifiés par la distance de coût et le voisin le plus proche d’une région est celui le moins onéreux à atteindre. Une opération d'allocation de coût permet d'identifier les régions voisines les unes des autres.
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.
Syntaxe
arcpy.ra.OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})| Paramètre | Explication | Type de données |
inputRegionRasterOrFeatures | Régions en entrée qui doivent être connectées par le réseau optimal. Les régions peuvent être définies par un raster ou des données d'entité. 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 correspond à des données d’entités, 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 |
outputOptimalLinesName | Nom du service d’entités linéaires en sortie qui connecte chaque région 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. Ces champs supplémentaires sont les suivants :
Ces informations 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 |
inputBarrierRasterOrFeatures (Facultatif) | Jeu de données qui définit les interruptions. Les interruptions peuvent être définies par un service d’imagerie d’entiers ou à virgule flottante ou encore par un service d’entités. Pour une interruption de service d’imagerie, l’interruption doit posséder une valeur valide, y compris zéro, et les surfaces ne constituant pas des interruptions doivent être de type NoData. | Raster Layer; Image Service; Feature Layer; String |
inputCostRaster | Service d'imagerie 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 |
outputNeighborConnectionsName (Facultatif) | Classe d’entités polyligne en sortie qui identifie tous les chemins entre chaque région et chacun de ses voisins les plus proches en termes de distance ou 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. Ces champs supplémentaires sont les suivants :
Ces informations permettent de mieux comprendre les chemins du réseau et sont 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 |
distanceMethod (Facultatif) | Spécifie le calcul de la distance selon une méthode plane (terre plate) ou géodésique (ellipsoïde).
| String |
connectionsWithinRegions (Facultatif) | Indique si les chemins continuent et se connectent dans les régions en entrée.
| String |
Sortie dérivée
| Nom | Explication | Type de données |
| outputOptimalLinesFeatures | Lignes qui connectent les régions de manière optimale. | Classe d’entités |
| outputNeighborConnectionFeatures | Entités de connexions voisines en sortie. | Classe d’entités |
Exemple de code
Cet exemple calcule les connexions optimales entre les régions.
import arcpy
arcpy.OptimalRegionConnections_ra(
"https://myserver/rest/services/regions/ImageServer", "outOptimalConnections",
"https://myserver/rest/services/barriers/ImageServer",
"https://myserver/rest/services/cost/ImageServer",
"outNeighborConnections")Cet exemple calcule les connexions optimales entre les régions.
#-------------------------------------------------------------------------------
# Name: OptimalRegionConnections_Ex_02.py
# Description: Calculates the optimal connections between regions.
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inputRegionsLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/regions/ImageServer'
outputName = 'outOptimalConnections'
inputBarriersLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/barriers/ImageServer'
inputCostLayer =
'https://MyPortal.esri.com/server/rest/services/Hosted/cost/ImageServer'
outputName02 = 'outNeighborConnections'
distanceMethod = 'GEODESIC'
connectionsWithinRegions = 'GENERATE_CONNECTIONS'
arcpy.OptimalRegionConnections_ra(inputRegionsLayer, outputName, inputBarriersLayer,
inputCostLayer, outputName02, distanceMethod,connectionsWithinRegions)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 ?