| Étiquette | Explication | Type de données |
Régions d’entité ou raster en entrée | Régions en entrée qui seront connectées par les couloirs optimaux. 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 |
Polygones de couloir optimal en sortie | Classe d’entités linéaires ou surfaciques en sortie des couloirs optimaux qui connectent chacune des régions en entrée. Les couloirs (ou lignes) se superposeront dans les emplacements où les couloirs suivent le même itinéraire. Chaque couloir (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 :
| Feature Class |
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 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 |
Lignes de connexion optimales en sortie (Facultatif) | La classe d’entités linéaires en sortie identifie les lignes optimales pour connecter chacune des régions en entrée. Les lignes se superposeront dans les emplacements où les chemins suivent le même itinéraire. 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 :
| Feature Class |
Polygones de couloir voisins en sortie (Facultatif) | Classe d’entités linéaires ou surfaciques en sortie identifiant les couloirs optimaux qui connectent chaque région à ses voisins les plus proches ou ses voisins de coût. Les couloirs (ou lignes) se superposeront dans les emplacements où les couloirs suivent le même itinéraire. Chaque couloir 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 :
| Feature Class |
Lignes de connexion voisines en sortie (Facultatif) | Classe d’entités linéaires en sortie qui identifie la ligne optimale depuis chaque région jusqu’à ses voisins les plus proches ou ses voisins de coût. Chaque couloir (ou polygone) 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 :
Comme chaque chemin est représenté par une ligne unique, plusieurs lignes seront présentes aux emplacements où le même itinéraire est optimal. | Feature Class |
Méthode de couloir (Facultatif) | Indique le mode de création du couloir.
Remarque :Dans cette version, il n’existe qu’une seule méthode pour créer des couloirs : largeur fixe. Étant donné qu’il n’existe qu’une seule option par défaut, ce paramètre sera inactif et n’apparaîtra pas dans la boîte de dialogue de l’outil. | String |
Largeur du couloir (Facultatif) | Distance linéaire qui définit la largeur des couloirs générés. La valeur doit être supérieure ou égale à zéro. La valeur par défaut est zéro. | Double |
Méthode de calcul de distance (Facultatif) | Indique si la distance sera calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde).
| String |
Disponible avec une licence Spatial Analyst.
Synthèse
Calcule les connexions optimales des couloirs entre plusieurs régions en entrée.
En savoir plus sur la connexion des emplacements avec des couloirs
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 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 d’abord l’outil Groupes par régions pour procéder à un prétraitement et affecter des valeurs uniques à chaque région. Ensuite, utilisez le raster obtenu comme régions en entrée dans cet outil.
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. Si des données multi-points sont fournies, l'outil sélectionne de manière aléatoire l'un des points de la localisation 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 les 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 cela, rastérisez les entités en entrée directement avec l’outil Polygone vers raster, définissez une valeur Priority field (Champ de priorité), puis utilisez le résultat obtenu comme entrée dans cet outil. 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.
Les localisations identifiées par le paramètre Input Raster or Feature Barriers (Raster ou entités d’interruption en entrée), les localisations de cellule avec NoData dans la valeur du 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 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 du paramètre 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.
La valeur du 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 le 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.
Lorsque la valeur du paramètre Input Cost Raster (Raster de coût en entrée) est fournie, l’outil effectue des calculs sur cette surface de coût en fonction de la valeur du paramètre Corridor Width (Largeur du couloir). Cela garantit que des couloirs optimaux sont créés pour la largeur spécifiée et que les régions situées près de la limite de la surface ne sont pas connectées aux autres résultats.
La spécification de régions situées près de la valeur du paramètre Input Raster or Feature Barriers (Raster ou entités d’interruption en entrée) peut également créer des couloirs non connectés.
Pour les paramètres Output Neighboring Corridor Polygons (Polygones de couloir voisins en sortie) et Output Neighboring Connection Lines (Lignes de connexion voisines en sortie), si aucune surface de coût n’est fournie, les voisins seront 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 seront 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.
La valeur du paramètre Output Neighboring Corridor Polygons (Polygones de couloir voisins en sortie) est créée à partir des chemins produits dans les lignes de connexion voisines facultatives en sortie. Les chemins des lignes de connexion 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 de lignes de connexion optimales nécessaire pour se déplacer entre les régions. Le réseau de polygones de couloir optimal est créé à partir du réseau de lignes de connexion optimales.
La valeur du paramètre Output Optimal Connect Lines (Lignes de connexion optimales en sortie) est un sous-ensemble des chemins produits par le paramètre Output Optional Neighboring Connection Lines (Lignes de connexion voisines facultatives en sortie). Pour calculer ce sous-ensemble, les lignes de connexion voisines sont converties 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 sous-ensemble de lignes de connexion optimales nécessaire pour se déplacer entre les régions.
Chaque ligne optimale atteint 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 la valeur du paramètre Output Neighboring Connection Lines (Lignes de connexion voisines 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.
Les couloirs créés par cet outil sont des couloirs de largeur fixe. Le paramètre Corridor Width (Largeur du couloir) identifie la largeur fixe des couloirs sous forme de distance linéaire. Lorsque la valeur du paramètre Corridor Width (Largeur du couloir) est 0, les couloirs en sortie seront les lignes de chemin optimal.
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
OptimalCorridorConnections(in_regions, out_optimal_polygons, {in_barriers}, {in_cost_raster}, {out_optimal_lines}, {out_neighbor_polygons}, {out_neighbor_lines}, {corridor_method}, {corridor_width}, {distance_method})| Nom | Explication | Type de données |
in_regions | Régions en entrée qui seront connectées par les couloirs optimaux. 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_optimal_polygons | Classe d’entités linéaires ou surfaciques en sortie des couloirs optimaux qui connectent chacune des régions en entrée. Les couloirs (ou lignes) se superposeront dans les emplacements où les couloirs suivent le même itinéraire. Chaque couloir (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 :
| Feature Class |
in_barriers (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_optimal_lines (Facultatif) | La classe d’entités linéaires en sortie identifie les lignes optimales pour connecter chacune des régions en entrée. Les lignes se superposeront dans les emplacements où les chemins suivent le même itinéraire. 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 :
| Feature Class |
out_neighbor_polygons (Facultatif) | Classe d’entités linéaires ou surfaciques en sortie identifiant les couloirs optimaux qui connectent chaque région à ses voisins les plus proches ou ses voisins de coût. Les couloirs (ou lignes) se superposeront dans les emplacements où les couloirs suivent le même itinéraire. Chaque couloir 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 :
| Feature Class |
out_neighbor_lines (Facultatif) | Classe d’entités linéaires en sortie qui identifie la ligne optimale depuis chaque région jusqu’à ses voisins les plus proches ou ses voisins de coût. Chaque couloir (ou polygone) 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 :
Comme chaque chemin est représenté par une ligne unique, plusieurs lignes seront présentes aux emplacements où le même itinéraire est optimal. | Feature Class |
corridor_method (Facultatif) | Indique le mode de création du couloir. Remarque :Dans cette version, il n’existe qu’une seule méthode pour créer des couloirs : largeur fixe. Étant donné qu’il n’existe qu’une seule option par défaut, ce paramètre sera inactif et n’apparaîtra pas dans la boîte de dialogue de l’outil.
| String |
corridor_width (Facultatif) | Distance linéaire qui définit la largeur des couloirs générés. La valeur doit être supérieure ou égale à zéro. La valeur par défaut est zéro. | Double |
distance_method (Facultatif) | Indique si la distance sera calculée avec une méthode plane (Terre plate) ou géodésique (ellipsoïde).
| String |
Exemple de code
Le script de fenêtre Python suivant illustre l’utilisation de la fonction OptimalCorridorConnections.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data"
out_OCC_raster = OptimalCorridorConnections("InRegions.tif",
"OutCorridors.shp", "InBarriers.tif", "InCostRaster.tif",
"OutOptimalPaths.shp", "OutNbrPoly.shp", "OutNbrLines.shp",
"FIXED_WIDTH_CORRIDOR", 5000, "PLANAR")Calculer un réseau optimal de couloirs écologiques entre des zones habitées connues.
# Name: OptimalCorridorConnections_standalone.py
# Description: Calculates corridor.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set environment settings
env.workspace = "C:/arcpyexamples/data"
# Set local variables
regions = "Lakes.tif"
outCorridors = "NewCorridors.shp"
roadBarriers = "Roads.shp"
costSurface = "CostSurface.tif"
optimalLines = "OutCorridorCenterLines.shp"
outAllCorridors = "OutAllCorridors.shp"
outAllLines = "OutAllCenterLines.shp"
corridorMethod = "FIXED_WIDTH_CORRIDOR"
corridorWidth = 5000
distanceMethod = "GEODESIC"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute OptimalCorridorConnections
OptimalCorridorConnections(regions, outCorridors, roadBarriers,
costSurface, optimalLines,
outAllCorridors, outAllLines,
corridorMethod, corridorWidth, distanceMethod)Environnements
Informations de licence
- Basic: Nécessite Spatial Analyst
- Standard: Nécessite Spatial Analyst
- Advanced: Nécessite Spatial Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?