Localiser les dépressions (Outils Spatial Analyst)

Résumé

Localise les zones qui sont plus basses d’un point de vue topographique que le terrain environnant, en fonction de caractéristiques spatiales.

En savoir plus sur le fonctionnement de l’outil Locate Depressions (Localiser les dépressions)

Utilisation

La valeur du paramètre Input Surface Raster (Raster de surface en entrée) (in_surface_raster dans Python) peut être un modèle numérique d’élévation (MNE). En interne, les dépressions sont identifiées en fonction de la différence entre le MNE rempli et celui d’origine.
Seules les dépressions répondant à toutes les conditions requises définies par les paramètres d’analyse facultatifs sont incluses dans la valeur du paramètre Output Depressions Polygons (Polygones de dépressions en sortie) (out_depressions_polygons dans Python).
La valeur du paramètre Output Connection Points (Points de connexion en sortie) (out_connection_points dans Python) inclut le point d’élévation le plus bas dans une dépression pour toutes les dépressions incluses dans la valeur du paramètre Output Depressions Polygons (Polygones de dépressions en sortie).

Il inclura également le point de connexion en aval pour chaque dépression si une valeur est spécifiée pour le paramètre Maximum Distance to Connection (Distance maximale par rapport à la connexion) (max_connection_distance dans Python).
Spécifier la valeur du paramètre Z Unit (Unité Z) (z_unit dans Python) garantit le calcul correct de la profondeur de la dépression.

Si une unité z est disponible dans le système de coordonnées verticales du raster de surface en entrée, elle est automatiquement appliquée. Il est recommandé de définir une unité z pour le raster en entrée s’il n’en existe pas. Vous pouvez utiliser l’outil Define Projection (Définir une projection) pour spécifier une unité z. Si aucune valeur n’est spécifiée, le mètre est utilisé par défaut.
Le paramètre Maximum Distance to Connection (Distance maximale par rapport à la connexion) considère la connexion en aval comme la cellule la plus proche détectée qui est d’une élévation inférieure à la cellule d’élévation la plus basse dans la dépression. Si plusieurs cellules répondent à ces critères, la première occurrence trouvée est renvoyée.
Le paramètre Maximum Distance to Roads (Distance maximale par rapport aux routes) (max_road_distance dans Python) s’applique uniquement si le paramètre Input Raster or Feature Roads (Raster ou entités route en entrée) (in_road_data dans Python) est spécifié.
L’unité cartographique de la référence spatiale de la valeur du paramètre Input Surface Raster (Raster de surface en entrée) est utilisée pour renseigner les unités par défaut des paramètres Minimum Area (Superficie minimale), Maximum Distance to Connection (Distance maximale par rapport à la connexion) et Maximum Distance to Roads (Distance maximale par rapport aux routes). Si l’unité identifiée par la valeur du paramètre Input Surface Raster (Raster de surface en entrée) ne correspond pas à la fois à une unité surfacique et à une unité linéaire disponibles, les valeurs par défaut des paramètres seront respectivement Square Meters (Mètres carrés) et Meters (Mètres).
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. La rubrique d’aide Traitement parallèle avec Spatial Analyst comporte des informations concernant cette fonctionnalité et sa configuration.

