| Étiquette | Explication | Type de données |
Données raster ou de régions d'entités en entrée | Les régions en entrée à connecter 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 données d'entités, il peut s'agir de polygones, polylignes ou points. Les régions d'entités surfaciques ne peuvent être constituées de polygones multi-parties. | Raster Layer; Feature Layer |
Lignes de connectivité optimales en sortie | Classe d’entités polylignes en sortie du réseau optimal de chemins qui connectent 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 chemins 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 |
Raster d’interruption ou données d’entités en entrée (Facultatif) | Jeu de données qui définit les interruptions. Les interruptions peuvent être définies par un entier ou un raster à 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 polylignes en sortie qui identifie tous les chemins depuis chaque région jusqu’à ses voisins les plus proches ou ses voisins 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 chemins 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 calcul de distance (Facultatif) | Indique si la distance est calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde).
| String |
Connexions à l’intérieur des régions (Facultatif) | Indique si les chemins continueront et s’ils se connectent au sein des 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 des régions avec le 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 de 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 en entrée. Lorsque des données multi-points sont entrées, l’outil 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 une telle valeur est fournie.
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 rastérisation interne utilise la même méthode par défaut Cell assignment type (Type d’attribution de cellule) que l’outil 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 rastérisée intermédiaire et 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 entre-temps les entités en entrée directement via l’outil Polygone vers raster, définissez une valeur Priority field (Champ de priorité) et utilisez le résultat obtenu comme entrée dans l’outil Connexions optimales des régions. Vous pouvez également sélectionner une taille de cellule suffisamment petite pour capturer le nombre de détails approprié à 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 d’ID de ligne est très étendue (même s’il n’existe que quelques régions), les performances de l’outil Connexions optimales des régions peuvent diminuer.
Les localisations identifiées par le paramètre Input barrier raster or feature data (Raster d’interruption ou données d’entités en entrée), les localisations de cellule avec NoData dans le paramètre Input Cost Raster (Raster de coût en entrée)ou les localisations qui ne se trouvent pas dans l’environnement Mask (Masque) servent toutes d’interruptions.
L’environnement d’analyse Mask (Masque) peut être défini sur 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 des 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 superficies de plus faible coût, remplacez les valeurs nulles par une petite valeur positive (par exemple, 0,01) avant d’exécuter cet outil.
Vous pouvez utiliser l’outil Con pour convertir les cellules nulles en une valeur différente. Si les surfaces dotées d’une valeur nulle représentent des surfaces à exclure de l’analyse, convertissez d’abord ces valeurs en NoData en exécutant l’outil SetNull.
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 par 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 et le voisin le plus proche d’une région est celui accessible au moindre coût. 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 créé à 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 coûts cumulés sont les pondérations des tronçons. L'arbre couvrant de poids minimal est calculé à partir de la représentation graphique des chemins pour déterminer le réseau du chemin de moindre coût 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. À partir 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 aucun coût ou distance de déplacement supplémentaire le long de ces segments de lignes.
Selon la configuration des régions en entrée et leurs voisins d'allocation, un chemin peut passer à travers une région intermédiaire pour atteindre une région voisine. Ce chemin supporte des coûts lors de son passage à travers 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 spécifiques souhaités dans le réseau à l’aide du bouton Select By Attributes (Sélectionner selon les attributs), du groupe Select (Sélectionner) sur l’onglet Map (Carte), ou de l’outil Sélectionner une couche par attributs. La sélection des chemins peut se baser sur la connaissance de la zone et sur les statistiques associées aux chemins dans la table attributaire obtenue.
Le réseau obtenu, soit à partir de l’arbre couvrant de poids minimum ou des connexions voisines facultatives, peut être converti en réseau Network Analyst pour une analyse du réseau complémentaire.
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 | Les régions en entrée à connecter 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 données d'entités, il peut s'agir de polygones, polylignes ou 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 polylignes en sortie du réseau optimal de chemins qui connectent 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 chemins 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 entier ou un raster à 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 polylignes en sortie qui identifie tous les chemins depuis chaque région jusqu’à ses voisins les plus proches ou ses voisins 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 chemins 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 est calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde).
| String |
connections_within_regions (Facultatif) | Indique si les chemins continueront et s’ils se connectent au sein des régions en entrée.
| String |
Exemple de code
Le script de la fenêtre Python ci-après 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érer 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
Vous avez un commentaire à formuler concernant cette rubrique ?