分水岭 (空间分析)

摘要

确定栅格中一组像元之上的汇流区域。

了解有关“分水岭”工作原理的详细信息

用法

• 各个分水岭的值将取自输入栅格中源的值或者要素倾泻点数据。如果倾泻点为栅格数据集，则使用像元值。如果倾泻点为点要素数据集，则从指定的字段中获取值。

• 如果预先使用捕捉倾泻点工具将倾泻点定位至累积流量大的像元，将得到更加理想的结果。

• 当指定输入倾泻点位置作为要素数据时，默认字段将为首个可用的有效字段。如果不存在有效字段，则 ObjectID 字段（如 OID 或 FID）将为默认字段。

语法

Watershed (in_flow_direction_raster, in_pour_point_data, {pour_point_field})

参数	说明	数据类型
in_flow_direction_raster	根据每个像元来显示流向的输入栅格。 可以使用流向 工具创建流向栅格。	Raster Layer
in_pour_point_data	输入倾泻点位置。 对于栅格，输入倾泻点位置表示将确定的汇流区域或集水区之上的像元。所有非 NoData 的像元都将用作源像元。 对于点要素数据集，输入倾泻点位置表示将确定的汇流区域或集水区之上的位置。	Raster Layer | Feature Layer
pour_point_field (可选)	用于为倾泻点位置赋值的字段。 如果倾泻点数据集为栅格，则使用 Value。 如果倾泻点数据集为要素，则使用数值字段。如果该字段包含浮点型值，它们将被截断为整型。	Field

返回值

名称	说明	数据类型
out_raster	显示汇流区域的输出栅格。 将为整型。	Raster

代码实例

Watershed 示例 1（Python 窗口）

本示例针对流向 GRID 栅格中选定的倾泻点位置确定汇流区域。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outWatershed = Watershed("flowdir", "pourpoint")
outWatershed.save("C:/sapyexamples/output/outwtrshd01")

Watershed 示例 2（独立脚本）

本示例针对流向 GRID 栅格中选定的倾泻点位置确定汇流区域，并以 TIFF 栅格的形式输出分水岭。

# Name: Watershed_Ex_02.py
# Description: Determines the contributing area above a set of cells in a
#     raster.
# 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
inFlowDirection = "flowdir"
inPourPointData = "pourpoint"
inPourPointField = "VALUE"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute Watershed
outWatershed = Watershed(inFlowDirection, inPourPointData, inPourPointField)

# Save the output 
outWatershed.save("C:/sapyexamples/output/outwtrshd02.tif")

环境

像元大小, 当前工作空间, 掩膜, 输出坐标系, 范围, 临时工作空间, 捕捉栅格

许可信息

ArcGIS for Desktop Basic:需要 Spatial Analyst

ArcGIS for Desktop Standard:需要 Spatial Analyst

ArcGIS for Desktop Advanced:需要 Spatial Analyst