Generar líneas de ruptura (Herramientas de Spatial Analyst)

Resumen

Crea líneas que se utilizan para romper impedimentos locales del flujo de agua.

Uso

Una depresión es una zona topográficamente más baja que el terreno circundante y que interrumpe el flujo de agua. La herramienta Generar líneas de ruptura busca una línea de ruptura que conecte la depresión con un punto situado aguas abajo, garantizando así la conectividad hidrológica.
El valor del parámetro Líneas de ruptura de salida representa las líneas que atraviesan cada polígono de depresión, garantizando así la conectividad hidrológica. El valor del parámetro Polígonos de depresión de entrada (in_depression_polygons en Python) representa cada polígono de depresión que se va a atravesar.
El valor del parámetro Puntos de conexión de entrada (in_connection_points en Python) representa los puntos inicial y final que unirá la línea de ruptura. Es posible crearlo utilizando la herramienta Localizar depresiones.
Se espera que la capa de entidades Puntos de conexión de entrada tenga dos campos. El primer campo, DEP_ID, es el Id. de la depresión a la que pertenece ese punto. El campo binario POINT_TYPE indica si el punto marca el inicio (valor 0) o el final (valor 1) de la línea que se va a generar.
Las líneas de ruptura de la capa de entidades de salida siempre comienzan en un punto situado dentro de la depresión y terminan en una celda con una elevación más baja, para garantizar el flujo del agua. La herramienta no crea líneas que cubran parcialmente esta ruta. En otras palabras, no se crean líneas parciales ni incompletas.
Para cada polígono de depresión, la línea de ruptura resultante comienza en el punto de menor elevación dentro de la depresión. El final de la línea depende del valor especificado para el parámetro Método de trazado (trace_method en Python).
Cuando se selecciona la opción Ruta más corta (SHORTEST_PATH en Python) como valor del parámetro Método de trazado, es necesario que tanto el punto de inicio como el de destino figuren en el valor del parámetro Puntos de conexión de entrada para cada depresión.
Cuando se especifica la opción Coste de ruptura mínimo de ruptura (MIN_BREACHING_COST en Python) en Método de trazado, la línea de ruptura resultante representa la ruta que minimiza el coste de ruptura de la ruta, según Lindsay y Dhun (2015). El coste de la excavación equivale a la cantidad de elevación que hay que rebajar o excavar para crear un canal que conecte la depresión con otra ubicación de menor elevación, con el fin de garantizar el flujo del agua.
Si se especifica el ajuste de entorno Máscara, la herramienta generará una línea de corte solo si el punto inicial (dentro de la depresión) se encuentra dentro del área de la máscara. Es posible que el área de la depresión esté total o parcialmente dentro del área de la máscara.
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
Polígonos de depresión de entrada	La capa de entidades de entrada que contiene polígonos que definen zonas de depresión. Una depresión es una zona topográficamente más baja que el terreno circundante y que interrumpe el flujo de agua.	Feature Layer
Ráster de superficie de entrada	Ráster de entrada de superficie.	Raster Layer
Líneas de ruptura de salida	La clase de entidad de salida que contendrá una línea que conecta las depresiones con una celda aguas abajo y garantiza la conectividad hidrológica. Cada línea 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: `LENGTH`—La longitud de la línea de ruptura en metros. `DEP_ID`—El identificador de la depresión con la que está asociada la línea. `START_X`—La coordenada X del inicio de la línea de ruptura. `START_Y`—La coordenada Y del inicio de la línea de ruptura. `END_X`—La coordenada X del final de la línea de ruptura. `END_Y`—La coordenada Y del final de la línea de ruptura. Los valores de los cuatro campos de coordenadas se encuentran en la referencia espacial de salida.	Feature Class
Puntos de conexión de entrada (Opcional)	Los puntos de entrada opcionales que definen el punto de elevación menor de una depresión y el punto de conexión aguas abajo correspondiente. Esta entrada es obligatoria cuando se especifica Ruta más corta para el valor del parámetro Método de trazado. Los campos esperados en la tabla de atributos son: `DEP_ID`—Identificador de la depresión con la que está asociado el punto. `POINT_TYPE`—Un campo booleano donde el valor 0 especifica que el punto es el punto de elevación menor de la depresión y el valor 1 especifica que es un punto de conexión aguas abajo.	Feature Layer
Método de trazado (Opcional)	Especifica el método utilizado para crear la línea de ruptura. Los métodos disponibles son los siguientes: Coste de ruptura mínimo—La línea seguirá una ruta que minimice el coste de ruptura. Esta es la opción predeterminada. Ruta más corta—La ruta con la distancia más corta entre el punto de inicio y el punto final. Requiere que tanto el punto de inicio como el punto final estén presentes en el valor del parámetro Puntos de conexión de entrada. La ruta será la línea más corta que rompa el impedimento local del flujo de agua. Cambio de elevación mínimo—La línea seguirá una ruta que minimice el cambio de elevación.	String
Longitud máxima (Opcional)	La longitud máxima permitida para una línea de ruptura. Si una posible línea de ruptura supera este límite, dicha línea no se incluirá en la clase de entidad de líneas de ruptura de salida. El valor predeterminado es de 50 metros o su equivalente en las unidades de mapa de la referencia espacial de análisis.	Linear Unit

