焦点统计函数

概述

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

备注

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

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

假设邻域内至少有一个含有效值的像元，则选中在计算中忽略 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 表示相应的输入像元将包含在运算中。 对于权重邻域，每个位置的值均表示需要与对应输入像元值相乘的值。 正值、负值和小数值均可用作权重。