Connexions optimales des régions (Analyse raster)

Synthèse

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

Illustration

Utilisation

• Cet outil de portail d'analyse raster est disponible si vous êtes connecté à un portail ArcGIS Enterprise où ArcGIS Image Server est configuré pour l'Analyse raster. Si cet outil est exécuté, ArcGIS Pro est utilisé comme client et le traitement est effectué sur 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, 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 les 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 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.

• Si l'entrée de la région est une entité, le champ ObjectID est utilisé comme identifiants de région.

• Les emplacements identifiés par le paramètre Raster ou entités d’interruption en entrée ou les emplacements de cellule ayant la valeur NoData dans le paramètre 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.

• Les valeurs de raster de coût négatives ou nulles ne sont pas valides, mais sont traitées comme petites valeurs positives. L’algorithme de coût cumulé est un processus multiplicatif ; il ne peut pas calculer correctement le coût cumulé si les valeurs de coût sont négatives ou nulles. Si le raster de coût contient ces valeurs et que ces emplacements représentent des zones à exclure de l’analyse, convertissez ces cellules en NoData avant d’exécuter l’outil. Vous pouvez effectuer cette opération avec l’outil SetNull de l’extension ArcGIS Spatial Analyst. La valeur NoData étant traitée comme une interruption dans cette analyse, les emplacements qui sont NoData dans l’entrée le sont également dans le résultat.

• Pour le paramètre Nom des lignes de connexion 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.

• L’environnement d’analyse Masque peut être une entité ou un jeu de données raster. Si le masque est une entité, il est converti en raster. Les cellules contenant une valeur définissent les emplacements situés dans la zone du masque. Les cellules NoData définissent les emplacements situés en dehors de la zone du masque et sont traitées comme une interruption.

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

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Régions d’entité ou raster en entrée	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
Nom des lignes de connexion optimale en sortie	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
Raster ou entités d’interruption en entrée (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 un service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique. 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
Raster de coût en entrée	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 entières ou à virgule flottante. Les valeurs de raster de coût négatives ou nulles ne sont pas valides, mais sont traitées comme petites valeurs de coût positives.	Raster Layer; Image Service; String
Nom des lignes de connexion voisines en sortie (Facultatif)	Classe d’entités polylinéaires en sortie qui identifie tous les chemins depuis chaque région jusqu’à 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 elles sont utiles lorsque vous devez identifier les chemins à supprimer, s’il y a lieu. 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
Méthode de distance (Facultatif)	Indique si la distance sera calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde). Planaire—Le 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. Géodésique—Le calcul de la distance sera effectué sur l’ellipsoïde. Les résultats ne changent pas, quelle que soit la projection en entrée ou en sortie.	String
Connections Within Regions (Connexions dans les régions) (Facultatif)	Spécifie si les chemins continuent et sont connectés dans les régions en entrée. Générer des connexions—Les chemins continuent dans les régions en entrée ; tous les chemins qui entrent dans une région sont connectés. Aucune connexion—Les chemins s’arrêtent à la limite des régions en entrée ; ils ne continuent pas et ne sont pas connectés pas dans ces régions.	String

Sortie obtenue

Étiquette	Explication	Type de données
Lignes de connexion optimales en sortie	Lignes qui connectent les régions de manière optimale.	Feature Class
Lignes de connexion voisines en sortie	Entités de connexions voisines en sortie.	Feature Class

Python

arcpy.ra.OptimalRegionConnections(inputRegionRasterOrFeatures, outputOptimalLinesName, {inputBarrierRasterOrFeatures}, inputCostRaster, {outputNeighborConnectionsName}, {distanceMethod}, {connectionsWithinRegions})

Nom	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 : 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 un service d’entités, l’entrée peut être de type ponctuel, linéaire ou surfacique. 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 entières ou à virgule flottante. Les valeurs de raster de coût négatives ou nulles ne sont pas valides, mais sont traitées comme petites valeurs de coût positives.	Raster Layer; Image Service; String
outputNeighborConnectionsName (Facultatif)	Classe d’entités polylinéaires en sortie qui identifie tous les chemins depuis chaque région jusqu’à 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 elles sont utiles lorsque vous devez identifier les chemins à supprimer, s’il y a lieu. 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)	Indique si la distance sera calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde). PLANAR—Le 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. GEODESIC—Le calcul de la distance sera effectué sur l’ellipsoïde. Les résultats ne changent pas, quelle que soit la projection en entrée ou en sortie.	String
connectionsWithinRegions (Facultatif)	Spécifie si les chemins continuent et sont connectés dans les régions en entrée. GENERATE_CONNECTIONS—Les chemins continuent dans les régions en entrée ; tous les chemins qui entrent dans une région sont connectés. NO_CONNECTIONS—Les chemins s’arrêtent à la limite des régions en entrée ; ils ne continuent pas et ne sont pas connectés pas dans ces régions.	String

Sortie obtenue

Nom	Explication	Type de données
outputOptimalLinesFeatures	Lignes qui connectent les régions de manière optimale.	Feature Class
outputNeighborConnectionFeatures	Entités de connexions voisines en sortie.	Feature Class

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.ra.OptimalRegionConnections(
    "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.ra.OptimalRegionConnections(inputRegionsLayer, outputName, inputBarriersLayer,
                                  inputCostLayer, outputName02, distanceMethod,connectionsWithinRegions)

Environnements

Taille de cellule, Étendue, Masque, Système de coordonnées en sortie, Raster de capture

Informations de licence

• Basic: Nécessite ArcGIS Image Server
• Standard: Nécessite ArcGIS Image Server
• Advanced: Nécessite ArcGIS Image Server