焦点流 (空间分析)

摘要

确定输入栅格中每个像元的直接邻域内值的流量。

了解有关焦点流工作原理的详细信息

插图

焦点流图示
OutRas = FocalFlow(InRas1)

使用情况

  • 焦点流可评估像元的八个直接邻域来确定流量。

  • 来自工具的生成的值将度量进入像元的流量,而非流出像元的流量。

  • 输出值可从分析结果的二进制表示中获取。

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

参数

标注说明数据类型
输入表面栅格

要计算焦点流的输入表面栅格数据。

可评估每个像元的八个直接邻域来确定流量。

输入栅格数据可为整型或浮点型。

Raster Layer
阈值
(可选)

定义构成阈值的值(必须先等于或超过该值,然后才能出现流)。

阈值可以是整型或浮点型值。

如果相邻像元位置上的值与待处理像元的值之差小于或等于阈值,则输出将为 0(或无流量)。

Double

返回值

标注说明数据类型
输出栅格

输出焦点流栅格。

输出栅格始终为整型。

Raster

FocalFlow(in_surface_raster, {threshold_value})
名称说明数据类型
in_surface_raster

要计算焦点流的输入表面栅格数据。

可评估每个像元的八个直接邻域来确定流量。

输入栅格数据可为整型或浮点型。

Raster Layer
threshold_value
(可选)

定义构成阈值的值(必须先等于或超过该值,然后才能出现流)。

阈值可以是整型或浮点型值。

如果相邻像元位置上的值与待处理像元的值之差小于或等于阈值,则输出将为 0(或无流量)。

Double

返回值

名称说明数据类型
out_raster

输出焦点流栅格。

输出栅格始终为整型。

Raster

代码示例

FocalFlow 示例 1(Python 窗口)

本例确定阈值为 10 的输入栅格的流量的二进制表示。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
focalFlowOut = FocalFlow("elevation", 10)
focalFlowOut.save("C:/sapyexamples/output/flowout")
FocalFlow 示例 2(独立脚本)

本例确定阈值为 5 的输入栅格的流量的二进制表示。

# Name: FocalFlow_Ex_02.py
# Description: Determines the flow of the values in the 
#    input raster within each cell's immediate neighborhood.
# 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
inRaster = "elevation"
threshold = 5 

# Execute FocalFlow
outFocalFlow = FocalFlow(inRaster, threshold)

# Save the output 
outFocalFlow.save("C:/sapyexamples/output/focalflow")