分区统计 (影像分析工具)

汇总

汇总另一个数据集区域内的栅格值。

了解有关分区统计工具工作原理的详细信息

插图

OutRas = ZonalStatistics(ZoneRas, "VALUE", ValRas, "MINIMUM", "DATA", "CURRENT_SLICE")

用法

• 分区定义为输入中具有相同值的所有区域。 各区域无需相连。 栅格和要素都可用于区域输入。

• 如果输入栅格或要素区域数据参数值（Python 中的 in_zone_data）是栅格，则必须是整数栅格。

• 如果输入栅格或要素区域数据参数值为要素，则将使用输入赋值栅格（Python 中的 in_value_raster）参数的像元大小和像元对齐方式在内部将其转换为栅格。

• 如果输入栅格或要素区域数据和输入赋值栅格参数值的像元大小、像元对齐方式或空间参考不同，则输入赋值栅格值将在内部用作像元大小、捕捉栅格和输出坐标系。 上述任何情况都会在执行分区操作之前导致内部重采样。

  如果区域输入和值输入均为具有相同像元大小的栅格，并且像元已对齐，则可将其直接应用于工具中，且工具处理期间不会对其进行内部重采样。

• 如果输入栅格或要素区域数据参数值为要素，对于不与值栅格的任何像元中心重叠的任何区域要素，这些区域将不会转换为内部区域栅格。 因此，这些区域将不会在输出中表示。 您可以通过为保留要素区域所需细节层次的像元大小环境指定适当的值来管理这些区域并在分析环境中指定这些区域。

• 如果输入栅格或要素区域数据值为点要素，则值输入栅格的任何特定像元可能包含多个点。 对于这样的像元，分区值将通过具有最低 ObjectID 字段的点（例如 OID 或 FID）来确定。

• 如果输入栅格或要素区域数据值具有重叠面，则无法为每一个单独的面执行区域分析。 由于要素输入会转换为栅格，所以每个位置只能有一个值。

  另一种方法就是要为每个面区域反复进行区域操作并核对结果。

• 在指定输入栅格或要素区域数据参数值时，默认区域字段将为第一个可用的整型或文本字段。 如果不存在其他有效字段，则 ObjectID 字段（例如 OID 或 FID）将成为默认字段。

• 支持的统计类型取决于输入赋值栅格值的数据类型，以及通过计算圆形统计数据参数指定的统计数据计算类型。

  如果数据类型为整型，则算术统计数据计算支持平均值、多数、多数计数、多数百分比、最大值、中值、最小值、少数、少数计数、少数百分比、百分位数、范围、标准差、总和及变异度选项。 圆形统计数据计算支持平均值、多数、少数、标准差和变异度选项。

  如果数据类型为浮点型，则算术统计数据计算支持平均值、最大值、中值、最小值、百分位数、范围、标准差及总和选项。 圆形统计数据计算支持平均值和标准差选项。

• 对于多数和少数计算，当存在平局时，输出将为平局值的最低值。

• 要计算圆形统计数据，请选中计算圆形统计数据参数（Python 中的 circular_calculation = "CIRCULAR"），然后为圆换行值（Python 中的 circular_wrap_value）指定值。

• 支持的多维栅格数据集类型包括多维栅格图层、镶嵌、影像服务和 Esri CRF。

• 输出的数据类型（整型或浮点型）取决于所执行的分区计算以及输入值栅格类型。 有关统计数据的具体行为，请参阅分区统计工具的工作原理。

• 默认情况下，如果有多核处理器可用，此工具将最多使用 80%。

  当处理极大量区域时，建议减少所使用的处理核心数量。 要使用不同数量的核心，请使用并行处理因子环境设置。

• 当输出栅格格式为 .crf 时，此工具支持金字塔栅格存储环境。 默认情况下，将在输出中创建金字塔。 对于任何其他输出格式，不支持此环境，并且不会创建金字塔。

参数

• Dialog
• Python

