Skip to main content

频数取值 (Spatial Analyst 工具)

汇总

逐个像元地确定参数列表中具有特定频数级别的值。 特定的频数级别（每个值的出现次数）由第一个参数指定。

插图

频数取值工具的输入和输出值示例

OutRas = Popularity(ValRas, [InRas1, InRas2, InRas3])

用法

  • The tool evaluates the number of occurrences of the input raster values for each location and ranks them on an ordinal scale—也就是说，即出现频率最高、出现频率第二高，依此类推。 它将返回由频数栅格值定义的指定第 n 个最常用值。

  • 在输入栅格列表中，顺序并不重要。 但是，定义频数位置的栅格必须排在这些栅格之前。

  • 可以在输入栅格列表中指定任意数量的栅格。

  • 如果任意像元位置的输入值均相同，则无论指定的频数如何，该像元位置的输出值都将与该位置的输入值相同。

  • 如果任何输入栅格上的某个像元位置包含 NoData，则输出中将为该位置分配 NoData。

  • 如果未找到唯一的第 n 个最常用值，则输出栅格的该位置将被赋予 NoData。 这种情况发生在某一位置的所有输入栅格值均不相同，或者有两个及以上输入栅格值的出现次数相同且该次数恰好是第 n 个最常用值时。 若返回其中一个输入栅格值（例如扫描过程中遇到的第一个值）将会产生误导。 您将无法确定该值是否真正为第 n 个最常用值。

  • 如果频数值大于输入栅格的数量，输出中每个像元位置都将被赋予 NoData。

  • 如果频数值指定为 0，则输出值为 NoData。

  • 频数级别为 1 即为众数值，类似于像元统计工具中的“众数”选项。

  • 如果任何输入栅格为浮点型，则输出将为浮点型；否则，输出将为整型。

  • 如果未选中以多波段方式处理参数（在 Python 中，process_as_multiband 被设置为 SINGLE_BAND），将仅使用多波段输入频数栅格数据或常量值（Python 中的 in_popularity_raster_or_constant）的第一个波段。 来自多波段输入栅格（Python 中的 in_rasters）的每个波段都将作为单波段栅格单独处理。

  • 如果选中了以多波段方式处理参数（在 Python 中，process_as_multiband 设置为 MULTI_BAND），每个多波段栅格输入将被处理为多波段栅格。

    输出中的波段数取决于输入频数栅格数据或常量值。 如果频数栅格是单波段，则输出栅格上的波段数将与来自输入栅格的所有多波段栅格的最大波段数相同。 如果频数栅格是多波段，则输出栅格将具有与频数栅格相同的波段数。

    如果任何输入栅格是波段数少于输出栅格波段数的栅格，则缺失波段将被解释为填充了 NoData 的波段。 如果频数栅格的像元值从缺失波段中选择值一，输出栅格将收到 NoData。 如果任何输入栅格是常量，则将其解释为多波段栅格，其中所有波段的像元值与常量相同，并且波段数与输出栅格相同。

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

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

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

  • 有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。

参数

标注 说明 数据类型

输入频数栅格数据或常量值

用于定义要返回的频数位置的输入栅格。

可将数字用作输入；但是，必须先在环境中设置像元大小和范围。

Raster Layer; Constant

输入栅格

用于为每个像元位置计算值的频数的输入栅格列表。

Raster Layer

以多波段方式处理

（可选）

指定将如何处理输入多波段栅格波段。

  • 选中—每个多波段栅格输入都将作为多波段栅格进行处理。 将使用其他输入的相应波段编号对来自一个输入的每个波段执行该运算。

  • 未选中—来自多波段栅格输入的每个波段将作为单波段栅格单独处理。 这是默认设置。

Boolean

返回值

标注 说明 数据类型

输出栅格

输出栅格。

输出栅格上的每个像元都表示来自满足输入频数值的输入栅格的同一位置的值。

Raster

环境

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

许可信息

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