河流链 (Spatial Analyst)

需要 Spatial Analyst 许可。

摘要

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

插图

“河流链”工具图示

使用情况

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

    河道中的链图示
    河道中的链图示

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

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

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

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

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

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

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

参数

标注说明数据类型
输入流栅格

表示线性流网络的输入栅格。

Raster Layer
输入流向栅格

根据每个像元来显示流向的输入栅格。

可以在流向工具中,运行使用默认流向类型 D8 创建流向栅格。

Raster Layer

返回值

标注说明数据类型
输出栅格

输出河流链栅格数据。

输出为整型。

Raster

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

相关主题