过滤器 (Spatial Analyst)

摘要

对栅格执行平滑（低通）滤波器或边缘增强（高通）滤波器。

了解有关“滤波器”工作原理的详细信息

使用情况

• 低通滤波器选项（Python 中的 LOW）是平均（平滑）滤波器。 高通滤波器（Python 中的 HIGH）选项是边缘增强滤波器。

• 假设滤波器邻域内至少有一个含有效值的像元，则选中在计算中忽略 NoData 选项（在 Python 中，ignore_nodata 设置为 NODATA）时，NoData 输入像元可能会在输出中接收到一个值。

• 可使用焦点统计工具创建符合规范的自定义滤波器。

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

参数

对话框

标注	说明	数据类型
输入栅格	要执行滤波运算的输入栅格。	Raster Layer
过滤器类型 (可选)	要执行的滤波运算类型。 低通—在栅格上横跨一个 3 x 3 低通滤波器。 该选项可平滑整个输入栅格，并降低异常像元的显著性。 这是默认设置。 高通—在栅格上横跨一个 3 x 3 高通滤波器。 此选项可增强栅格中弱化要素的边缘。	String
在计算中忽略 NoData (可选)	指示在进行滤波计算时是否忽略 NoData 值。 选中 - 当滤波器中存在 NoData 值时，忽略此 NoData 值。 将仅使用滤波器中具有数据值的像元来确定输出。 这是默认设置。 未选中 - 当滤波器中存在 NoData 值时，相应待处理像元的输出将为 NoData。 使用此选项时，存在 NoData 值表明确定邻域的统计值所需要的信息不足。	Boolean

返回值

标注	说明	数据类型
输出栅格	过滤后的输出栅格。 输出栅格始终为浮点型。	Raster

Python

Filter(in_raster, {filter_type}, {ignore_nodata})

名称	说明	数据类型
in_raster	要执行滤波运算的输入栅格。	Raster Layer
filter_type (可选)	要执行的滤波运算类型。 LOW—在栅格上横跨一个 3 x 3 低通滤波器。 该选项可平滑整个输入栅格，并降低异常像元的显著性。 这是默认设置。 HIGH—在栅格上横跨一个 3 x 3 高通滤波器。 此选项可增强栅格中弱化要素的边缘。	String
ignore_nodata (可选)	指示在进行滤波计算时是否忽略 NoData 值。 DATA—如果滤波器中存在 NoData 值，则将忽略此 NoData 值。 将仅使用滤波器中具有数据值的像元来确定输出。 这是默认设置。 NODATA—如果滤波器中存在 NoData 值时，则相应待处理像元的输出将为 NoData。 使用此选项时，存在 NoData 值表明确定邻域的统计值所需要的信息不足。	Boolean

返回值

名称	说明	数据类型
out_raster	过滤后的输出栅格。 输出栅格始终为浮点型。	Raster

代码示例

滤波器 (Filter) 示例 1（Python 窗口）

本示例将对输入栅格应用高通滤波器。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
filterOut =  Filter("elevation", "HIGH", "DATA") 
filterOut.save("C:/sapyexamples/output/filtered")

滤波器 (Filter) 示例 2（独立脚本）

本示例将对输入栅格应用低通滤波器。

# Name: Filter_Ex_02.py
# Description: Performs a preset focal filter on a raster. 
# 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" 

# Execute Filter
filterOut =  Filter(inRaster, "LOW", "") 

# Save the output 
filterOut.save("C:/sapyexamples/output/filterout")

环境

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