Vínculo de curso de agua (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Resumen

Asigna valores únicos a secciones de una red lineal de ráster entre intersecciones.

Ilustración

Ilustración de la herramienta Vínculo de curso de agua

Uso

  • Los vínculos son las secciones de un canal de curso de agua que conecta dos cruces sucesivos, un cruce y la salida o un cruce y la división de drenaje.

    Ilustración de vínculos en un canal de curso de agua
    Ilustración de los vínculos en un canal de curso de agua

  • El ráster de curso de agua de entrada se puede crear estableciendo el umbral de los resultados de la herramienta Acumulación de flujo.

  • La red lineal de ráster de curso de agua se debe representar como valores mayores o iguales que 1 en un segundo plano de NoData.

  • La herramienta Vínculo de curso de agua 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.

  • 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 curso de agua de entrada

Ráster de entrada que representa una red de corriente lineal.

Raster Layer
Ráster de dirección de flujo de entrada

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

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster del vínculo de curso de agua de salida.

Esta salida es siempre de tipo entero.

Raster

StreamLink(in_stream_raster, in_flow_direction_raster)
NombreExplicaciónTipo de datos
in_stream_raster

Ráster de entrada que representa una red de corriente lineal.

Raster Layer
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

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster del vínculo de curso de agua de salida.

Esta salida es siempre de tipo entero.

Raster

Muestra de código

Ejemplo 1 de StreamLink (ventana de Python)

Este ejemplo asigna valores únicos a secciones de una red de ráster lineal entre intersecciones.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outStreamLink = StreamLink("stream", "flowdir")
outStreamLink.save("c:/sapyexamples/output/outstrmlnk01")
Ejemplo 2 de StreamLink (script independiente)

Este ejemplo asigna valores únicos a secciones de una red de ráster lineal entre intersecciones.

# Name: _Ex_02.py
# Description: 
# 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
inStreamRaster = "stream"
inFlowDirection = "flowdir"

# Execute StreamLink
outStreamLink = StreamLink(inStreamRaster, inFlowDirection)

# Save the output 
outStreamLink.save("c:/sapyexamples/output/outstrmlnk02")

Información de licenciamiento

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

Temas relacionados