焦点统计函数

概述

计算每个输入栅格像元周围邻域内的像元的统计数据。 有几种邻域形状可供选择。

备注

如果输入栅格为浮点型,则只有平均值、最大值、中值、最小值、百分比数、范围、标准差和总和统计类型可用。

当指定某圆形、环形或楔形邻域时,由于像元的中心必须包含在邻域中,因此在计算中可能不考虑一些外部对角线像元。

假设邻域内至少有一个含有效值的像元,则选中在计算中忽略 NoData 选项时,NoData 输入像元可能会在输出中接收到一个值。

有关此函数的详细信息,请参阅焦点统计的工作原理主题。

参数

参数名称描述

栅格

(必填)

输入栅格。

社区

用于计算统计数据的各像元周围区域的形状。

每个邻域都具有用来定义形状的附加参数。

  • 矩形宽度高度

    由宽度和高度定义的矩形邻域。 宽度或高度的最小值为 1 个像元,最大值为 4096 个像元。 默认设置是宽度和高度为三个像元的正方形。

  • 圆形半径

    具有给定半径的圆形邻域。 最小半径值为 1 个像元,最大值为 2047 个像元。 默认半径为三个像元。

  • 环形内半径外半径

    由内半径和外半径定义的环或圆环形邻域。 最小半径值为 1 个像元,外半径必须大于内半径。 最大内半径为 2046 个像元,最大外半径为 2047 个像元。 默认环形具有一个像元的内半径以及三个像元的外半径。

  • 楔形半径起始角度终止角度

    由半径、起始角度和终止角度定义的楔形邻域。 最小半径值为 1 个像元,最大值为 2047 个像元。 楔形按逆时针方向从起始角延伸到终止角。 角度以度为单位进行指定,0 或 360 的值表示东方。 也可使用负角度。 默认楔形起始角度为 0 度,终止角度为 90 度,半径为三个像元。

  • 不规则宽度高度邻域值

    不规则邻域允许您在待处理像元周围指定形状不规则的邻域或核。 请使用邻域值表来定义邻域核的形状。 而值为 1 则表示该值对应的像元(和像元值)属于该邻域。 使用值 0 可将像元从处理范围中排除。 核宽度或高度的最小值为 1 个像元,最大值为 4096 个像元。

  • 权重宽度高度邻域值

    权重邻域与不规则邻域类型相似,用于定义待处理像元周围的不规则形状邻域,此外还可以指定各输入值的权重。 权重核中的值可指定应包含在邻域范围内的各像元位置及其权重。 使用值 0 可将像元从处理范围中排除。 小数值可用作权重。 核宽度或高度的最小值为 1 个像元,最大值为 4096 个像元。

注:

对于“权重”邻域类型,仅支持“平均值”、“标准差”或“总和”统计数据。

统计类型

用于指定要计算的统计数据类型。

  • 平均值 - 计算邻域内像元的平均值。
  • 众数 - 确定邻域内像元的众数(出现次数最多的值)。
  • 最大值 - 确定邻域内像元的最大值。
  • 中值 - 计算邻域内像元的中值。 中位数相当于第 50 个百分比数。
  • 最小值 - 确定邻域内像元的最小值。
  • 少数 - 确定邻域内像元的少数(出现次数最少的值)。
  • 百分比数 - 计算邻域内像元的百分比数。 如果选择此统计类型,则百分比数值参数将变为可用,您可以使用该参数来确定要计算的百分比数。
  • 范围 - 确定邻域内像元的范围(最大值和最小值之差)。
  • 标准差 - 计算邻域内像元的标准差。
  • 总和 - 计算邻域内像元的总和(所有值的总和)。
  • 变异度 - 确定邻域内像元的变异度(唯一值的数量)。

默认统计类型为平均值。

如果输入栅格为浮点型,则只有平均值、最大值、中值、最小值、百分比数、范围、标准差和总和统计类型可用。

对于平均值、中值、百分比数和标准差,输出始终为浮点型。

对于众数和少数,如果邻域中具有最高(众数)或最低(少数)频率的值之间相等,则处理像元位置将收到相等值中的最低值。 如果处理像元本身的值是相等值之一,则将返回该值。

在计算中忽略 NoData

指定在进行统计计算时是否忽略 NoData 值。

  • 选中 - 当邻域中存在 NoData 值时,将忽略此 NoData 值。 将仅使用邻域内具有数据值的像元来确定输出值。 这是默认设置。
  • 未选中 - 如果邻域内有任意像元的值是 NoData,则处理像元的输出将为 NoData。

百分比值

指定将百分比数选作统计类型时需要计算的百分比数。 对于 90%,其默认值为 90。

取值范围为 0 到 100。 第 0 个百分比数基本上等于“最小值”统计量,而第 100 个百分比数相当于“最大值”,但结果为浮点型的情况除外。 值 50 所生成的结果基本上与“中值”统计量的结果相同。

核文件

对于不规则权重邻域,您可以将自定义核另存为文本文件以供日后使用。

指定宽度和高度并输入邻域值后,使用另存为按钮通过保存邻域核文件对话框将其导出为 ASCII 文本文件。 使用浏览按钮打开输入邻域核文件对话框,以浏览并指定要加载的现有核文件。

核文件中的第一行以像元数记录核邻域的宽度和高度。 后续各行将指示如何处理与核中该位置相对应的输入值。

核文件中不规则邻域或权重邻域类型的值为 0 表示相应位置将不包括在计算中。 对于不规则邻域,核文件中的值为 1 表示相应的输入像元将包含在运算中。 对于权重邻域,每个位置的值均表示需要与对应输入像元值相乘的值。 正值、负值和小数值均可用作权重。


在本主题中
  1. 概述
  2. 备注
  3. 参数
  4. 核文件