汇 (Spatial Analyst)

需要 Spatial Analyst 许可。

摘要

创建识别所有汇或内流水系区域的栅格

了解有关汇工作原理的详细信息

使用情况

• 汇是指流向栅格中流向无法被赋予八个有效值之一的一个或一组空间连接像元。在所有相邻像元都高于待处理像元时，或在两个像元互相流入以创建一个由两个像元构成的循环时，都会发生这种情况。

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

• 汇工具的输出是一个整型栅格，其中每个汇都被赋予一个唯一值。汇的编号介于 1 到汇的数量之间。

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

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

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

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

参数

对话框

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

返回值

标注	说明	数据类型
输出栅格	显示输入表面上的所有汇（内流水系区域）的输出栅格。 输出为整型。	Raster

Python

Sink(in_flow_direction_raster)

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

返回值

名称	说明	数据类型
out_raster	显示输入表面上的所有汇（内流水系区域）的输出栅格。 输出为整型。	Raster

代码示例

Sink 示例 1（Python 窗口）

此示例识别输入流向格网栅格上的汇。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSink = Sink("flowdir")
outSink.save("C:/sapyexamples/output/outsink01")

Sink 示例 2（独立脚本）

此示例识别输入流向格网栅格上的汇。

# Name: Sink_Ex_02.py
# Description: Creates a raster identifying all sinks or areas of internal drainage.
# 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
inFlowDirectionRaster = "flowdir"

# Execute FlowDirection
outSink = Sink(inFlowDirectionRaster)

# Save the output 
outSink.save("C:/sapyexamples/output/outsink02")

环境

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

许可信息

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