Cuenca hidrográfica (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Determina el área de contribución por sobre un conjunto de celdas de un ráster.

Más información sobre cómo funciona Cuenca hidrográfica

Ilustración

Ilustración de la herramienta Cuenca hidrográfica

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.

  • La herramienta Cuenca hidrográfica solo admite un ráster de dirección del flujo de entrada de tipo D8. Se puede crear con la herramienta Dirección del flujo; ejecútela con el tipo de dirección del flujo predeterminado, D8 (en Python, con la opción D8).

  • 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.

  • 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 contiene más detalles acerca de esta posibilidad y cómo configurarla.

    Al utilizar el procesamiento en paralelo, se escriben datos temporales para administrar los lotes de datos a medida que se procesan. La ubicación de la carpeta temporal predeterminada será su unidad C local. Es posible controlar la ubicación de esta carpeta cambiando el valor de una variable de entorno del sistema denominada TempFolders y especificando la ruta de la carpeta que se desea usar (por ejemplo, E:\RasterCache). Si tiene privilegios de administrador en su equipo, también puede usar una clave de registro (por ejemplo, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).

    De forma predeterminada, esta herramienta usará el 50 por ciento de los núcleos disponibles. Si los datos de entrada tienen un tamaño inferior a 5.000 x 5.000 celdas, es posible que se utilicen menos núcleos. 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 que se aplican a esta herramienta.

Sintaxis

Watershed(in_flow_direction_raster, in_pour_point_data, {pour_point_field})
ParámetroExplicaciónTipo 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, ejecutada con el tipo de dirección de flujo predeterminado, D8.

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 de fluidez es una entidad, use un campo numérico. Si el campo contiene valores de punto flotante, se truncarán en enteros.

Field

Valor de retorno

NombreExplicaciónTipo 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 (script 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"

# Execute Watershed
outWatershed = Watershed(inFlowDirection, inPourPointData, inPourPointField)

# Save the output 
outWatershed.save("C:/sapyexamples/output/outwtrshd02.tif")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst
  • Standard: Requiere Spatial Analyst
  • Advanced: Requiere Spatial Analyst

Temas relacionados