Connexions optimales des régions (Analyse raster)

Résumé

Calcule la connexion optimale des chemins entre deux régions en entrée ou plus.

Illustration

Illustration de l’outil Optimal Region Connections (Connexions optimales des régions)

Utilisation

  • Cet outil du portail d’analyse raster est disponible lorsque vous êtes connecté à un portail ArcGIS Enterprise Lien vers Présentation de l’analyse dans ArcGIS Enterprise comportant un ArcGIS Image Server Lien vers Présentation de ArcGIS Image Server configuré pour Raster Analysis Lien vers Configurer et déployer l’analyse raster. 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ètreExplicationType 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 :

  • PATHID : identifiant unique du chemin
  • PATHCOST : distance ou coût cumulé total du chemin
  • REGION1 : première région à laquelle le chemin se connecte
  • REGION2 : autre région à laquelle le chemin se connecte

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 :

  • PATHID : identifiant unique du chemin
  • PATHCOST : distance ou coût cumulé total du chemin
  • REGION1 : première région à laquelle le chemin se connecte
  • REGION2 : autre région à laquelle le chemin se connecte

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).

  • PLANARLe calcul de la distance est effectué sur une surface plane projetée à l’aide d’un système de coordonnées cartésiennes 2D. Il s’agit de l’option par défaut.
  • GEODESICLe calcul de la distance est effectué sur l’ellipsoïde. Les résultats ne changent donc pas quelle que soit la projection en entrée ou en sortie.
String
connectionsWithinRegions
(Facultatif)

Indique si les chemins continuent et se connectent dans les régions en entrée.

  • GENERATE_CONNECTIONSLes chemins continuent dans les régions en entrée pour connecter tous les chemins qui entrent dans une région.
  • NO_CONNECTIONSLes chemins s’arrêtent aux segments des régions en entrée et ne continuent pas ou ne s’y connectent pas.
String

Sortie dérivée

NomExplicationType 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

Exemple 1 d’utilisation de l’outil Optimal Region Connections (Connexions optimales des régions) (fenêtre Python)

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")
Exemple 2 d'utilisation de l'outil Optimal Region Connections (Connexions optimales des régions) (script autonome)

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)

Informations de licence

  • Basic: Requiert ArcGIS Image Server
  • Standard: Requiert ArcGIS Image Server
  • Advanced: Requiert ArcGIS Image Server

Rubriques connexes