标注	说明	数据类型
输入栅格或要素区域数据	定义区域的数据集。 可通过整型栅格或要素图层来定义区域。	Raster Layer; Feature Layer
区域字段	包含定义每个区域的值的字段。 该字段可以是区域数据集的整型字段或字符串型字段。	Field
输入赋值栅格	包含要计算统计数据的值所在的栅格。	Raster Layer
统计类型 （可选）	用于指定要计算的统计数据类型。 平均值—将计算值栅格中与输出像元同属一个区域的所有像元的平均值。这是默认设置。 多数—将计算值栅格中与输出像元同属一个区域的所有像元中最常出现的值。 多数计数—将计算值栅格中包含多数值且与输出像元属于同一区域的所有像元的频率。 多数百分比—将计算值栅格中包含多数值且与输出像元属于同一区域的像元的百分比。 最大值—将计算值栅格中与输出像元同属一个区域的所有像元的最大值。 中值—将计算值栅格中与输出像元同属一个区域的所有像元的中值。 最小值—将计算值栅格中与输出像元同属一个区域的所有像元的最小值。 少数—将计算值栅格中与输出像元同属一个区域的所有像元中出现次数最少的值。 少数计数—将计算值栅格中包含少数值且与输出像元属于同一区域的所有像元的频率。 少数百分比—将计算值栅格中包含少数值且与输出像元属于同一区域的像元的百分比。 百分位数—将计算值栅格中与输出像元同属一个区域的所有像元的百分比值。 默认情况下将计算 90% 百分比数。 您可以使用百分位值参数来指定其他值（从 0 到 100）。 范围—将计算值栅格中与输出像元同属一个区域的所有像元的最大值与最小值之差。 标准差—将计算值栅格中与输出像元同属一个区域的所有像元的标准差。 总和—将计算值栅格中与输出像元同属一个区域的所有像元的值的总和。 变异度—将计算值栅格中与输出像元同属一个区域的所有像元中唯一值的数目。	String
在计算中忽略 NoData （可选）	指定值输入中的 NoData 值是否在其所在区域的结果中被忽略。 选中—在任意特定区域内，仅使用在输入值栅格中拥有值的像元来确定该区域的输出值。 在统计计算过程中，值栅格内的 NoData 像元将被忽略。 这是默认设置。 未选中—在任何特定区域内，如果赋值栅格中存在 NoData 像元，它们不会被忽略，并且其存在表明没有足够的信息来对该区域中的所有像元执行统计计算。 因此，整个区域将接收 NoData 值。	Boolean
以多维方式处理 （可选）	指定当输入栅格为多维栅格时的计算方式。 选中—则将计算输入多维数据集的所有维度的统计数据。 未选中—将基于输入多维数据集的当前时间片计算统计数据。 这是默认设置。	Boolean
百分位值 （可选）	将要计算的百分比数。 默认值为 90，表示 90%。 取值范围为 0 到 100。 0% 基本上等同于最小值统计数据，而 100% 则等同于最大值。 值 50 所生成的结果基本等同于中值统计数据的结果。 仅当统计类型参数设置为百分位数时，此参数才适用。	Double
百分位插值类型 （可选）	指定当百分位值落在输入赋值栅格中的两个像元值之间时将使用的插值方法。 自动检测—如果输入赋值栅格的像素类型为整型，则将使用最近邻方法。 如果输入赋值栅格的像素类型为浮点型，则将使用线性方法。 这是默认设置。 最近邻—将使用最接近所需的百分位数的可用值。 在这种情况下，输出像素类型与输入值栅格的像素类型相同。 线性—将使用接近所需百分位数的两个值的加权平均值。 在这种情况下，输出像素类型为浮点型。	String
计算圆形统计数据 （可选）	指定如何处理圆形数据的输入栅格。 选中—将计算角度或其他循环量的统计数据，例如以度为单位的罗盘方向、日间时间或实数的小数部分。 未选中—将计算普通线性统计数据。 这是默认设置。	Boolean
圆换行值 （可选）	用于将线性值舍入到给定圆形统计数据范围的值。 它必须为正整数值或浮点值。 默认值为 360 度。 仅当选中计算圆形统计数据参数时，才支持此参数。	Double

返回值

标注	说明	数据类型
输出栅格	输出分区统计栅格。	Raster

环境

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

许可信息

• 基本: 需要 Image Analyst 或 Spatial Analyst
• 标准: 需要 Image Analyst 或 Spatial Analyst
• 高级: 需要 Image Analyst 或 Spatial Analyst

相关主题

• Image Analyst 中的统计工具集概述
• 查找地理处理工具
• 分区统计函数