Localizar depresiones (Herramientas de Spatial Analyst)

Resumen

Localiza áreas que son topográficamente más bajas que el terreno circundante según sus características espaciales.

Más información sobre cómo funciona Localizar depresiones

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 correspondiente a todas las depresiones incluidas en el valor del parámetro Polígonos de depresiones de salida.

También incluirá el punto de conexión aguas abajo de cada depresión si se especifica un valor para el parámetro Distancia máxima a conexión (max_connection_distance en Python).
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 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 incluye más detalles sobre 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 válidos para esta herramienta.

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: `AREA`—Área de la depresión en metros cuadrados. `VOLUME`—Volumen de la depresión en metros cúbicos. `DIST_CON`—Distancia al punto de conexión aguas abajo en metros. Este campo solo se creará si se especifica el valor del parámetro Distancia máxima a conexión. `DIST_ROAD`—Distancia a la carretera más cercana en metros. Este campo solo se crea si se especifica un dataset para el parámetro de datos de carreteras de entrada opcional.	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. El punto de conexión aguas abajo y los campos relacionados solo se incluyen en la salida si se especifica un valor para el parámetro Distancia máxima a conexió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: `DEP_ID`—Identificador de la depresión con la que está asociada el punto. `POINT_TYPE`—Especifica si el punto es el punto de elevación menor de la depresión (= 0) o el punto de conexión aguas abajo (= 1). `POINT_ELEV`—La elevación del punto. `DIST_EDGE`—Distancia al borde la depresión en metros. `DIST_POINT`—Distancia al punto correspondiente en metros.	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. Pulgada—La unidad lineal será pulgadas. Pie—La unidad lineal será pies. Pie de EE. UU.—La unidad lineal será pies de agrimensura de EE. UU. Yarda—La unidad lineal será yardas. Milla de EE. UU.—La unidad lineal será millas de agrimensura de EE. UU. Milla náutica—La unidad lineal será millas náuticas. Milímetro—La unidad lineal será milímetros. Centímetro—La unidad lineal será centímetros. Contador—La unidad lineal será metros. Kilómetro—La unidad lineal será kilómetros. Decímetro—La unidad lineal será decí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. Este parámetro solo se aplicará si se especifica un valor para él.	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

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: `AREA`—Área de la depresión en metros cuadrados. `VOLUME`—Volumen de la depresión en metros cúbicos. `DIST_CON`—Distancia al punto de conexión aguas abajo en metros. Este campo solo se creará si se especifica el valor del parámetro `max_connection_distance`. `DIST_ROAD`—Distancia a la carretera más cercana en metros. Este campo solo se crea si se especifica un dataset para el parámetro de datos de carreteras de entrada opcional.	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. El punto de conexión aguas abajo y los campos relacionados solo se incluyen en la salida si se especifica un valor para el parámetro `max_connection_distance`. 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: `DEP_ID`—Identificador de la depresión con la que está asociada el punto. `POINT_TYPE`—Especifica si el punto es el punto de elevación menor de la depresión (= 0) o el punto de conexión aguas abajo (= 1). `POINT_ELEV`—La elevación del punto. `DIST_EDGE`—Distancia al borde la depresión en metros. `DIST_POINT`—Distancia al punto correspondiente en metros.	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. `INCH`—La unidad lineal será pulgadas. `FOOT`—La unidad lineal será pies. `FOOT_US`—La unidad lineal será pies de agrimensura de EE. UU. `YARD`—La unidad lineal será yardas. `MILE_US`—La unidad lineal será millas de agrimensura de EE. UU. `NAUTICAL_MILE`—La unidad lineal será millas náuticas. `MILLIMETER`—La unidad lineal será milímetros. `CENTIMETER`—La unidad lineal será centímetros. `METER`—La unidad lineal será metros. `KILOMETER`—La unidad lineal será kilómetros. `DECIMETER`—La unidad lineal será decí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. Este parámetro solo se aplicará si se especifica un valor para él.	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

LocateDepressions ejemplo 1 (ventana de Python)

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", "", "", "", "", "")

LocateDepressions ejemplo 2 (script independiente)

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"

# 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")

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Espacio de trabajo actual, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Extensión, Factor de procesamiento en paralelo, Espacio de trabajo temporal, Alinear ráster

Información de licenciamiento

Basic: Requiere Spatial Analyst
Standard: Requiere Spatial Analyst
Avanzado: Requiere Spatial Analyst

Localizar depresiones (Herramientas de Spatial Analyst)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados