流量 (空间分析)

摘要

创建每个像元累积流量的栅格。可选择性应用权重系数。

了解有关“流量”工作原理的详细信息

插图

Flow_Acc = FlowAccumulation(Flow_Dir)

用法

• 通过流量得到的结果是表示每个像元累积流量的栅格，由流入每个下坡像元的所有像元的累积权重决定。

• 具有未定义流向的像元将仅接收流；它们不会形成任何下游流。如果某像元在流向栅格中的值是 1、2、4、8、16、32、64 或 128 以外的值，则将该像元视为具有未定义的流向。

• 流量累积将基于流入输出栅格中每个像元的像元数。累积中不会考虑当前处理的像元。

• 高流量的输出像元是集中流动区域，可用于标识河道。

• 流量为零的输出像元是局部地形高点，可用于识别山脊。

• 如果未使用流向工具创建输入流向栅格，则定义的流可能呈环形。如果流向形成环，流量将陷入永无止境的无限循环中。

• 流量工具不遵循压缩环境设置。输出栅格将始终处于未压缩状态。

语法

FlowAccumulation (in_flow_direction_raster, {in_weight_raster}, {data_type})

参数	说明	数据类型
in_flow_direction_raster	根据每个像元来显示流向的输入栅格。 可以使用流向 工具创建流向栅格。	Raster Layer
in_weight_raster (可选)	对每一像元应用权重的可选输入栅格。 如果未指定权重栅格，则将默认的权重值 1 应用于每个像元。对于输出栅格中的每个像元，结果为流入其中的像元数。	Raster Layer
data_type (可选)	输出累积栅格数据可以是整型或浮点型。 FLOAT — 输出栅格将为浮点型。这是默认设置。 INTEGER — 输出栅格将为整型。	String

返回值

名称	说明	数据类型
out_accumulation_raster	显示每个像元累积流量的输出栅格。	Raster

代码实例

流量 (FlowAccumulation) 示例 1（Python 窗口）

本示例将创建输入流向 GRID 栅格的每个像元累积流量的栅格。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFlowAccumulation = FlowAccumulation("flowdir")
outFlowAccumulation.save("C:/sapyexamples/output/outflowacc01")

流量 (FlowAccumulation) 示例 2（独立脚本）

本示例将创建输入流向 IMG 栅格的每个像元累积流量的栅格。

# Name: FlowAccumulation_Ex_02.py
# Description: Creates a raster of accumulated flow to each cell.
# 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
inFlowDirRaster = "flowdir"
inWeightRaster = ""
dataType = "INTEGER"

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

# Execute FlowDirection
outFlowAccumulation = FlowAccumulation(inFlowDirRaster, inWeightRaster, dataType)

# Save the output 
outFlowAccumulation.save("C:/sapyexamples/output/outflowacc02.img")

环境

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

许可信息

ArcGIS for Desktop Basic:需要 Spatial Analyst

ArcGIS for Desktop Standard:需要 Spatial Analyst

ArcGIS for Desktop Advanced:需要 Spatial Analyst