| Étiquette | 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 :
| 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. 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 :
| 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 qui sera utilisée pour les 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. Le mètre est la valeur par défaut.
| 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 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. 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 Raster de surface en entré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 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 Raster de surface en entrée. | Linear Unit |
Disponible avec une licence Spatial Analyst.
Synthèse
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 Localiser les dépressions
Utilisation
La valeur du paramètre Raster de surface en entrée (in_surface_raster en 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 Polygones de dépressions en sortie (out_depressions_polygons dans Python).
La valeur du paramètre Points de connexion en sortie (out_connection_points en Python) inclut le point d’élévation le plus bas dans une dépression, ainsi que le point de connexion en aval, pour toutes les dépressions incluses dans la valeur du paramètre Polygones de dépressions en sortie.
Spécifier la valeur du paramètre Unité Z (z_unit en Python) permet de s’assurer de la conformité du calcul 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 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 Distance maximale par rapport à la connexion (max_connection_distance en Python) 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 Distance maximale par rapport aux routes (max_road_distance en Python) s’applique uniquement si le paramètre Raster ou entités route en entrée (in_road_data en Python) est spécifié.
L’unité cartographique de la référence spatiale de la valeur du paramètre Raster de surface en entrée est utilisée pour renseigner les unités par défaut pour les paramètres Superficie minimale, Distance maximale par rapport à la connexion et Distance maximale par rapport aux routes. Si l’unité identifiée par la valeur du paramètre 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 Mètres carrés et 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. Pour plus d’informations concernant cette fonctionnalité et sa configuration, consultez la rubrique d’aide Traitement parallèle avec Spatial Analyst.
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.
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
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 :
| 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. 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 :
| 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 qui sera utilisée pour les 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. Le mètre est la valeur par défaut.
| 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. 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 |
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
Cet exemple illustre l’utilisation de l’outil Locate 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", "", "", "", "", "")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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set local variables
inRaster = "elevation.tif"
inRoadData = "roads.tif"
inMinDepth = "2 Meters"
inZUnit = "METERS"
inMinArea = "5 SquareMeters"
inMaxConnectionDist = "40 Meters"
inMaxRoadDist = "20 Meters"
# Execute the tool
outDepressions = LocateDepressions(inRaster, "", inRoadData, "", inMinDepth,
inZUnit, inMinArea, inMaxConnectionDist,
inMaxRoadDist)
# Save the output
outDepressions.save("C:/sapyexamples/output.gdb/outdepressions02")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 ?