焦点流 (空间分析)

需要 Spatial Analyst 许可。

摘要

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

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

插图

OutRas = FocalFlow(InRas1)

使用情况

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

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

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

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

参数

对话框

标注	说明	数据类型
输入表面栅格	要计算焦点流的输入表面栅格数据。 可评估每个像元的八个直接邻域来确定流量。 输入栅格数据可为整型或浮点型。	Raster Layer
阈值 (可选)	定义构成阈值的值（必须先等于或超过该值，然后才能出现流）。 阈值可以是整型或浮点型值。 如果相邻像元位置上的值与待处理像元的值之差小于或等于阈值，则输出将为 0（或无流量）。	Double

返回值

标注	说明	数据类型
输出栅格	输出焦点流栅格。 输出栅格始终为整型。	Raster

Python

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")

环境

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