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 de flujo; ejecútela con el tipo de dirección de 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 los puntos de fluidez de entrada como datos de entidad, el campo predeterminado será el primer campo válido disponible. Si no existe un campo válido, 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 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, 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.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de dirección de flujo de entrada D8

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
Datos de corrientes de ráster o entidad de entrada

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
Campo de punto de fluidez
(Opcional)

El campo que se utiliza para asignar los valores a las ubicaciones de punto de fluidez.

Si el dataset de punto de fluidez es un ráster, use Value.

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

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida que muestra el área de contribución.

Esta salida es siempre de tipo entero.

Raster

Watershed(in_flow_direction_raster, in_pour_point_data, {pour_point_field})
NombreExplicació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)

El campo que se utiliza para asignar los valores a las ubicaciones de punto de fluidez.

Si el dataset de punto de fluidez es un ráster, use Value.

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 Watershed (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 Watershed (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