频数取值 (Spatial Analyst)

需要 Spatial Analyst 许可。

摘要

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

插图

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

使用情况

• 该工具为每个位置计算输入栅格数据值的出现次数，然后排定它们的等级顺序，即，最高频数、次高频数，依此类推。 它将返回由频数栅数据格值定义的指定第 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。 如果任何输入栅格是常量，则将其解释为波段栅格，其中所有波段的像元值与常量相同，并且波段数与输出栅格相同。

• 在 ArcPy 中，如果所有输入均为具有相同数量变量的多维栅格，则该工具将对具有相同维度值的所有切片执行运算，并且输出将为多维栅格。 输入中的变量必须具有相同维度或常见维度。

  如果所有输入均是具有一个变量但名称不同的多维栅格，请将 matchMultidimensionalVariable 地理处理环境设置为 False 以执行该运算。

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

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

参数

对话框

标注	说明	数据类型
输入频数栅格数据或常量值	用于定义要返回的频数位置的输入栅格。 数字可以作为输入，但是必须先在环境中设置像元大小和范围。	Raster Layer; Constant
输入栅格	用于为每个像元位置计算值的频数的输入栅格列表。	Raster Layer
以多波段方式处理 (可选)	指定如何处理输入多波段栅格波段。 未选中 - 来自多波段栅格输入的每个波段将被单独处理为单波段栅格。 这是默认设置。 选中 - 每个多波段栅格输入都将作为多波段栅格进行处理。 将使用其他输入的相应波段数对一个输入的每个波段执行操作。	Boolean

返回值

标注	说明	数据类型
输出栅格	输出栅格。 输出栅格上的每个像元都表示来自满足输入频数值的输入栅格的同一位置的值。	Raster

Python

Popularity(in_popularity_raster_or_constant, in_rasters, {process_as_multiband})

名称	说明	数据类型
in_popularity_raster_or_constant	用于定义要返回的频数位置的输入栅格。 数字可以作为输入，但是必须先在环境中设置像元大小和范围。	Raster Layer; Constant
in_rasters [in_raster,...]	用于为每个像元位置计算值的频数的输入栅格列表。	Raster Layer
process_as_multiband (可选)	指定如何处理输入多波段栅格波段。 SINGLE_BAND—来自多波段栅格输入的每个波段将被单独处理为单波段栅格。 这是默认设置。 MULTI_BAND—每个多波段栅格输入都将作为多波段栅格进行处理。 将使用其他输入的相应波段数对一个输入的每个波段执行操作。	Boolean

返回值

名称	说明	数据类型
out_raster	输出栅格。 输出栅格上的每个像元都表示来自满足输入频数值的输入栅格的同一位置的值。	Raster

代码示例

Popularity 示例 1（Python 窗口）

此示例对多个输入栅格数据执行频数取值操作，并以 IMG 栅格数据的形式输出结果。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPopularity = Popularity("cost", ["degs", "negs", "fourgrd"])
outPopularity.save("C:/sapyexamples/output/outpop.img")

Popularity 示例 2（独立脚本）

此示例对多个输入栅格数据执行频数取值操作，并以 Grid 栅格数据的形式输出结果。

# Name: Popularity_Ex_02.py
# Description: Determines the value in an argument list that is
#              at a certain level of popularity 
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inPopularityRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Execute Popularity
outPopularity = Popularity(inPopularityRaster, [inRaster01, inRaster02, inRaster03])

# Save the output 
outPopularity.save("C:/sapyexamples/output/outpop")

环境

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

许可信息

• Basic: 需要 Spatial Analyst
• Standard: 需要 Spatial Analyst
• Advanced: 需要 Spatial Analyst