Par défaut, cet outil utilise jusqu’à 50 pourcent des cœurs disponibles. Vous pouvez contrôler le nombre de cœurs que l’outil utilise à l’aide de l’environnement Facteur de traitement parallèle.
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
Raster de surface en entrée	Raster de surface en entrée.	Raster Layer
Polygones de dépressions en sortie	Classe d’entités en sortie qui contient les dépressions identifiées. Chaque polygone de dépression est numéroté de manière unique. Les champs supplémentaires dans la table attributaire stockent des informations spécifiques concernant la dépression. Ces champs sont les suivants : `AREA`—La superficie de la dépression en mètres carrés. `VOLUME`—Le volume de la dépression en mètres cubes. `DIST_CON`—La distance par rapport au point de connexion en aval en mètres. Ce champ sera créé uniquement si la valeur du paramètre Maximum Distance to Connection (Distance maximale par rapport à la connexion) est spécifiée. `DIST_ROAD`—La distance par rapport à la route la plus proche en mètres. Ce champ est uniquement créé si un jeu de données est spécifié pour le paramètre facultatif des données de route en entrée.	Feature Class
Raster ou entités route en entrée (Facultatif)	Jeu de classes d’entités ou raster facultatif qui définit des routes. Les routes 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
Points de connexion en sortie (Facultatif)	Points en sortie facultatifs qui définissent le point d’élévation le plus bas dans une dépression et le point de connexion en aval correspondant. Une connexion en aval est définie comme la cellule la plus proche d’une élévation inférieure à la cellule d’élévation la plus basse dans une dépression. Le point de connexion en aval et les champs associés sont inclus dans la sortie uniquement si une valeur est spécifiée pour le paramètre Maximum Distance to Connection (Distance Maximale par rapport à la connexion). Chaque point est numéroté 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 : `DEP_ID`—L’identifiant de la dépression à laquelle le point est associé. `POINT_TYPE`—Indique si le point est le point d’élévation le plus bas dans la dépression (= 0) ou le point de connexion en aval (= 1). `POINT_ELEV`—L’élévation du point. `DIST_EDGE`—La distance par rapport au bord de la dépression en mètres. `DIST_POINT`—La distance par rapport au point correspondant en mètres.	Feature Class
Profondeur minimale (Facultatif)	Profondeur minimale autorisée pour une dépression. Les dépressions qui présentent une profondeur maximale inférieure à cette valeur ne sont pas incluses dans la sortie finale. La valeur par défaut est 0,05 mètres ou l’équivalent dans l’unité z spécifiée.	Linear Unit
Unité Z (Facultatif)	Spécifie l’unité linéaire utilisée pour des valeurs z verticales. Elle est définie par un système de coordonnées verticales s'il en existe un. En l’absence d’un système de coordonnées verticales, définissez l’unité z à l’aide de la liste d’unités pour garantir un calcul géodésique correct. L’unité par défaut est le mètre. Pouce—L’unité linéaire est spécifiée en pouces. Pied—L’unité linéaire est spécifiée en pieds. Pied américain—L’unité linéaire est le pied d’arpentage américain. Yard—L’unité linéaire est spécifiée en yards. Mile américain—L’unité linéaire est le mile d’arpentage américain. Mille nautique—L’unité linéaire est spécifiée en milles nautiques. Millimètre—L’unité linéaire est spécifiée en millimètres. Centimètre—L’unité linéaire est spécifiée en centimètres. Mètre—L’unité linéaire est spécifiée en mètres. Kilomètre—L’unité linéaire est spécifiée en kilomètres. Décimètre—L’unité linéaire est spécifiée en décimètres.	String
Superficie minimale (Facultatif)	Superficie minimale autorisée pour une dépression. La superficie est la superficie de la surface en haut de la dépression. Les dépressions qui présentent une superficie inférieure à cette valeur ne sont pas incluses dans la sortie finale. La valeur par défaut est la superficie totale de 3 cellules ou l’équivalent en unités cartographiques carrées de la référence spatiale pour la valeur du paramètre Input Surface Raster (Raster de surface en entrée).	Areal Unit
Distance maximale par rapport à la connexion (Facultatif)	Distance maximale autorisée entre le bord d’une dépression et le point de connexion en aval. Une connexion en aval est définie comme la cellule la plus proche d’une élévation inférieure à la cellule d’élévation la plus basse dans la dépression. Si la distance par rapport à une connexion en aval est supérieure à cette valeur, la dépression n’est pas incluse dans la sortie finale. Ce paramètre s’applique uniquement si une valeur lui est attribuée.	Linear Unit
Distance maximale par rapport aux routes (Facultatif)	Distance maximale autorisée entre le bord d’une dépression et la route la plus proche. Si la distance d’une dépression à partir d’une route est supérieure à cette valeur, elle n’est pas incluse dans la sortie finale. Le paramètre est uniquement disponible si une valeur est indiquée pour le paramètre Input Raster or Feature Roads (Raster ou entités route en entrée). La valeur par défaut est 30 mètres ou l’équivalent en unité cartographique de la référence spatiale pour la valeur du paramètre Input Surface Raster (Raster de surface en entrée).	Linear Unit

LocateDepressions(in_surface_raster, out_depressions_polygons, {in_road_data}, {out_connection_points}, {min_depth}, {z_unit}, {min_area}, {max_connection_distance}, {max_road_distance})

