水流长度 (Spatial Analyst 工具)

汇总

计算沿每个像元的流路径的上游（或下游）距离或加权距离。

用法

水流长度工具的主要用途是计算给定盆域内最长流动路径的长度。该度量值常用于计算盆域的聚集时间。这可通过上游选项来实现。

该工具也可通过将权重栅格用作下坡运动的阻抗，来创建假设降雨和径流事件的距离-面积图。
水流长度输出栅格的值类型为浮点型。
当输出栅格格式为 .crf 时，此工具支持金字塔栅格存储环境。默认情况下，将在输出中创建金字塔。对于任何其他输出格式，不支持此环境，并且不会创建金字塔。
有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。

标注	说明	数据类型
输入流向栅格	根据每个像元来显示流向的输入栅格。可以使用流向工具创建流向栅格。	Raster Layer
测量方向（可选）	沿流路径的度量方向。下游—计算沿流路径从每个像元到栅格边上的汇点或出水口的下坡距离。上游—计算沿流路径从每个像元到分水岭顶部的最长上坡距离。	String
输入权重栅格（可选）	对每一像元应用权重的输入栅格。如果未指定权重栅格，则将默认的权重值 1 应用于每个像元。对于输出栅格中的每个像元，结果将是流入其中的像元数。	Raster Layer

标注

说明

数据类型

输入流向栅格

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

可以使用流向工具创建流向栅格。

Raster Layer

测量方向

（可选）

沿流路径的度量方向。

下游—计算沿流路径从每个像元到栅格边上的汇点或出水口的下坡距离。
上游—计算沿流路径从每个像元到分水岭顶部的最长上坡距离。

String

输入权重栅格

（可选）

对每一像元应用权重的输入栅格。

如果未指定权重栅格，则将默认的权重值 1 应用于每个像元。对于输出栅格中的每个像元，结果将是流入其中的像元数。

Raster Layer

返回值

标注	说明	数据类型
输出栅格	显示每个像元的沿流路径的上游或下游距离的输出栅格。	Raster

FlowLength(in_flow_direction_raster, {direction_measurement}, {in_weight_raster})

名称说明数据类型

名称	说明	数据类型
in_flow_direction_raster	根据每个像元来显示流向的输入栅格。可以使用流向工具创建流向栅格。	Raster Layer
direction_measurement （可选）	沿流路径的度量方向。 `DOWNSTREAM`—计算沿流路径从每个像元到栅格边上的汇点或出水口的下坡距离。 `UPSTREAM`—计算沿流路径从每个像元到分水岭顶部的最长上坡距离。	String
in_weight_raster （可选）	对每一像元应用权重的输入栅格。如果未指定权重栅格，则将默认的权重值 1 应用于每个像元。对于输出栅格中的每个像元，结果将是流入其中的像元数。	Raster Layer

in_flow_direction_raster

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

可以使用流向工具创建流向栅格。

Raster Layer

direction_measurement

（可选）

沿流路径的度量方向。

DOWNSTREAM—计算沿流路径从每个像元到栅格边上的汇点或出水口的下坡距离。
UPSTREAM—计算沿流路径从每个像元到分水岭顶部的最长上坡距离。

String

in_weight_raster

（可选）

对每一像元应用权重的输入栅格。

如果未指定权重栅格，则将默认的权重值 1 应用于每个像元。对于输出栅格中的每个像元，结果将是流入其中的像元数。

Raster Layer

返回值

名称	说明	数据类型
out_raster	显示每个像元的沿流路径的上游或下游距离的输出栅格。	Raster

代码示例

FlowLength 示例 1（Python 窗口）

本例计算沿每个像元的流路径的下游距离。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowLength = FlowLength("flowdir", "DOWNSTREAM", "")
outFlowLength.save("c:/sapyexamples/output/outflowlen01")

FlowLength 示例 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
inFlowDirectionRaster = "flowdir"
inWeightRaster = ""
directionType = "DOWNSTREAM"

# Run
outFlowLength = FlowLength(inFlowDirectionRaster, directionType, inWeightRaster)

# Save the output
outFlowLength.save("c:/sapyexamples/output/outflowlen02.tif")

环境

自动提交, 像元大小, 像元大小投影方法, 当前工作空间, 范围, 地理变换, 输出配置关键字, 输出坐标系, 金字塔, 临时工作空间, 捕捉栅格, 分块大小

许可信息

基本: 需要 Spatial Analyst
标准: 需要 Spatial Analyst
高级: 需要 Spatial Analyst

水流长度 (Spatial Analyst 工具)

汇总

用法

参数

返回值

环境

许可信息

相关主题