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

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

• Cuando el formato de ráster de salida es .crf, esta herramienta admite el entorno de almacenamiento ráster Pirámide. De forma predeterminada, se crearán pirámides en la salida. Para cualquier otro formato de salida, este entorno no es compatible y no se crearán pirámides.

• 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

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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

Etiqueta	Explicación	Tipo 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

Python

StreamLink(in_stream_raster, in_flow_direction_raster)

Nombre	Explicación	Tipo 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

Nombre	Explicación	Tipo 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")

Entornos

Auto ejecución, Tamaño de celda, Método de proyección de tamaño de celda, Compresión, Espacio de trabajo actual, Extensión, Transformaciones geográficas, Máscara, Palabra clave CONFIG de salida, Sistema de coordenadas de salida, Factor de procesamiento en paralelo, Pirámide, Espacio de trabajo temporal, Alinear ráster, Tamaño de tesela

Información de licenciamiento

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