NbrWeight

需要 Spatial Analyst 许可。

获得 Image Analyst 许可后可用。

描述

定义使用核文件创建的权重邻域,该核文件指定用于乘以邻域范围内像元的值。

插图

FocalStatistics 函数的 NbrWeight 邻域
FocalStatistics 函数的 NbrWeight 邻域示例。
BlockStatistics 函数的 NbrWeight 邻域
BlockStatistics 函数的 NbrWeight 邻域示例。

讨论

使用邻域权重对象的工具包括:块统计焦点统计

许可:

如果具有 Image Analyst 扩展模块许可,也可以使用该类,但仅限于焦点统计工具。

使用核文件指定权重邻域。核文件用来标识应包含在邻域范围内的像元位置以及用于乘以输入栅格中像元值的权重。

对于焦点统计工具,可通过以下方程确定邻域范围内待处理像元相对于邻域左上角的 x,y 位置:

 x = (width + 1)/2 y = (height + 1)/2

如果输入像元数为偶数,则可通过截断操作来计算 x 和 y 坐标。

核文件:

  • 核文件属于 ASCII 文本文件,可定义权重邻域的值和形状。

  • 第一行指定了邻域的宽度和高度(表示为由空格分开的 x 轴方向上的像元数和 y 轴方向上的像元数)。

  • 随后几行则指定了邻域中各个位置的权重值。按照与各像元在所在邻域中相同的配置输入这些像元值。正值、负值和小数值均可用作权重。各个值之间需要由空格分隔。

  • 对于邻域中不用于计算的位置,核文件中的相应位置将用值 0 表示。

语法

NbrWeight (inKernelFile)
参数说明数据类型
inKernelFile

inKernelFile 是一种 ASCII 文本文件,用于定义邻域的形状及领域中各像元的权重。像元位置值为 0 表示该像元并非领域的成员,而当像元位置对应数值时则表示该像元值已被包括在领域成员中。非零值也可用作权重以与相应像元值相乘。

File

属性

属性说明数据类型
inKernelFile
(可读写)

inKernelFile 是一种 ASCII 文本文件,用于定义邻域的形状及领域中各像元的权重。像元位置值为 0 表示该像元并非领域的成员,而当像元位置对应数值时则表示该像元值已被包括在领域成员中。非零值也可用作权重以与相应像元值相乘。

String

代码示例

NbrWeight 示例 1(Python 窗口)

演示如何创建 NbrWeight 类以及如何在 Python 窗口的 BlockStatistics 工具中使用该类。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNbrWF = BlockStatistics("block", NbrWeight("weight.txt"))
outNbrWF.save("C:/sapyexamples/output/blstatsnbrwf2")
NbrWeight 示例 2(独立脚本)

使用 NbrWeight 类执行 BlockStatistics 工具。

# Name: NbrWeight_Ex_02.py
# Description: Uses the NbrWeight object to execute BlockStatistics tool.
# 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 = "block"

# Create the Neighborhood Object
inWeightFile = "C:/data/weight.txt"
myNbrWeight = NbrWeight(inWeightFile)

# Execute BlockStatistics
outBlStats =  BlockStatistics(inRaster, myNbrWeight, "MINIMUM", "DATA")

# Save the output 
outBlStats.save("C:/sapyexamples/output/blstat_wght3")

相关主题