Ajuster le cours d’eau au raster (Spatial Analyst)—ArcGIS Pro

Disponible avec une licence Spatial Analyst.

Synthèse

Ajuste l’entité de cours d’eau en entrée en fonction de la résolution d’un raster en entrée.

Utilisation

Le paramètre Entités de cours d’eau ajustées en sortie (out_stream_features dans Python) représente les entités de lignes de courant dans la valeur du paramètre Entités de cours d’eau en entrée (in_stream_features dans Python) après leur ajustement en fonction de la résolution de la valeur du paramètre Raster en entrée (in_raster dans Python).
Le processus d’ajustement garantit que le cours d’eau ajusté croise chaque cellule superposée de la valeur du paramètre Raster en entrée en son centre tout en conservant la trajectoire initiale des lignes de courant.
Le paramètre facultatif Champ de regroupement (group_by_field dans Python) regroupe des segments de cours d‘eau en fonction du champ sélectionné. Par défaut, aucun regroupement n’est appliqué à la valeur du paramètre Entités de cours d’eau en entrée sauf si elle contient des lignes de courant qui ont été segmentées en différentes parties mais qui apartiennent au même segment de cours d’eau. Dans ce cas, elles sont fusionnées pour faire en sorte qu’un ID unique soit attribué à chaque segment de cours d’eau dans la sortie. Si les valeurs de champ attribuent un ID unique à chaque segment de cours d’eau, aucun regroupement n’est effectué.
Une représentation raster des lignes de courant ajustées peut être enregistrée en spécifiant la valeur du paramètre Raster de cours d’eau ajusté en sortie (out_stream_raster dans Python).
La valeur du paramètre facultatif Champ de regroupement (group_by_field dans Python) détermine les valeurs de cellule dans la valeur du paramètre Raster de cours d’eau ajusté en sortie.
La direction du flux de l’eau (D8) au niveau de chaque cellule des cours d’eau ajustés peut être enregistrée en spécifiant la valeur du paramètre Raster de direction de flux en sortie (out_flow_direction_raster dans Python).
Utilisez le paramètre Supprimer les angles aigus (remove_sharp_angles dans Python) pour faire en sorte qu’il n’existe aucune ligne dont la largeur est égale à une cellule et appartenant à des angles de 90 degrés dans la valeur du paramètre Entités de cours d’eau ajustées en sortie.
Si la valeur du paramètre Entités de cours d’eau en entrée (in_stream_features dans Python) est censée contenir des localisations où un cours d’eau de divise en deux et que l’un d’eux est considéré comme le canal principal, le canal principal peut être spécifié via le paramètre Champ de flux divergent ou de trajectoire suivante (divergent_flow_or_next_field dans Python). Dans ce cas, un champ nommé HydroID doit figurer dans la table attributaire de la valeur du paramètre Entités de cours d’eau en entrée (in_stream_features dans Python). Dans le cas d’un cours d’eau qui se divise en deux, le champ sélectionné doit pointer vers le champ HydroID du cours d’eau considéré comme le canal principal.
Le nombre maximal d’entités de cours d’eau pouvant être traitées par l’outil est 2 147 483 647 (2^31 - 1).
Par défaut, l’étendue de l’analyse est celle de la valeur du paramètre Entités de cours d’eau en entrée (in_stream_features dans Python).
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

Étiquette	Explication	Type de données
Entités de cours d’eau en entrée	Entités de lignes de courant qui sont ajustées pour correspondre à la résolution raster en entrée.	Feature Dataset
Raster en entrée	Raster en fonction duquel les entités de lignes de courant sont ajustées.	Raster Dataset
Entités de cours d’eau ajustées en sortie	Représentation irrégulière des entités de lignes de courant en entrée correspondant à la résolution du raster en entrée. Les entités de cours d’eau en sortie sont regroupées en fonction de la valeur du paramètre Champ de regroupement. Outre le champ éventuellement spécifié, la table attributaire contient également le champ suivant : StreamLink : ID attribué aux liaisons d’écoulement. Les liaisons sont des sections d’un canal d’écoulement reliant deux jonctions successives.	Feature Class
Champ de regroupement (Facultatif)	Champ contenant les valeurs utilisées pour regrouper les cours d’eau dans les valeurs des paramètres Entités de cours d’eau ajustées en sortie et Raster de cours d’eau ajusté en sortie. Les valeurs du champ doivent être entières.	Field
Supprimer les angles aigus (Facultatif)	Indique si les angles aigus doivent être supprimés des entités de cours d’eau en sortie. Les angles aigus sont représentés par des segments linéaires de 90 degrés dont la largeur est égale à une cellule. Activé : tous les segments linéaires qui répondent aux critères sont simplifiés et les angles aigus sont supprimés de la sortie. Il s’agit de l’option par défaut. Désactivé : aucun segment linéaire n’est modifié et les angles aigus ne sont pas supprimés de la sortie.	Boolean
Champ de flux divergent ou de trajectoire suivante (Facultatif)	Champ de la valeur du paramètre Entités de cours d’eau en entrée qui indique le canal principal après un fractionnement de l’écoulement. Le segment de cours d’eau qui correspond au canal principal doit être indiqué par un ID. L’ID doit être présent et répertorié dans un champ nommé HydroID.	Field
Raster de cours d’eau ajusté en sortie (Facultatif)	Version raster de la valeur du paramètre Entités de cours d’eau ajustées en sortie. Les valeurs de cellule correspondent aux valeurs du champ spécifiées dans la valeur du paramètre Champ de regroupement.	Raster Dataset
Raster de direction de flux en sortie (Facultatif)	Le raster stocke la direction de flux (D8) dans les cellules de cours d’eau qui correspondent à la direction numérisée des entités de cours d’eau.	Raster Dataset
Entités de points de fractionnement en sortie (Facultatif)	Localisations des fractionnements du flux et des nœuds de connectivité associés dans les entités de cours d’eau ajustées en sortie.	Feature Class

