Cuenca hidrográfica (Spatial Analyst)
Resumen
Determina el área de contribución por sobre un conjunto de celdas de un ráster.
Uso
-
El valor de cada cuenca hidrográfica se tomará del valor del origen en los datos de punto de fluidez de ráster o entidad de entrada. Cuando el punto de fluidez es un dataset ráster, se utilizarán los valores de celda. Cuando el punto de fluidez es un dataset de entidad de puntos, los valores provendrán del campo especificado.
-
Se obtendrán mejores resultados si se utiliza la herramienta Alinear punto de fluidez de antemano para ayudar a ubicar los puntos de fluidez en las celdas de flujo acumulado alto.
Al especificar las ubicaciones de punto de fluidez de entrada como datos de entidad, el campo predeterminado será el primer campo válido disponible. Si no existen campos válidos, el campo ObjectID (por ejemplo, OID o FID) será el valor predeterminado.
Sintaxis
| 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. El ráster de dirección de flujo se puede crear con la herramienta Dirección de flujo. | Raster Layer |
in_pour_point_data |
Las ubicaciones de punto de fluidez de entrada. Para un ráster, esto representa las celdas por sobre las que se determinará el área de contribución o la cuenca. Todas las celdas que no son NoData se utilizarán como celdas de origen. Para un dataset de entidad de punto, esto representa las ubicaciones por sobre las que se determinará el área de contribución o la cuenca. | Raster Layer | Feature Layer |
pour_point_field (Opcional) |
Campo utilizado para asignar valores a las ubicaciones de punto corriente. Si el dataset de punto corriente es un ráster, utilice Valor. Si el dataset de punto corriente es una entidad, utilice un campo numérico. Si el campo contiene valores de punto flotante, se truncarán en enteros. | Field |
Valor de retorno
| Nombre | Explicación | Tipo de datos |
| out_raster |
El ráster de salida que muestra el área de contribución. Será de tipo entero. | Raster |
Ejemplo de código
En este ejemplo se determina el área de contribución para las ubicaciones de punto de fluidez seleccionadas en un ráster GRID de dirección de flujo.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outWatershed = Watershed("flowdir", "pourpoint")
outWatershed.save("C:/sapyexamples/output/outwtrshd01")
En este ejemplo se determina el área de contribución para las ubicaciones de punto de fluidez seleccionadas en un ráster GRID de dirección de flujo y se genera como salida la cuenca hidrográfica como un ráster TIFF.
# Name: Watershed_Ex_02.py
# Description: Determines the contributing area above a set of cells in a
# raster.
# 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
inFlowDirection = "flowdir"
inPourPointData = "pourpoint"
inPourPointField = "VALUE"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Watershed
outWatershed = Watershed(inFlowDirection, inPourPointData, inPourPointField)
# Save the output
outWatershed.save("C:/sapyexamples/output/outwtrshd02.tif")