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

汇总

根据多个栅格计算每个像元的统计数据。

可用的统计数据包括众数、最大值、平均值、中值、最小值、少数、百分位数、范围、标准差、总和及变异度。

了解有关“像元统计”工作原理的详细信息

插图

OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")

用法

• 使用此工具时输入栅格的顺序不重要。

• 对于最大值、最小值、均值、中位数、众数、少数、百分位数及总和这些统计数据类型，如果将单个栅格数据用作输入，则输出像元值将与输入像元值相同。 对于范围和标准差这些统计数据类型，输出像元值全部为 0。 对于变异度这种统计数据，输出像元值为 1。

• 如果未选中以多波段方式处理参数（Python 中将 process_as_multiband 设置为 SINGLE_BAND），则多波段栅格输入中的每个波段都将分别作为单波段栅格进行处理，且输出将为单波段栅格。

  

  当作为 SINGLE_BAND 进行处理时，“像元统计”工具将创建单波段输出。

• 如果选中了以多波段方式处理参数（在 Python 中，process_as_multiband 设置为 MULTI_BAND），每个多波段栅格输入将作为多波段栅格进行处理，且输出也将为多波段栅格。 如果输入是多波段栅格和常数的组合，则输出也将为多波段栅格。 每个多波段输入中的波段数必须相同。

  该工具将在一个输入的每个波段上使用另一输入的相应波段执行操作。 如果输入之一是多波段栅格，而另一个输入是常量，则该工具将使用多波段输入中每个波段的常量值执行操作。

  

  当作为 MULTI_BAND 进行处理时，“像元统计”工具将创建多波段输出。

• 如果所有输入均为具有相同数量变量的多维栅格数据，则该工具将对具有相同维度值的所有剖切片执行运算。 输出将是 CRF 格式的多维栅格。 输入中的变量必须至少具有一个常见维度和一个常见维度值以供此工具进行处理，否则将发生错误。

  如果所有输入均具有一个变量但名称不同，请在执行运算之前取消选中匹配多维变量地理处理环境（在 Python 中设置 arcpy.env.matchMultidimensionalVariable = False）。

  如果其中一个或多个输入为多维栅格，而其他输入为常量，则该工具将使用常量值对所有变量的所有剖切片执行运算，并且输出将为多维栅格。

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

• 当输入栅格具有矩形像元时，将对其进行处理，以确保输出栅格像元将为正方形，其边长等于矩形像元长度和宽度的平均值。

参数

• Dialog
• Python

标注	说明	数据类型
输入栅格或常量值	将在分析窗口中，为每个像元计算统计运算的输入栅格列表。 可将数字用作输入；但是，必须先在环境中设置像元大小和范围。 如果选中了以多波段方式处理参数，则所有多波段输入都必须具有相同数量的波段。	Raster Layer; Constant
叠加统计 （可选）	用于指定要计算的统计数据类型。 平均值—系统将计算输入的平均值。 这是默认设置。 众数—系统将确定输入的众数（出现次数最多的值）。 最大值—系统将确定输入的最大值。 中值—系统将计算输入的中值。 最小值—系统将确定输入的最小值。 少数—系统将确定输入的少数（出现次数最少的值）。 百分位数—将计算输入的百分比数。 默认情况下将计算 90% 百分比数。 您可以使用百分位值参数来指定其他值（从 0 到 100）。 范围—系统将计算输入的范围（最大值和最小值之差）。 标准差—系统将计算输入的标准差。 总和—系统将计算输入的总和（所有值的总和）。 变异度—系统将计算输入的变异度（唯一值的数量）。	String
在计算中忽略 NoData （可选）	指定在进行统计计算时是否将忽略 NoData 值。 选中—在处理像元位置处，如果任意输入栅格具有 NoData，则将忽略该 NoData 值。 仅考虑具有有效数据的像元来计算统计数据。 这是默认设置。 未选中—如果任意输入栅格的处理像元位置为 NoData，则该像元的输出将为 NoData。	Boolean
以多波段方式处理 （可选）	指定将如何处理输入多波段栅格波段。 选中—每个多波段栅格输入都将作为多波段栅格进行处理。 将使用其他输入的相应波段编号对来自一个输入的每个波段执行该运算。 未选中—来自多波段栅格输入的每个波段将作为单波段栅格单独处理。 这是默认设置。	Boolean
百分位值 （可选）	将计算的百分比值。 默认值为 90，表示 90%。 值范围可以介于 0 到 100 之间。 0% 基本上等同于最小值统计数据，而 100% 则等同于最大统计数据。 值 50 所生成的结果基本等同于中值统计数据的结果。 仅在将叠加统计参数参数设置为百分位数时，此参数才可用。	Double
百分位数插值类型 （可选）	指定当指定的百分比值介于两个输入像元值之间时将使用的插值方法。 自动检测—如果输入栅格的像素类型为整型，则将使用最近邻方法。 如果输入栅格的像素类型为浮点型，则将使用线性方法。 这是默认设置。 最近邻—将使用最接近所需的百分位数的可用值。 在这种情况下，输出像素类型与输入栅格的像素类型相同。 线性—使用接近百分比数的两个值的加权平均值。 在本例中，输出像素类型为浮点型。	String

返回值

标注	说明	数据类型
输出栅格	输出栅格。 对于各个像元，可通过将指定统计数据类型应用到该位置处的输入栅格来确定该值。	Raster

环境

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

许可信息

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

相关主题

• Image Analyst 中的统计工具集概述
• 查找地理处理工具
• 像元统计数据函数