Cuenca hidrográfica (Análisis ráster)

Resumen

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

Ilustración

Ilustración de la herramienta Cuenca hidrográfica

Uso

  • Esta herramienta del portal de análisis de ráster está disponible al iniciar sesión en un portal de ArcGIS Enterprise que tenga configurado ArcGIS Image Server para Análisis de ráster. Cuando se invoca la herramienta, ArcGIS Pro funciona como cliente y el procesamiento tiene lugar en los servidores federados con ArcGIS Enterprise. La herramienta del portal acepta las capas de su portal como entrada y crea la salida en su portal.

    La capa ráster de entrada admite una capa del portal, una URI o URL de un servicio de imágenes o la salida procedente de la herramienta Crear capa de servidor de imágenes. La capa de entidades de entrada puede ser una capa del portal o una URI o URL de un servicio de entidades. Esta herramienta no admite capas o datos ráster locales. Aunque puede usar las capas y los datos de entidades locales como entradas de esta herramienta del portal, la práctica recomendada es usar capas del portal como entrada.

  • 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 D8. Las direcciones de flujo D8 se pueden crear con la herramienta Dirección de flujo, ejecutada con el tipo de dirección de flujo predeterminado D8.

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

Parámetros

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

Ráster de entrada que muestra la dirección del flujo de cada celda.

Raster Layer; Image Service; String
Ráster o entidades de punto de fluidez de entrada

Las ubicaciones de punto de fluidez de entrada.

Raster Layer; Feature Layer; Image Service; Feature Service; String
Nombre de salida

El nombre del servicio ráster de cuenca hidrográfica de salida.

El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.

String
Campo de punto de fluidez
(Opcional)

Campo utilizado para asignar valores a las ubicaciones de punto corriente.

String

Salida derivada

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida.

Raster Layer

arcpy.ra.Watershed(inputFlowDirectionRaster, inPourPointRasterOrFeatures, outputName, {pourPointField})
NombreExplicaciónTipo de datos
inputFlowDirectionRaster

Ráster de entrada que muestra la dirección del flujo de cada celda.

Raster Layer; Image Service; String
inPourPointRasterOrFeatures

Las ubicaciones de punto de fluidez de entrada.

Raster Layer; Feature Layer; Image Service; Feature Service; String
outputName

El nombre del servicio ráster de cuenca hidrográfica de salida.

El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si el nombre de capa ya existe, se le pedirá que indique otro nombre.

String
pourPointField
(Opcional)

Campo utilizado para asignar valores a las ubicaciones de punto corriente.

String

Salida derivada

NombreExplicaciónTipo de datos
outputRaster

El ráster de salida.

Raster Layer

Muestra de código

Ejemplo 1 de Watershed (ventana de Python)

En este ejemplo se determina el área de cuenca contribuyente para las ubicaciones de punto de fluidez seleccionadas en un ráster de dirección del flujo.

import arcpy
arcpy.ra.Watershed("https://myserver/rest/services/flowdir/ImageServer","https://myserver/rest/services/streamlink/ImageServer","outWatershed1")
Ejemplo 2 de Watershed (script independiente)

En este ejemplo se determina el área de cuenca contribuyente para las ubicaciones de punto de fluidez seleccionadas en un ráster de dirección del flujo.

#---------------------------------------------------------------------------
# Name: Watershed_example02.py
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inFlowDirection = "https://myserver/rest/services/flowdir/ImageServer"
inPourPoint = "https://myserver/rest/services/streamlink/ImageServer"
outputWatershed = "outWatershed2"

# Execute Watershed raster analysis tool
arcpy.ra.Watershed(inFlowDirection, inPourPoint, outputWatershed)

Información de licenciamiento

  • Basic: Requiere ArcGIS Image Server
  • Standard: Requiere ArcGIS Image Server
  • Advanced: Requiere ArcGIS Image Server

Temas relacionados