Générer des lignes de brèchage (Outils Spatial Analyst)

Résumé

Crée des lignes utilisées pour contourner les obstacles locaux empêchant l’écoulement de l’eau.

Utilisation

– Une dépression est une zone topographiquement inférieure que le terrain environnant et qui interrompt l’écoulement de l’eau. L’outil Generate Breach Lines (Générer des lignes de brèchage) trouve une ligne de brèchage qui relie la dépression à un point en aval, assurant ainsi la connectivité hydrologique.

– La valeur du paramètre Output Breach Lines (Lignes de brèchage en sortie) représente les lignes qui ouvrent une brèche dans chaque polygone de dépression, assurant la connectivité hydrologique. La valeur du paramètre Input Depression Polygons (Polygones de dépression en entrée) (in_depression_polygons dans Python) représente chaque polygone de dépression dans lequel ouvrir une brèche.

– La valeur du paramètre Input Connection Points (Points de connexion en entrée) (in_connection_points dans Python) représente les points de début et de fin que la ligne de brèche va raccorder. Vous pouvez également utiliser l’outil Localiser les dépressions.

– La couche d’entités Input Connection Points (Points de connexion en entrée) est censée comporter deux champs. Le premier champ, DEP_ID, est l’ID de la dépression à laquelle ce point appartient. Le champ binaire POINT_TYPE indique si le point marque le début (valeur 0) ou la fin (valeur 1) de la ligne à générer.

– Les lignes de rupture dans la couche d’entités en sortie commencent toujours à un point de la dépression et se terminent à une localisation de cellule située à une élévation plus basse afin d’assurer l’écoulement de l’eau. L’outil ne génère pas de lignes qui couvrent partiellement ce chemin. En d’autres termes, aucune ligne partielle ou incomplète n’est créée.

– Pour chaque polygone de dépression, la ligne de brèchage en sortie commence au point d’élévation minimale dans la dépression. La fin de la ligne dépend de l’option spécifiée pour la valeur du paramètre Trace Method (Méthode de traçage) (trace_method dans Python).

– Lorsque l’option Shortest Path (Plus court chemin) (SHORTEST_PATH dans Python) est spécifiée pour la valeur du paramètre Trace Method (Méthode de traçage), les points de début et de fin doivent être présents dans la valeur du paramètre Inpt Connection Points (Points de connexion en entrée) pour chaque dépression.

– Lorsque l’option Minimum Breaching Cost (Coût de brèchage minimum) (MIN_BREACHING_COST dans Python) est spécifiée pour Trace Method (Méthode de traçage), la ligne de brèchage en sortie représente le chemin qui minimise le coût de brèchage de chemin selon Lindsay et Dhun (2015). Le coût de brèchage est égal à la quantité d’élévation à abaisser ou creuser afin de créer un canal reliant la dépression à une autre localisation de cellule à une élévation plus basse, afin d’assurer l’écoulement de l’eau.

– Si le paramètre d’environnement Masque est spécifié, l’outil ne génère une ligne de brèchage que si le point de début (dans la dépression) se trouve dans la zone de masque. La zone de dépression peut se trouver entièrement ou partiellement à l’intérieur de la zone de masque.

– Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Etiqueter	Explication	Type de données
Polygones de dépression en entrée	Couche d’entités en entrée contenant les polygones qui définissent des zones de dépression. Une dépression est une zone topographiquement inférieure que le terrain environnant et qui interrompt l’écoulement de l’eau.	Feature Layer
Raster de surface en entrée	Raster de surface en entrée.	Raster Layer
Lignes de brèchage en sortie	Classe d’entités en sortie contenant une ligne qui connecte les dépressions à une cellule en aval et assure la connectivité hydraulique. Chaque ligne est numérotée de manière unique. Les champs supplémentaires dans la table attributaire stockent des informations spécifiques concernant le point. Ces champs sont les suivants : `LENGTH`—Longueur de la ligne de brèchage en mètres. `DEP_ID`—Identifiant de la dépression à laquelle le point est associé. `START_X`—Coordonnée X du début de la ligne de brèchage. `START_Y`—Coordonnée Y du début de la ligne de brèchage. `END_X`—Coordonnée X de la fin de la ligne de brèchage. `END_Y`—Coordonnée Y de la fin de la ligne de brèchage. Les valeurs des quatre champs de coordonnées sont dans la référence spatiale en sortie.	Feature Class
Points de connexion en entrée (Facultatif)	Points en entrée facultatifs qui définissent le point d’élévation le plus bas dans une dépression et le point de connexion en aval correspondant. Cette entrée est requise lorsque Shortest Path (Chemin le plus court) est spécifiée comme valeur du paramètre Trace Method (Méthode de traçage). Les champs attendus dans la table attributaire sont les suivants : `DEP_ID`—L’identifiant de la dépression à laquelle le point est associé. `POINT_TYPE`—Champ booléen dans lequel la valeur 0 indique que le point est le point d’élévation le plus bas de la dépression et la valeur 1 indique qu’il s’agit d’un point de connexion en aval.	Feature Layer
Méthode de traçage (Facultatif)	Spécifie la méthode utilisée pour créer la ligne de brèchage. Les méthodes suivantes sont disponibles : Coût de brèchage minimum—La ligne suivra un chemin qui minimise le coût de brèchage. Il s’agit de l’option par défaut. Plus court chemin—Chemin avec la plus distance la plus courte entre le début et la fin. Cette option nécessite que les points de départ et d’arrivée soient tous les deux présents dans la valeur du paramètre Input Connection Points (Points de connexion en entrée). Le chemin sera la ligne la plus courte qui contourne l’obstacle local empêchant l’écoulement de l’eau. Modification d’élévation minimale—La ligne suivra un chemin qui minimise la modification de l’élévation.	String
Longueur maximale (Facultatif)	Longueur maximale autorisée pour une ligne de brèchage. Si une ligne de brèchage potentielle est au-dessus de cette limite, cette ligne n’est pas incluse dans la classe d’entités des lignes de brèchage en entrée. La valeur par défaut est 50 mètres ou l’équivalent en unité cartographique de la référence spatiale de l’analyse.	Linear Unit

