| Etiqueta | Explicación | Tipo de datos |
Ráster de superficie de entrada | Ráster de entrada de superficie. | Raster Layer |
Polígonos de depresión de salida | La clase de entidad de salida que contendrá las depresiones identificadas. Cada polígono de depresión tiene una numeración única. En los campos adicionales en la tabla de atributos se almacena información específica sobre la depresión. Dichos campos son los siguientes:
| Feature Class |
Ráster de entrada o Entidades de carretera (Opcional) | Ráster opcional o dataset de entidades que define las carreteras. Las carreteras pueden definirse mediante un ráster entero o de punto flotante, o mediante una entidad de punto, línea o polígono. | Raster Layer; Feature Layer |
Puntos de conexión de salida (Opcional) | Puntos de salida opcionales que definen el punto de elevación menor de una depresión y el punto de conexión aguas abajo correspondiente. La conexión aguas abajo se define como la celda más cercana de una elevación menor que la celda de elevación más baja de una depresión. Cada punto tiene una numeración única. En los campos adicionales en la tabla de atributos se almacena información específica sobre el punto. Dichos campos son los siguientes:
| Feature Class |
Profundidad mínima (Opcional) | Profundidad mínima permitida de una depresión. Las depresiones con una profundiad máxima menor que este valor no se incluirá en la salida final. El valor predeterminado es 0,05 metros o equivalente en la unidad z especificada. | Linear Unit |
Unidad z (Opcional) | Especifica la unidad lineal que se utilizará para los valores z verticales. Se define mediante un sistema de coordenadas verticales si existe. Si no existe ningún sistema de coordenadas verticales, defina la unidad z mediante la lista de unidades para garantizar el cómputo geodésico correcto. El valor predeterminado es metros.
| String |
Área mínima (Opcional) | Área mínima permitida de una depresión. El área es el área de la superficie de la parte superior de la depresión. Las depresiones con un área menor que este valor no se incluirán en la salida final. El valor predeterminado es el área total de tres celdas o el equivalente en unidades de mapa cuadradas de la referencia espacial del valor del parámetro Ráster de superficie de entrada. | Areal Unit |
Distancia máxima a conexión (Opcional) | Distancia máxima permitida desde el borde una depresión hasta el punto de conexión aguas abajo. La conexión aguas abajo se define como la celda más cercana de una elevación menor que la celda de elevación más baja de la depresión. Si la distancia a una conexión aguas abajo es mayor que este valor, la depresión no se incluirá en la salida final. El valor predeterminado es 30 metros o el equivalente en la unidad de mapa de la referencia espacial del valor del parámetro Ráster de superficie de entrada. | Linear Unit |
Distancia máxima a carreteras (Opcional) | Distancia máxima permitida desde el borde una depresión hasta la carretera más cercana. Si la distancia de una depresión con respecto una carretera es mayor que este valor, no se incluirá en la salida final. El parámetro solo está disponible si se proporciona un valor en el parámetro Ráster de entrada o entidades de carreteras. El valor predeterminado es 30 metros o el equivalente en la unidad de mapa de la referencia espacial del valor del parámetro Ráster de superficie de entrada. | Linear Unit |
Disponible con una licencia de Spatial Analyst.
Resumen
Localiza áreas que son topográficamente más bajas que el terreno circundante según sus características espaciales.
Uso
El valor del parámetro Ráster de superficie de entrada (in_surface_raster en Python) puede ser un modelo digital de elevación (DEM). Las depresiones se identifican internamente basándose en la diferencia entre el DEM relleno y el original.
Solo las depresiones que cumplan todos los requisitos definidos por los parámetros de análisis opcionales se incluirán en el valor del parámetro Polígonos de depresiones de salida (out_depressions_polygons en Python).
El valor del parámetro Puntos de conexión de salida (out_connection_points en Python) incluye el punto de la elevación menor de una depresión y el punto de conexión aguas abajo, correspondiente a todas las depresiones incluidas en el valor del parámetro Polígonos de depresiones de salida.
Al especificar el valor del parámetro Unidad Z (z_unit en Python) garantiza el cálculo adecuado de la profundidad de la depresión.
Si hay una unidad z disponible en el sistema de coordenadas verticales del ráster de superficie de entrada, se aplicará automáticamente. Se recomienda definir una unidad z para el ráster de entrada si falta esta unidad. Puede usar la herramienta Definir proyección para especificar una unidad z. Si no se especifica ningún valor, el metro se utilizará de forma predeterminada.
El parámetro Distancia máxima a conexión (max_connection_distance en Python) considerará que la conexión aguas abajo será la celda más próxima encontrada que sea de una elevación menor que la celda con elevación mejor en la depresión. Cuando haya varias celdas que cumplan estos criterios, se devolverá la primera que se encuentre.
El parámetro Distancia máxima a carreteras (max_road_distance en Python) solo puede aplicarse si se especifica el parámetro Ráster de entrada o carreteras de entidades (in_road_data en Python).
La unidad de mapa de la referencia espacial del valor del parámetro Ráster de superficie de entrada se utiliza para rellenar las unidades predeterminadas de los parámetros Área mínima, Distancia máxima a conexión y Distancia máxima a carreteras. Si la unidad identificada por el valor del parámetro Ráster de superficie de entrada no coincide con la unidad de área y la unidad lineal disponibles, los parámetros se ajustarán de forma predeterminada en Metros cuadrados y Metros, respectivamente.
Esta herramienta admite el procesamiento en paralelo. Si su equipo tiene varios procesadores o procesadores con varios núcleos, puede conseguir un mayor rendimiento, especialmente en los datasets mayores. El tema de ayuda Procesamiento en paralelo con Spatial Analyst contiene detalles acerca de esta posibilidad y cómo configurarla.
De forma predeterminada, esta herramienta usará hasta el 50 por ciento de los núcleos disponibles. Es posible controlar el número de núcleos empleados por la herramienta, a través de la configuración de entorno de Factor de procesamiento en paralelo.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Parámetros
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})| Nombre | Explicación | Tipo de datos |
in_surface_raster | Ráster de entrada de superficie. | Raster Layer |
out_depressions_polygons | La clase de entidad de salida que contendrá las depresiones identificadas. Cada polígono de depresión tiene una numeración única. En los campos adicionales en la tabla de atributos se almacena información específica sobre la depresión. Dichos campos son los siguientes:
| Feature Class |
in_road_data (Opcional) | Ráster opcional o dataset de entidades que define las carreteras. Las carreteras pueden definirse mediante un ráster entero o de punto flotante, o mediante una entidad de punto, línea o polígono. | Raster Layer; Feature Layer |
out_connection_points (Opcional) | Puntos de salida opcionales que definen el punto de elevación menor de una depresión y el punto de conexión aguas abajo correspondiente. La conexión aguas abajo se define como la celda más cercana de una elevación menor que la celda de elevación más baja de una depresión. Cada punto tiene una numeración única. En los campos adicionales en la tabla de atributos se almacena información específica sobre el punto. Dichos campos son los siguientes:
| Feature Class |
min_depth (Opcional) | Profundidad mínima permitida de una depresión. Las depresiones con una profundiad máxima menor que este valor no se incluirá en la salida final. El valor predeterminado es 0,05 metros o equivalente en la unidad z especificada. | Linear Unit |
z_unit (Opcional) | Especifica la unidad lineal que se utilizará para los valores z verticales. Se define mediante un sistema de coordenadas verticales si existe. Si no existe ningún sistema de coordenadas verticales, defina la unidad z mediante la lista de unidades para garantizar el cómputo geodésico correcto. El valor predeterminado es metros.
| String |
min_area (Opcional) | Área mínima permitida de una depresión. El área es el área de la superficie de la parte superior de la depresión. Las depresiones con un área menor que este valor no se incluirán en la salida final. El valor predeterminado es el área total de tres celdas o el equivalente en unidades de mapa cuadradas de la referencia espacial del valor del parámetro in_surface_raster. | Areal Unit |
max_connection_distance (Opcional) | Distancia máxima permitida desde el borde una depresión hasta el punto de conexión aguas abajo. La conexión aguas abajo se define como la celda más cercana de una elevación menor que la celda de elevación más baja de la depresión. Si la distancia a una conexión aguas abajo es mayor que este valor, la depresión no se incluirá en la salida final. El valor predeterminado es 30 metros o el equivalente en la unidad de mapa de la referencia espacial del valor del parámetro in_surface_raster. | Linear Unit |
max_road_distance (Opcional) | Distancia máxima permitida desde el borde una depresión hasta la carretera más cercana. Si la distancia de una depresión con respecto una carretera es mayor que este valor, no se incluirá en la salida final. El parámetro solo está disponible si se ha proporcionado un valor para el parámetro in_road_data. El valor predeterminado es 30 metros o el equivalente en la unidad de mapa de la referencia espacial del valor del parámetro in_surface_raster. | Linear Unit |
Muestra de código
En este ejemplo, se muestra cómo utilizar Locate Depressions para localizar depresiones desde un ráster de superficie de entrada sin necesidad de rellenar de antemano los sumideros.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data.gdb"
outDepressions = LocateDepressions("elevation", "outdepressions01.shp", "",
"outpoints01.shp", "", "", "", "", "")En este ejemplo, se localizan depresiones desde una superficie de entrada sin necesidad de rellenar de antemano los sumideros o depresiones reales.
# 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")Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst