返回顶部

分区统计 (Spatial Analyst)

在本主题中

  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息

摘要

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

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

插图

分区统计工具图示
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。

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

  • 默认情况下，如果有多核处理器可用，此工具将使用多核处理。 可供使用的最大核数为四。

    要使用较少的核，请使用并行处理因子环境设置。

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

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

参数

对话框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

ZonalStatistics(in_zone_data, zone_field, in_value_raster, {statistics_type}, {ignore_nodata}, {process_as_multidimensional}, {percentile_value}, {percentile_interpolation_type}, {circular_calculation}, {circular_wrap_value})
名称说明数据类型
in_zone_data

定义区域的数据集。

可通过整型栅格或要素图层来定义区域。

Raster Layer; Feature Layer
zone_field

包含定义每个区域的值的字段。

该字段可以是区域数据集的整型字段或字符串型字段。

Field
in_value_raster

包含要计算统计数据的值所在的栅格。

Raster Layer
statistics_type
(可选)

用于指定要计算的统计数据类型。

  • MEAN—将计算值栅格中与输出像元同属一个区域的所有像元的平均值。这是默认设置。
  • MAJORITY—将计算值栅格中与输出像元同属一个区域的所有像元中最常出现的值。
  • MAJORITY_COUNT—将计算值栅格中包含众数值且与输出像元属于同一区域的所有像元的频率。
  • MAJORITY_PERCENT—将计算值栅格中包含众数值且与输出像元属于同一区域的像元的百分比。
  • MAXIMUM—将计算值栅格中与输出像元同属一个区域的所有像元的最大值。
  • MEDIAN—将计算值栅格中与输出像元同属一个区域的所有像元的中值。
  • MINIMUM—将计算值栅格中与输出像元同属一个区域的所有像元的最小值。
  • MINORITY—将计算值栅格中与输出像元同属一个区域的所有像元中出现次数最少的值。
  • MINORITY_COUNT—将计算值栅格中包含少数值且与输出像元属于同一区域的所有像元的频率。
  • MINORITY_PERCENT—将计算值栅格中包含少数值且与输出像元属于同一区域的像元的百分比。
  • PERCENTILE—将计算值栅格中与输出像元同属一个区域的所有像元的百分比值。 默认情况下将计算 90% 百分比数。 您可以使用百分比值参数来指定其他值（从 0 到 100）。
  • RANGE—将计算值栅格中与输出像元同属一个区域的所有像元的最大值与最小值之差。
  • STD—将计算值栅格中与输出像元同属一个区域的所有像元的标准差。
  • SUM—将计算值栅格中与输出像元同属一个区域的所有像元的值的总和。
  • VARIETY—将计算值栅格中与输出像元同属一个区域的所有像元中唯一值的数目。
String
ignore_nodata
(可选)

指定值输入中的 NoData 值是否在其所在区域的结果中被忽略。

  • DATA—在任意特定区域内，仅使用在输入值栅格中拥有值的像元来确定该区域的输出值。 在统计计算过程中，值栅格内的 NoData 像元将被忽略。 这是默认设置。
  • NODATA—在任何特定区域内，如果赋值栅格中存在 NoData 像元，它们不会被忽略，并且其存在表明没有足够的信息来对该区域中的所有像元执行统计计算。 因此，整个区域将接收 NoData 值。
Boolean
process_as_multidimensional
(可选)

指定当输入栅格为多维栅格时的计算方式。

  • CURRENT_SLICE—将基于输入多维数据集的当前时间片计算统计数据。 这是默认设置。
  • ALL_SLICES—则将计算输入多维数据集的所有维度的统计数据。
Boolean
percentile_value
(可选)

将要计算的百分比数。 默认值为 90，表示 90%。

取值范围为 0 到 100。 0% 基本上等同于最小值统计数据，而 100% 则等同于最大值。 值 50 所生成的结果基本等同于中值统计数据的结果。

仅当 statistics_type 参数设置为 PERCENTILE 时，系统才支持此参数。

Double
percentile_interpolation_type
(可选)

指定当百分位值落在输入赋值栅格中的两个像元值之间时将使用的插值方法。

  • AUTO_DETECT—如果输入值栅格的像素类型为整型，则将使用 NEAREST 方法。 如果输入值栅格的像素类型为浮点型，则将使用 LINEAR 方法。 这是默认设置。
  • NEAREST—将使用最接近所需的百分位数的可用值。 在这种情况下，输出像素类型与输入值栅格的像素类型相同。
  • LINEAR—将使用接近所需百分位数的两个值的加权平均值。 在这种情况下，输出像素类型为浮点型。
String
circular_calculation
(可选)

指定如何处理圆形数据的输入栅格。

  • ARITHMETIC—将计算普通线性统计数据。 这是默认设置。
  • CIRCULAR—将计算角度或其他循环量的统计数据，例如以度为单位的罗盘方向、日间时间或实数的小数部分。
Boolean
circular_wrap_value
(可选)

用于将线性值舍入到给定圆形统计数据范围的值。 它的值必须为正整数值或浮点值。 默认值为 360 度。

仅当 circular_calculation 参数设置为 CIRCULAR 时，系统才支持此参数。

Double

返回值

名称说明数据类型
out_raster

输出分区统计栅格。

Raster

代码示例

ZonalStatistics 示例 1（Python 窗口）

本示例为各区域确定了值输入栅格中的像元值范围。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZonalStats = ZonalStatistics("zone", "value", "valueraster", "RANGE",
                                "NODATA")
outZonalStats.save("C:/sapyexamples/output/zonestatout")
ZonalStatistics 示例 2（独立脚本）

本示例通过为每个区域计算输入多维值栅格中的最大值来创建多维区域输出。

# Name: ZonalStatistics_Ex_02.py
# Description: Calculates statistics on values of a raster 
#    within the zones of another dataset.
# 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
inZoneData = "zone"
zoneField = "value"
inValueRaster = "valueraster" 

# Execute ZonalStatistics
outZonalStatistics = ZonalStatistics(inZoneData, zoneField, inValueRaster,
                                     "RANGE", "NODATA")

# Save the output 
outZonalStatistics.save("C:/sapyexamples/output/zonestatout2")

环境

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

相关主题

  • 区域分析工具集概述
  • 分区统计函数
  • 汇总范围内的栅格

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 插图
  3. 使用情况
  4. 参数
  5. 环境
  6. 许可信息