| Étiquette | Explication | Type de données |
Données raster ou de régions d'entités 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 un jeu de 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 est un jeu de classes d’entités, il peut s’agir de polygones, de polylignes ou de points. Les régions d'entités surfaciques ne peuvent être constituées de polygones multi-parties. | Raster Layer; Feature Layer |
Output optimal connectivity lines (Lignes de connectivité optimale en sortie) | Classe d’entités polyligne en sortie du réseau de chemins optimal qui connecte 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. 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. | Feature Class |
Données raster ou d’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 raster d’entiers ou de valeurs à virgule flottante ou par une entité ponctuelle, linéaire ou surfacique. | Raster Layer; Feature Layer |
Raster de coût en entrée (Facultatif) | 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 |
Classe d'entités en sortie de connexions voisines (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 :
Ces informations vous permettent de mieux comprendre les chemins du réseau et sont utiles pour 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. | Feature Class |
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).
| String |
Connexions au sein des régions (Facultatif) | Spécifie si les chemins continuent et sont connectés dans les régions en entrée.
| String |
Synthèse
Calcule le réseau de connectivité optimal entre deux régions en entrée ou plus.
En savoir plus sur la connexion de régions au réseau optimal
Utilisation
Les régions en entrée peuvent être des données raster ou d'entités.
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 d’abord l’outil Groupes par régions pour procéder à un prétraitement et affecter des valeurs uniques à chaque région. Utilisez ensuite le raster obtenu comme régions en entrée dans l’outil Connexions optimales des régions.
Lorsque les régions en entrée sont identifiées par des données surfaciques, linéaires ou ponctuelles, elles sont converties en raster à l’aide de l’identifiant d’entité pour s’assurer que les régions résultantes correspondent à des valeurs uniques. Les polygones multi-parties ne peuvent pas être utilisés comme entrée. Lorsque des données multi-points sont entrées, l’outil Optimal Region Connections (Connexions optimales des régions) sélectionne de manière aléatoire un des points à l’emplacement comme valeur de la région.
Vous pouvez contrôler la résolution des régions des entités en entrée rasterisées avec l'environnement Taille de cellule. Par défaut, la résolution est définie sur la résolution du raster de coût en entrée si un tel raster est fourni.
Lorsque vous utilisez des données d'entité surfacique comme données de région en entrée, vous devez traiter la taille de cellule en sortie avec prudence si elle est grossière par rapport au détail des données en entrée. Le processus de tramage interne utilise la même méthode par défaut Cell assignment type (Type d’attribution de cellule) que l’outil Polygon to Raster (Polygone vers raster), à savoir Cell center (Centre de cellule). Cela signifie que les données ne figurant pas au centre de la cellule ne sont pas incluses dans la région rasterisée intermédiaire. Elles ne sont pas représentées dans les calculs de distance. Par exemple, si vos régions sont représentées par une série de petits polygones, tels que des emprises de bâtiments, dont la taille est petite par rapport à celle de la cellule en sortie, il se peut que seuls certains d’entre eux apparaissent au centre des cellules raster en sortie et que, vraisemblablement, la plupart des autres polygones soient perdus et exclus de l’analyse.
Pour éviter cette situation, rastérisez directement les entités en entrée à l’aide de l’outil Polygone vers raster, définissez une valeur Priority field (Champ de priorité) et utilisez le résultat obtenu comme entrée de l’outil Connexions optimales des régions. Vous pouvez également sélectionner une taille de cellule suffisamment petite pour capturer la quantité de détails appropriée à partir des entités en entrée.
Si l'entrée de la région est une entité, le champ ObjectID est utilisé comme identifiants de région.
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 l’outil Connexions optimales des régions peuvent être détériorées.
Les localisations identifiées par le paramètre Input barrier raster paramètre or feature data (Données d’entité ou raster d’interruption en entrée), les localisations de cellule dont la valeur du paramètre Input cost raster (Raster de coût en entrée) est NoData ou les localisations qui ne se trouvent pas dans Mask (Masque), agissent toutes comme des interruptions.
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.
L'étendue de traitement par défaut correspond à celle de la valeur Input cost raster (Raster de coût en entrée) si une telle valeur est fournie ; sinon, elle correspond à 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 égales à zéro, puisque l’algorithme est un processus multiplicatif. Si votre raster de coût contient des valeurs égales à zéro, et que ces valeurs représentent des surfaces de plus faible coût, remplacez-les par une petite valeur (comme 0,01) avant d’exécuter l’outil Distance de coût.
Vous pouvez utiliser l’outil Con pour remplacer la valeur zéro dans les cellules par une autre valeur. Si les zones comportant une valeur nulle représentent des zones à exclure de l’analyse, convertissez d’abord ces valeurs en valeurs NoData en exécutant l’outil Définir comme nul.
Pour le paramètre Output feature class of neighboring connections (Classe d’entités en sortie de connexions voisines), si aucune surface de coût n’est indiquée, les voisins sont identifiés à l’aide de la distance euclidienne. Dans ce cas, le voisin le plus proche d'une région est 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, ce qui fait du voisin le plus proche d’une région le moins onéreux à atteindre. Une opération d'allocation de coût permet d'identifier les régions voisines les unes des autres.
Le réseau en sortie optimal est généré à partir des chemins produits dans les connexions voisines facultatives en sortie. Les chemins des connexions voisines facultatives en sortie sont convertis en théorie des graphes. Les régions sont les sommets, les chemins sont les tronçons et les distances ou les coûts cumulés sont les poids des tronçons. L’arbre couvrant de poids minimal est calculé à partir de la représentation du diagramme des chemins pour déterminer le réseau du chemin optimal nécessaire pour se déplacer entre les régions.
Chaque chemin optimal atteint d’abord la limite extérieure du polygone ou de la région multicellulaire. Du périmètre de la région, l’outil prolonge les chemins avec des segments de lignes supplémentaires pour créer des points d’entrée et de sortie entre les régions et permettre un déplacement au sein de ces dernières. Il n’existe aucune distance ni aucun coût de déplacement supplémentaire le long de ces segments de lignes.
En fonction de la configuration des régions en entrée et de leurs voisins d’allocation, un chemin peut traverser une région intermédiaire pour atteindre une région voisine. Ce chemin implique alors des coûts pendant le déplacement dans cette région intermédiaire.
Vous pouvez utiliser les connexions voisines facultatives en sortie en tant qu'alternative au réseau de l'arbre couvrant de poids minimal. Cette sortie connecte chaque région à ses régions de coût voisines, ce qui génère un réseau plus complexe comportant de nombreux chemins. La classe d’entités peut être utilisée telle quelle ou en tant que base pour créer votre propre réseau. Pour ce faire, sélectionnez les chemins que vous voulez inclure dans le réseau à l’aide du bouton Select By Attributes (Sélectionner selon les attributs), du groupe Sélectionner de l’onglet Map (Carte) ou encore de l’outil Sélectionner une couche par attributs. Le choix des chemins peut se baser sur la connaissance de la zone et sur les statistiques associées aux chemins dans la table attributaire obtenue.
Cet outil prend en charge le traitement parallèle. Il est possible d’obtenir de meilleures performances, en particulier sur les jeux de données volumineux, si votre ordinateur est doté de plusieurs processeurs ou de processeurs multicœurs. Reportez-vous à la rubrique d’aide Traitement parallèle avec Spatial Analyst pour des détails sur cette fonctionnalité et comment la configurer.
Lorsque vous utilisez le traitement parallèle, des données temporaires sont écrites afin de gérer les blocs de données en cours de traitement. L’emplacement par défaut du dossier temporaire se trouve sur votre disque C:. Vous pouvez contrôler l’emplacement de ce répertoire en définissant une variable d’environnement système appelée TempFolders et en spécifiant le chemin d’accès du répertoire à utiliser (par exemple, E:\RasterCache). Si vous disposez de privilèges d’administrateur sur votre ordinateur, vous pouvez également utiliser une clé de registre (par exemple, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ ArcGISPro\Raster]).
Par défaut, cet outil utilise 50 pourcent des cœurs disponibles. Si les données en entrée sont inférieures à 5 000 par 5 000 cellules en taille, le nombre de cœurs utilisé peut être moindre. Vous pouvez contrôler le nombre de cœurs que l’outil utilise à l’aide de l'environnement Facteur de traitement parallèle.
Le réseau obtenu, que ce soit pour l’arbre couvrant de poids minimum ou les connexions voisines facultatives, peut être converti en réseau Network Analyst pour effectuer une analyse complémentaire du réseau.
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
OptimalRegionConnections(in_regions, out_feature_class, {in_barrier_data}, {in_cost_raster}, {out_neighbor_paths}, {distance_method}, {connections_within_regions})| Nom | Explication | Type de données |
in_regions | 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 un jeu de 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 est un jeu de classes d’entités, il peut s’agir de polygones, de polylignes ou de points. Les régions d'entités surfaciques ne peuvent être constituées de polygones multi-parties. | Raster Layer; Feature Layer |
out_feature_class | Classe d’entités polyligne en sortie du réseau de chemins optimal qui connecte 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. 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. | Feature Class |
in_barrier_data (Facultatif) | Jeu de données qui définit les interruptions. Les interruptions peuvent être définies par un raster d’entiers ou de valeurs à virgule flottante ou par une entité ponctuelle, linéaire ou surfacique. | Raster Layer; Feature Layer |
in_cost_raster (Facultatif) | 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 |
out_neighbor_paths (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 :
Ces informations vous permettent de mieux comprendre les chemins du réseau et sont utiles pour 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. | Feature Class |
distance_method (Facultatif) | Indique si la distance sera calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde).
| String |
connections_within_regions (Facultatif) | Spécifie si les chemins continuent et sont connectés dans les régions en entrée.
| String |
Exemple de code
Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction OptimalRegionConnections.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outOptRegConnect = OptimalRegionConnections("source.shp", "elevation")
outOptRegConnect.save("C:/sapyexamples/output/optregconnect.tif")Génère le réseau de chemins optimal de moindre coût connectant entre elles les régions en entrée.
# Name: OptimalRegionConnections_Ex_02.py
# Description: Calculates the optimal network of connections for the sources.
#
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inSourceData = "sources.shp"
inBarrier = "barriers.tif"
inCostRaster = "cost_surface.tif"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute the tool
outOptRegConnect = OptimalRegionConnections(inSourceData, inBarrier, inCostRaster)
# Save the output
outOptRegConnect.save("C:/sapyexamples/output/optregconnect.tif")Environnements
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?