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 arroyo que conecta dos cruces sucesivos, un cruce y la salida o un cruce y la división de drenaje.
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 arroyo 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. Puede crear direcciones de flujo D8 con la herramienta Dirección de flujo; ejecútela 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 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\Desktop10.6\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 válidos para esta herramienta.
Sintaxis
StreamLink (in_stream_raster, in_flow_direction_raster)
Parámetro | 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 arroyo de salida. Esta salida es siempre de tipo entero. | Raster |
Muestra de código
Ejemplo 1 de Vínculo de arroyo (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 (secuencia de comandos 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute StreamLink
outStreamLink = StreamLink(inStreamRaster, inFlowDirection)
# Save the output
outStreamLink.save("c:/sapyexamples/output/outstrmlnk02")
Entornos
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Spatial Analyst
- ArcGIS Desktop Standard: Requiere Spatial Analyst
- ArcGIS Desktop Advanced: Requiere Spatial Analyst