Nom	Explication	Type de données
in_surface_raster	Raster de surface en entrée.	Raster Layer
out_depressions_polygons	Classe d’entités en sortie qui contient les dépressions identifiées. Chaque polygone de dépression est numéroté de manière unique. Les champs supplémentaires dans la table attributaire stockent des informations spécifiques concernant la dépression. Ces champs sont les suivants : `AREA`—La superficie de la dépression en mètres carrés. `VOLUME`—Le volume de la dépression en mètres cubes. `DIST_CON`—La distance par rapport au point de connexion en aval en mètres. Ce champ sera créé uniquement si la valeur du paramètre `max_connection_distance` est spécifiée. `DIST_ROAD`—La distance par rapport à la route la plus proche en mètres. Ce champ est uniquement créé si un jeu de données est spécifié pour le paramètre facultatif des données de route en entrée.	Feature Class
in_road_data (Facultatif)	Jeu de classes d’entités ou raster facultatif qui définit des routes. Les routes 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
out_connection_points (Facultatif)	Points en sortie facultatifs qui définissent le point d’élévation le plus bas dans une dépression et le point de connexion en aval correspondant. Une connexion en aval est définie comme la cellule la plus proche d’une élévation inférieure à la cellule d’élévation la plus basse dans une dépression. Le point de connexion en aval et les champs associés sont inclus dans la sortie uniquement si une valeur est spécifiée pour le paramètre `max_connection_distance`. Chaque point est numéroté 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 : `DEP_ID`—L’identifiant de la dépression à laquelle le point est associé. `POINT_TYPE`—Indique si le point est le point d’élévation le plus bas dans la dépression (= 0) ou le point de connexion en aval (= 1). `POINT_ELEV`—L’élévation du point. `DIST_EDGE`—La distance par rapport au bord de la dépression en mètres. `DIST_POINT`—La distance par rapport au point correspondant en mètres.	Feature Class
min_depth (Facultatif)	Profondeur minimale autorisée pour une dépression. Les dépressions qui présentent une profondeur maximale inférieure à cette valeur ne sont pas incluses dans la sortie finale. La valeur par défaut est 0,05 mètres ou l’équivalent dans l’unité z spécifiée.	Linear Unit
z_unit (Facultatif)	Spécifie l’unité linéaire utilisée pour des valeurs z verticales. Elle est définie par un système de coordonnées verticales s'il en existe un. En l’absence d’un système de coordonnées verticales, définissez l’unité z à l’aide de la liste d’unités pour garantir un calcul géodésique correct. L’unité par défaut est le mètre. `INCH`—L’unité linéaire est spécifiée en pouces. `FOOT`—L’unité linéaire est spécifiée en pieds. `FOOT_US`—L’unité linéaire est le pied d’arpentage américain. `YARD`—L’unité linéaire est spécifiée en yards. `MILE_US`—L’unité linéaire est le mile d’arpentage américain. `NAUTICAL_MILE`—L’unité linéaire est spécifiée en milles nautiques. `MILLIMETER`—L’unité linéaire est spécifiée en millimètres. `CENTIMETER`—L’unité linéaire est spécifiée en centimètres. `METER`—L’unité linéaire est spécifiée en mètres. `KILOMETER`—L’unité linéaire est spécifiée en kilomètres. `DECIMETER`—L’unité linéaire est spécifiée en décimètres.	String
min_area (Facultatif)	Superficie minimale autorisée pour une dépression. La superficie est la superficie de la surface en haut de la dépression. Les dépressions qui présentent une superficie inférieure à cette valeur ne sont pas incluses dans la sortie finale. La valeur par défaut est la superficie totale de 3 cellules ou l’équivalent en unités cartographiques carrées de la référence spatiale pour la valeur du paramètre `in_surface_raster`.	Areal Unit
max_connection_distance (Facultatif)	Distance maximale autorisée entre le bord d’une dépression et le point de connexion en aval. Une connexion en aval est définie comme la cellule la plus proche d’une élévation inférieure à la cellule d’élévation la plus basse dans la dépression. Si la distance par rapport à une connexion en aval est supérieure à cette valeur, la dépression n’est pas incluse dans la sortie finale. Ce paramètre s’applique uniquement si une valeur lui est attribuée.	Linear Unit
max_road_distance (Facultatif)	Distance maximale autorisée entre le bord d’une dépression et la route la plus proche. Si la distance d’une dépression à partir d’une route est supérieure à cette valeur, elle n’est pas incluse dans la sortie finale. Le paramètre est uniquement disponible si une valeur est indiquée pour le paramètre `in_road_data`. La valeur par défaut est 30 mètres ou l’équivalent en unité cartographique de la référence spatiale pour la valeur du paramètre `in_surface_raster`.	Linear Unit

Exemple de code

LocateDepressions Exemple 1 (fenêtre Python)

Cet exemple illustre l’utilisation de la fonctionLocate Depressions pour localiser des dépressions à partir d’un raster de surface en entrée sans remplissage préalable d’une cuvette.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data.gdb"
outDepressions = LocateDepressions("elevation", "outdepressions01.shp", "",
                                    "outpoints01.shp", "", "", "", "", "")

LocateDepressions Exemple 2 (script autonome)

Cet exemple localise des dépressions à partir d’une surface en entrée sans remplissage préalable d’une cuvette et dépression réelle.

# Name: LocateDepressions_standalone.py
# Description: Locates depressions that meet the specified criteria.
# Requirements: Spatial Analyst extension

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

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

# Set local variables
inRaster = "elevation.tif"
inRoadData = "roads.tif"
inMinDepth = "2 Meters"
inZUnit = "METERS"
inMinArea = "5 SquareMeters"
inMaxConnectionDist = "40 Meters"
inMaxRoadDist = "20 Meters"

# Run the tool
outDepressions = LocateDepressions(inRaster, "", inRoadData, "", inMinDepth,
                                    inZUnit, inMinArea, inMaxConnectionDist,
                                    inMaxRoadDist)

# Save the output
outDepressions.save("C:/sapyexamples/output.gdb/outdepressions02")

Environnements

Validation automatique, Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Espace de travail courant, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Etendue, Facteur de traitement parallèle, Espace de travail temporaire, Raster de capture

Informations de licence