GenerateBreachLines(in_depression_polygons, in_surface_raster, out_breach_lines, {in_connection_points}, {trace_method}, {max_length})

Nom	Explication	Type de données
in_depression_polygons	Couche d’entités en entrée contenant les polygones qui définissent des zones de dépression. Une dépression est une zone topographiquement inférieure que le terrain environnant et qui interrompt l’écoulement de l’eau.	Feature Layer
in_surface_raster	Raster de surface en entrée.	Raster Layer
out_breach_lines	Classe d’entités en sortie contenant une ligne qui connecte les dépressions à une cellule en aval et assure la connectivité hydraulique. Chaque ligne est numérotée de manière unique. Les champs supplémentaires dans la table attributaire stockent des informations spécifiques concernant le point. Ces champs sont les suivants : `LENGTH`—Longueur de la ligne de brèchage en mètres. `DEP_ID`—Identifiant de la dépression à laquelle le point est associé. `START_X`—Coordonnée X du début de la ligne de brèchage. `START_Y`—Coordonnée Y du début de la ligne de brèchage. `END_X`—Coordonnée X de la fin de la ligne de brèchage. `END_Y`—Coordonnée Y de la fin de la ligne de brèchage. Les valeurs des quatre champs de coordonnées sont dans la référence spatiale en sortie.	Feature Class
in_connection_points (Facultatif)	Points en entrée facultatifs qui définissent le point d’élévation le plus bas dans une dépression et le point de connexion en aval correspondant. Cette entrée est requise lorsque `SHORTEST_PATH` est spécifiée comme valeur du paramètre `trace_method`. Les champs attendus dans la table attributaire sont les suivants : `DEP_ID`—L’identifiant de la dépression à laquelle le point est associé. `POINT_TYPE`—Champ booléen dans lequel la valeur 0 indique que le point est le point d’élévation le plus bas de la dépression et la valeur 1 indique qu’il s’agit d’un point de connexion en aval.	Feature Layer
trace_method (Facultatif)	Spécifie la méthode utilisée pour créer la ligne de brèchage. Les méthodes suivantes sont disponibles : `MIN_BREACHING_COST`—La ligne suivra un chemin qui minimise le coût de brèchage. Il s’agit de l’option par défaut. `SHORTEST_PATH`—Chemin avec la plus distance la plus courte entre le début et la fin. Cette option nécessite que les points de départ et d’arrivée soient tous les deux présents dans la valeur du paramètre `in_connection_points`. Le chemin sera la ligne la plus courte qui contourne l’obstacle local empêchant l’écoulement de l’eau. `MIN_ELEV`—La ligne suivra un chemin qui minimise la modification de l’élévation.	String
max_length (Facultatif)	Longueur maximale autorisée pour une ligne de brèchage. Si une ligne de brèchage potentielle est au-dessus de cette limite, cette ligne n’est pas incluse dans la classe d’entités des lignes de brèchage en entrée. La valeur par défaut est 50 mètres ou l’équivalent en unité cartographique de la référence spatiale de l’analyse.	Linear Unit

Exemple de code

GenerateBreachLines Exemple 1 (fenêtre Python)

L'exemple suivant illustre l'utilisation de cet outil dans la fenêtre Python. Cet exemple génère la ligne de plus courte distance qui ouvre une brèche dans le polygone de dépression reliant les points de connexion de début et de fin avec les valeurs de paramètres par défaut.

from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapy/examples/data"
GenerateBreachLines("inputDepressionPolygons.shp", "inputSurfaceRaster.tif", "C:/sapyexamples/output/streams.shp", "", "", "", "")

GenerateBreachLines Exemple 2 (script autonome)

Cet exemple génère les lignes qui ouvrent une brèche dans le polygone de dépression d’une longueur maximale de 50 mètres, suivant le trajet d’élévation minimale.

# Name: GenerateBreachLines_standalone.py
# Description: Generates lines that breach depression polygons following the 
#              minimum elevation path and a maximum length of 50 meters.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set the analysis environments
env.workspace = "C:/sapyexamples/data"

# Set the local variables
in_depression_polygons = "depressions.shp",
in_surface_raster = "inSurfaceRaster.tif"
out_breach_lines = "C:/sapyexamples/output/breachlines.shp"
in_connection_points= None
trace_method = "MIN_BREACHING_COST"
max_length = "50 Meters"


# Run Generate Breach Lines
GenerateBreachLines(in_depression_polygons, 
                    in_surface_raster,
                    out_breach_lines,
                    in_connection_points,
                    trace_method,
                    max_length)

Environnements

Etendue, Masque, Validation automatique, Espace de travail courant, Valeur Z en sortie par défaut, Transformations géographiques, Résolution M, Tolérance M, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Valeurs M en sortie, Valeurs Z en sortie, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Espace de travail temporaire, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z

Informations de licence

Basic: Nécessite Spatial Analyst
Standard: Nécessite Spatial Analyst
Advanced: Nécessite Spatial Analyst

Bibliographie

"Lindsay J, Dhun K. 2015. Modelling surface drainage patterns in altered landscapes using LiDAR. International Journal of Geographical Information Science, 29: 1-15. DOI: 10.1080/13658816.2014.975715"