Disponible con una licencia de 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.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
Watershed (in_flow_direction_raster, in_pour_point_data, {pour_point_field})| 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. Esta salida es siempre de tipo entero. | Raster |
Muestra de código
Ejemplo 1 de Cuenca hidrográfica (ventana de Python)
En este ejemplo se determina el área de contribución para las ubicaciones de punto de fluidez seleccionadas en un ráster de cuadrícula 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")
Ejemplo 2 de Cuenca hidrográfica (secuencia de comandos independiente)
En este ejemplo se determina el área de contribución para las ubicaciones de punto de fluidez seleccionadas en un ráster de cuadrícula 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")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Análisis espacial
- ArcGIS Desktop Standard: Requiere Análisis espacial
- ArcGIS Desktop Advanced: Requiere Análisis espacial