AdjustStreamToRaster(in_stream_features, in_raster, out_stream_features, {group_by_field}, {remove_sharp_angles}, {divergent_flow_or_next_field}, {out_stream_raster}, {out_flow_direction_raster}, {out_split_point_features})

Nom	Explication	Type de données
in_stream_features	Entités de lignes de courant qui sont ajustées pour correspondre à la résolution raster en entrée.	Feature Dataset
in_raster	Raster en fonction duquel les entités de lignes de courant sont ajustées.	Raster Dataset
out_stream_features	Représentation irrégulière des entités de lignes de courant en entrée correspondant à la résolution du raster en entrée. Les entités de cours d’eau en sortie sont regroupées en fonction de la valeur du paramètre group_by_field. Outre le champ éventuellement spécifié, la table attributaire contient également le champ suivant : StreamLink : ID attribué aux liaisons d’écoulement. Les liaisons sont des sections d’un canal d’écoulement reliant deux jonctions successives.	Feature Class
group_by_field (Facultatif)	Champ contenant les valeurs utilisées pour regrouper les cours d’eau dans les valeurs des paramètres out_stream_features et out_stream_raster. Les valeurs du champ doivent être entières.	Field
remove_sharp_angles (Facultatif)	Indique si les angles aigus doivent être supprimés des entités de cours d’eau en sortie. Les angles aigus sont représentés par des segments linéaires de 90 degrés dont la largeur est égale à une cellule. REMOVE—Tous les segments linéaires qui répondent aux critères sont simplifiés et les angles aigus sont supprimés de la sortie. Il s’agit de l’option par défaut. NO_REMOVE—Aucun segment linéaire n’est modifié et les angles aigus ne sont pas supprimés de la sortie.	Boolean
divergent_flow_or_next_field (Facultatif)	Champ de la valeur du paramètre in_stream_features qui indique le canal principal après un fractionnement de l’écoulement. Le segment de cours d’eau qui correspond au canal principal doit être indiqué par un ID. L’ID doit être présent et répertorié dans un champ nommé HydroID.	Field
out_stream_raster (Facultatif)	Version raster de la valeur du paramètre out_stream_features. Les valeurs de cellule correspondent aux valeurs du champ spécifiées dans la valeur du paramètre group_by_field.	Raster Dataset
out_flow_direction_raster (Facultatif)	Le raster stocke la direction de flux (D8) dans les cellules de cours d’eau qui correspondent à la direction numérisée des entités de cours d’eau.	Raster Dataset
out_split_point_features (Facultatif)	Localisations des fractionnements du flux et des nœuds de connectivité associés dans les entités de cours d’eau ajustées en sortie.	Feature Class

Exemple de code

Exemple 1 d’utilisation de la fonction AdjustStreamToRaster (fenêtre Python)

Cet exemple illustre l’utilisation de la fonction AdjustStreamToRaster pour générer des entités de lignes de courant sans angles aigus qui correspondent à la résolution d’un raster en entrée. Par défaut, la sortie n’est pas regroupée.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data.gdb"

AdjustStreamToRaster(in_stream_features="streams", 
                     in_raster="elevation", 
                     out_stream_features="out_stream_features", 
                     group_by_field="NONE",
                     remove_sharp_angles="REMOVE",
                     divergent_flow_or_next_field="NONE",
                     out_stream_raster="out_stream_raster",
                     out_flow_direction_raster="out_stream_flowdir_raster",
                     out_split_point_features=None
                     )

Exemple 2 d’utilisation de la fonction AdjustStreamToRaster (script autonome)

# Name: AdjustStreamToRaster_standalone.py
# Description: Adjust the input streams features to the resolution of the input raster. 
# No groupping specified, therefore, the result will have as many number of features as 
# there are stream segments.
# Requirements: Spatial Analyst Extension

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

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set local variables
InStreamFeatures="streams.shp"
InRaster = "elevation.tif"
OutStreamFeatures = "out_adjusted_streams.shp"
OutStreamRaster = "out_adjusted_streams.tif"
OutFlowDirRaster = "out_streams_fdr.tif"

# Execute the tool
AdjustStreamToRaster(InStreamFeatures, 
                     InRaster, 
                     OutStreamFeatures, 
                     "NONE", 
                     "", 
                     "NONE", 
                     OutStreamRaster, 
                     OutFlowDirRaster, 
                     "")

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 ?