Available with Spatial Analyst license.
Assigns unique values to sections of a raster linear network between intersections.
Links are the sections of a stream channel connecting two successive junctions, a junction and the outlet, or a junction and the drainage divide.
The input stream raster can be created by thresholding the results of the Flow Accumulation tool.
The stream raster linear network should be represented as values greater than or equal to one on a background of NoData.
The Stream Link tool only supports a D8 input flow direction raster. D8 flow directions can be created using the Flow Direction tool, run with default flow direction type D8.
This tool supports parallel processing. If your computer has multiple processors or processors with multiple cores, better performance may be achieved, particularly on larger datasets. The Parallel processing with Spatial Analyst help topic includes details about this capability and how to configure it.
When using parallel processing, temporary data will be written to manage the data chunks being processed. The default temp folder location will be on your local C: drive. You can control the location of this folder by setting up a system environment variable named TempFolders and specifying the path to a folder to use (for example, E:\RasterCache). If you have administrator privileges on your machine, you can also use a registry key (for example, [HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]).
By default, this tool will use 50 percent of the available cores. If the input data is smaller than 5,000-by-5,000 cells in size, fewer cores may be used. You can control the number of cores the tool uses with the Parallel processing factor environment.
When the output raster format is .crf, this tool supports the Pyramid raster storage environment. Pyramids will be created in the output by default. For any other output format, this environment is not supported, and pyramids will not be created.
See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this tool.
| Label | Explanation | Data Type |
Input stream raster | An input raster that represents a linear stream network. | Raster Layer |
Input flow direction raster | The input raster that shows the direction of flow out of each cell. The flow direction raster can be created with the Flow Direction tool using the default D8 flow direction type. | Raster Layer |
| Label | Explanation | Data Type | Output raster | The output stream link raster. This output is of integer type. | Raster |
StreamLink(in_stream_raster, in_flow_direction_raster)
| Name | Explanation | Data Type |
in_stream_raster | An input raster that represents a linear stream network. | Raster Layer |
in_flow_direction_raster | The input raster that shows the direction of flow out of each cell. The flow direction raster can be created with the Flow Direction tool using the default D8 flow direction type. | Raster Layer |
| Name | Explanation | Data Type | out_raster | The output stream link raster. This output is of integer type. | Raster |
This example assigns unique values to sections of a raster linear network between intersections.
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")This example assigns unique values to sections of a raster linear network between intersections.
# 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")