GenerateBreachLines(in_depression_polygons, in_surface_raster, out_breach_lines, {in_connection_points}, {trace_method}, {max_length})

Nombre	Explicación	Tipo de datos
in_depression_polygons	La capa de entidades de entrada que contiene polígonos que definen zonas de depresión. Una depresión es una zona topográficamente más baja que el terreno circundante y que interrumpe el flujo de agua.	Feature Layer
in_surface_raster	Ráster de entrada de superficie.	Raster Layer
out_breach_lines	La clase de entidad de salida que contendrá una línea que conecta las depresiones con una celda aguas abajo y garantiza la conectividad hidrológica. Cada línea 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: `LENGTH`—La longitud de la línea de ruptura en metros. `DEP_ID`—El identificador de la depresión con la que está asociada la línea. `START_X`—La coordenada X del inicio de la línea de ruptura. `START_Y`—La coordenada Y del inicio de la línea de ruptura. `END_X`—La coordenada X del final de la línea de ruptura. `END_Y`—La coordenada Y del final de la línea de ruptura. Los valores de los cuatro campos de coordenadas se encuentran en la referencia espacial de salida.	Feature Class
in_connection_points (Opcional)	Los puntos de entrada opcionales que definen el punto de elevación menor de una depresión y el punto de conexión aguas abajo correspondiente. Esta entrada es obligatoria cuando se especifica `SHORTEST_PATH` para el valor del parámetro `trace_method`. Los campos esperados en la tabla de atributos son los siguientes: `DEP_ID`—Identificador de la depresión con la que está asociada el punto. `POINT_TYPE`—Un campo booleano donde el valor 0 especifica que el punto es el punto de elevación menor de la depresión y el valor 1 especifica que es un punto de conexión aguas abajo.	Feature Layer
trace_method (Opcional)	Especifica el método utilizado para crear la línea de ruptura. Los métodos disponibles son los siguientes: `MIN_BREACHING_COST`—La línea seguirá una ruta que minimice el coste de ruptura. Esta es la opción predeterminada. `SHORTEST_PATH`—La ruta con la distancia más corta entre el inicio y el final. Requiere que tanto el punto de inicio como el punto final estén presentes en el valor del parámetro `in_connection_points`. La ruta será la línea más corta que rompa el impedimento local del flujo de agua. `MIN_ELEV`—La línea seguirá una ruta que minimice el cambio de elevación.	String
max_length (Opcional)	La longitud máxima permitida para una línea de ruptura. Si una posible línea de ruptura supera este límite, dicha línea no se incluirá en la clase de entidad de líneas de ruptura de salida. El valor predeterminado es de 50 metros o su equivalente en las unidades de mapa de la referencia espacial de análisis.	Linear Unit

Muestra de código

GenerateBreachLines ejemplo 1 (ventana de Python)

En el siguiente ejemplo se muestra cómo usar esta herramienta en la ventana de Python. Este ejemplo genera la línea de menor distancia que atraviesa el polígono de depresión, uniendo los puntos de conexión inicial y final con los valores predeterminados de los parámetros.

from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapy/examples/data"
GenerateBreachLines("inputDepressionPolygons.shp", "inputSurfaceRaster.tif", "C:/sapyexamples/output/streams.shp", "", "", "", "")

GenerateBreachLines ejemplo 2 (script independiente)

Este ejemplo genera las líneas que atraviesan el polígono de depresión con una longitud máxima de 50 metros y que siguen la ruta de menor elevación.

# Name: GenerateBreachLines_standalone.py
# Description: Generates lines that breach depression polygons following the 
#              minimum elevation path and a maximum length of 50 meters.
# Requirements: Spatial Analyst extension

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

# Set the analysis environments
env.workspace = "C:/sapyexamples/data"

# Set the local variables
in_depression_polygons = "depressions.shp",
in_surface_raster = "inSurfaceRaster.tif"
out_breach_lines = "C:/sapyexamples/output/breachlines.shp"
in_connection_points= None
trace_method = "MIN_BREACHING_COST"
max_length = "50 Meters"


# Run Generate Breach Lines
GenerateBreachLines(in_depression_polygons, 
                    in_surface_raster,
                    out_breach_lines,
                    in_connection_points,
                    trace_method,
                    max_length)

Entornos

Extensión, Máscara, Auto ejecución, Espacio de trabajo actual, Valor Z de salida predeterminado, Transformaciones geográficas, Resolución M, Tolerancia M, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, La salida tiene valores M, La salida tiene valores Z, Dominio M de salida, Dominio XY de salida, Dominio Z de salida, Espacio de trabajo temporal, Resolución XY, Tolerancia XY, Resolución Z, Tolerancia Z

Información de licenciamiento

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

Referencias

"Lindsay J, Dhun K. 2015. Modelling surface drainage patterns in altered landscapes using LiDAR. International Journal of Geographical Information Science, 29: 1-15. DOI: 10.1080/13658816.2014.975715"