Disponible con una licencia de Spatial Analyst.
Resumen
Crea un ráster que delinea todas las cuencas de drenaje.
Uso
Las cuencas de drenaje se delinean dentro de la ventana de análisis mediante la identificación de líneas de cresta entre cuencas. Se analiza el ráster de dirección de flujo de entrada para encontrar todos los conjuntos de celdas conectadas que pertenecen a la misma cuenca de drenaje. Las cuencas de drenaje se crean ubicando los puntos de fluidez en los bordes de la ventana de análisis (desde donde manaría el agua del ráster) y también los sumideros, e identificando después el área de contribución sobre cada punto de fluidez. Esto da como resultado un ráster de cuencas de drenaje.
Para crear el ráster de dirección de flujo de entrada D8, se debe ejecutar la herramienta Dirección de flujo con el tipo de dirección de flujo predeterminado D8.
Los mejores resultados se obtendrán si cuando se creó el ráster Dirección de flujo de entrada D8, la opción Forzar todas las celdas de eje para que se desplacen hacia fuera (FORCE en Python) estaba habilitada.
Todas las celdas en el ráster pertenecerán a la cuenca, incluso si esa cuenca es de una sola celda.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Sintaxis
Basin(in_flow_direction_raster)
Parámetro | Explicación | Tipo de datos |
in_flow_direction_raster | Ráster de entrada que muestra la dirección del flujo de cada celda. Puede crear un ráster de dirección de flujo con la herramienta Dirección de flujo, utilizando el tipo de dirección de flujo predeterminado D8. | Raster Layer |
Valor de retorno
Nombre | Explicación | Tipo de datos |
out_raster | El ráster de salida que delinea las cuencas de drenaje. Esta salida es siempre de tipo entero. | Raster |
Muestra de código
Ejemplo 1 de Cuenca (ventana de Python)
Este ejemplo determina las cuencas de drenaje de un ráster de cuadrícula de dirección de flujo de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outBasin = Basin("flowdir")
outBasin.save("C:/sapyexamples/output/outbasin01")
Ejemplo 2 de Cuenca (script independiente)
Este ejemplo determina las cuencas de drenaje de un ráster de cuadrícula de dirección de flujo de entrada.
# Name: Basin_Ex_02.py
# Description: Creates a raster delineating all drainage basins.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inFlowDirectionRaster = "flowdir"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute FlowDirection
outBasin = Basin(inFlowDirectionRaster)
# Save the output
outBasin.save("C:/sapyexamples/output/outbasin02")
Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst