| 标注 | 说明 | 数据类型 |
输入流向栅格 | 根据每个像元来显示流向的输入栅格。 可以使用流向工具创建流向栅格。 | Raster Layer |
测量方向 (可选) | 沿流路径的度量方向。
| String |
输入权重栅格 (可选) | 对每一像元应用权重的可选输入栅格。 如果未指定权重栅格，则将默认的权重值 1 应用于每个像元。 对于输出栅格中的每个像元，结果将是流入其中的像元数。 | Raster Layer |
返回值
| 标注 | 说明 | 数据类型 | 输出栅格 | 显示每个像元的沿流路径的上游或下游距离的输出栅格。 | Raster |
需要 Spatial Analyst 许可。
摘要
计算沿每个像元的流路径的上游(或下游)距离或加权距离。
使用情况
水流长度工具的主要用途是计算给定盆地内最长水流的长度。 该度量值常用于计算盆地的聚集时间。 这可通过上游选项来实现。
该工具也可通过将权重栅格用作下坡运动的阻抗，来创建假设降雨和径流事件的距离-面积图。
水流长度输出栅格的值类型为浮点型。
当输出栅格格式为 .crf 时，此工具支持金字塔栅格存储环境。 默认情况下，将在输出中创建金字塔。 对于任何其他输出格式，不支持此环境，并且不会创建金字塔。
有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。
参数
FlowLength(in_flow_direction_raster, {direction_measurement}, {in_weight_raster})| 名称 | 说明 | 数据类型 |
in_flow_direction_raster | 根据每个像元来显示流向的输入栅格。 可以使用流向工具创建流向栅格。 | Raster Layer |
direction_measurement (可选) | 沿流路径的度量方向。
| String |
in_weight_raster (可选) | 对每一像元应用权重的可选输入栅格。 如果未指定权重栅格，则将默认的权重值 1 应用于每个像元。 对于输出栅格中的每个像元，结果将是流入其中的像元数。 | Raster Layer |
返回值
| 名称 | 说明 | 数据类型 | out_raster | 显示每个像元的沿流路径的上游或下游距离的输出栅格。 | Raster |
代码示例
本例计算沿每个像元的流路径的下游距离。
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")本例计算沿每个像元的流路径的下游距离。
# 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"
# Execute
outFlowLength = FlowLength(inFlowDirectionRaster, directionType, inWeightRaster)
# Save the output
outFlowLength.save("c:/sapyexamples/output/outflowlen02.tif")