河流链 (Spatial Analyst)

需要 Spatial Analyst 许可。

摘要

向各交点之间的栅格线性网络的各部分分配唯一值。

插图

使用情况

• “链”是指连接两个相邻交汇点、连接一个交汇点和出水口或连接一个交汇点和分水岭的河道的河段。

  

  河道中的链图示

• 通过为流量工具的结果设置阈值来创建输入流栅格。

• 在 NoData 背景上，河流栅格线状网络应表示为大于或等于 1 的值。

• 河流链工具仅支持 D8 输入流向栅格。 可以使用流向工具（运行默认流向类型 D8）来创建 D8 流向。

• 该工具支持并行处理。 如果您的计算机具有多个处理器或处理器具有多个内核，则会获得更好的性能，特别是处理较大数据集时。 使用 Spatial Analyst 进行并行处理帮助主题包括有关此功能及其配置方法的详细信息。

  使用并行处理时，将写入临时数据以管理正在处理的数据区段。 默认的临时文件夹位置在您的本地 C: 驱动器上。 您可以通过设置名为 TempFolders 的系统环境变量并指定要使用的文件夹路径（例如，E:\RasterCache），来控制此文件夹的位置。 如果您拥有计算机管理员权限，还可以使用注册表键（例如，[HKEY_CURRENT_USER\SOFTWARE\ESRI\ArcGISPro\Raster]）。

  默认情况下，此工具将使用可用核数的 50%。 如果输入数据大小小于 5,000 * 5,000 像元，则会使用更少的核。 您可以控制该工具用于并行处理因子环境的内核数。

• 当输出栅格格式为 .crf 时，此工具支持金字塔栅格存储环境。 默认情况下，将在输出中创建金字塔。 对于任何其他输出格式，不支持此环境，并且不会创建金字塔。

• 有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。

参数

对话框

标注	说明	数据类型
输入流栅格	表示线性流网络的输入栅格。	Raster Layer
输入流向栅格	根据每个像元来显示流向的输入栅格。 可以在流向工具中，运行使用默认流向类型 D8 创建流向栅格。	Raster Layer

返回值

标注	说明	数据类型
输出栅格	输出河流链栅格数据。 输出为整型。	Raster

Python

StreamLink(in_stream_raster, in_flow_direction_raster)

名称	说明	数据类型
in_stream_raster	表示线性流网络的输入栅格。	Raster Layer
in_flow_direction_raster	根据每个像元来显示流向的输入栅格。 可以在流向工具中，运行使用默认流向类型 D8 创建流向栅格。	Raster Layer

返回值

名称	说明	数据类型
out_raster	输出河流链栅格数据。 输出为整型。	Raster

代码示例

StreamLink 示例 1（Python 窗口）

此示例向各交汇点之间的栅格线状网络的各部分分配唯一值。

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")

StreamLink 示例 2（独立脚本）

此示例向各交汇点之间的栅格线状网络的各部分分配唯一值。

# 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")

环境

自动提交, 像元大小, 像元大小投影方法, 压缩, 当前工作空间, 范围, 地理变换, 掩膜, 输出配置关键字, 输出坐标系, 并行处理因子, 金字塔, 临时工作空间, 捕捉栅格, 切片大小

许可信息

• Basic: 需要 Spatial Analyst
• Standard: 需要 Spatial Analyst
• Advanced: 需要 Spatial Analyst