分区特征 (Spatial Analyst 工具)
汇总
汇总另一数据集分区内的多个栅格数据值,并以表的形式报告结果。
用法
以下是该工具的示例应用:
计算不同生态系统区域的平均降雨量、最高温度和人口总数,以估计可持续农业实践。
估算每个图的平均海拔、平均坡度和 NDVI 值总和,以确定适合种植遮荫树的区域。
分区定义为输入中具有相同值的所有区域。 各区域无需相连。 栅格和要素都可用于区域输入。
如果输入栅格或要素区域(Python 中的
in_zone_raster_or_features)参数值是栅格,则它必须是整型栅格。如果输入栅格或要素区域参数值为要素,则将使用像元大小最小的输入值栅格(Python 中的
in_value_rasters_statistics)参数值的像元大小、像元对齐和空间参考在内部将其转换为栅格,除非在分析环境中另有规定。 这将在执行分区操作之前触发内部重采样。如果输入栅格或要素区域参数值为要素,则对于任何不与值栅格的任何像元中心重叠的区域要素,这些区域将不会转换为内部区域栅格。 因此,这些区域将不会在输出中表示。 您可以通过为保留要素区域所需细节层次的像元大小环境指定适当的值来管理这些区域并在分析环境中指定这些区域。
如果输入栅格或要素区域值是点要素,则输入值栅格的任何特定像元中可能包含多个点。 对于这样的像元,分区值将通过具有最低 ObjectID 字段的点(例如
OID或FID)来确定。如果输入栅格或要素区域值具有重叠要素,则将针对每个单独的要素执行区域分析。
当输入栅格或要素区域和输入值栅格参数值的像元大小不同时,将使用具有最小像元大小的输入值栅格参数值的像元大小、像元对齐和空间参考,除非在分析环境中另有说明。 这将在执行分区操作之前触发内部重采样。
如果区域输入和值输入均为具有相同像元大小的栅格,并且像元已对齐,则可将其直接应用于工具中,且工具处理期间不会对其进行内部重采样。
在指定输入栅格或要素区域值时,默认区域字段(Python 中的
zone_field)参数值将为要素的第一个可用的整型字段(例如OID或FID),以及栅格的VALUE字段。 区域字段可以是整型或字符串字段类型。支持的统计数据类型取决于输入值栅格参数值的数据类型,以及通过计算圆形统计数据参数值指定的统计数据计算类型。
如果数据类型为整型,则算术统计数据计算支持平均值、多数、多数计数、多数百分比、最大值、中值、最小值、少数、少数计数、少数百分比、百分位数、范围、标准差、总和及变异度选项。 圆形统计数据计算支持平均值、多数、少数、标准差和变异度选项。
如果数据类型为浮点型,则算术统计数据计算支持平均值、最大值、中值、最小值、百分位数、范围、标准差及总和选项。 圆形统计数据计算支持平均值和标准差选项。
对于多数和少数计算,当存在平局时,输出将为平局值的最低值。
要为每个值栅格计算多种统计数据类型,需要多次指定相同的值栅格。 如果相同的值栅格和统计数据类型组合重复,工具将生成错误。
要计算圆形统计数据,请选中计算圆形统计数据参数(Python 中的
circular_calculation = "CIRCULAR"),然后为圆换行值参数(Python 中的circular_wrap_value)指定值。如果选中计算圆形统计数据参数,则将为所有应用了指定圆换行值的值栅格计算圆形统计数据。
支持的多维栅格数据集类型包括多维栅格图层、镶嵌、影像服务和 Esri CRF。
处理多维栅格的所有切片时,若输出格式为 DBF 或 SHP,输出统计表和输出统计数据要素类参数仅包含日期信息,不包含时间信息。 若输出格式为 FGDB,则输出表和要素类将在
Standard Time字段中同时包含时间和日期信息。输出统计表(Python 中的
out_statistics_table)参数值具有以下特征:输出表中的行数与分析范围中的区域数相同。
输出表中将创建一系列字段来表示区域,其中包含每个输入值栅格和统计类型参数值的计数和统计数据值。
默认情况下,字段名称来自值栅格名称和统计数据类型,除非在字段名称参数中指定。 对于圆形统计数据,字段名称将在指定统计数据之前包含
C_。 例如,算术平均统计的字段名称为ValueRasterName_MEAN,圆平均值统计的字段名称为ValueRasterName_C_MEAN。输出表中字段名称的最大长度取决于工作空间。
输出表中项目的每个值的数据类型取决于正在执行的区域计算。 有关统计数据的具体行为,请参阅分区统计工具的工作原理。
对于输出统计数据要素类(Python 中的
out_statistics_features)参数值,如果区域输入是栅格,则输出要素类将转换为不经过概化并遵循分析环境的要素。如果区域输入是包含非连续区域的栅格,该工具将在输出统计数据要素类中创建单部件面。 输出统计数据要素类将包含与输出统计数据表中计算的相同统计数据,这些统计数据会附加到相应区域的每个单部件面上。
此工具将使用以下环境设置:
像元大小最小的值栅格将默认用作分析像元大小、输出坐标系和捕捉栅格。
默认范围是区域与所有值栅格的并集的交点。
默认情况下,如果有多核处理器可用,此工具将最多使用 80%。
当处理极大量区域时,建议减少所使用的处理核心数量。 要使用不同数量的核心,请使用并行处理因子环境设置。
有关适用于此工具的地理处理环境的详细信息,请参阅分析环境和 Spatial Analyst。
参数
| 标注 | 说明 | 数据类型 |
|---|---|---|
|
输入栅格或要素区域 |
定义区域的数据集。 可通过整型栅格或要素图层来定义区域。 |
Raster Layer; Feature Layer |
|
输入值栅格 |
栅格的集合,其各个值将通过统计数据进行汇总。 将针对每个输入值栅格中所有与输出像元属于同一区域的像元计算统计数据。 输出统计表中的字段名称将默认从值栅格名称和统计类型中获取。 值表列:
|
Value Table |
|
输出统计表 |
将包含所有值栅格的每个区域中值的汇总的输出表。 表的格式将由输出位置和路径确定。 默认情况下,输出将为地理数据库工作空间中的地理数据库表,和文件工作空间中的 dBASE 表。 |
Table |
|
输出统计数据要素类 (可选) |
通过将输出表连接到输入区域数据来创建的输出要素类。 |
Feature Class |
|
区域字段 (可选) |
包含定义每个区域的值的字段。 该字段可以是区域数据集的整型字段或字符串型字段。 |
Field |
|
在计算中忽略 NoData (可选) |
指定值输入中的 NoData 值是否在其所在区域的结果中被忽略。
|
Boolean |
|
百分位值 (可选) |
将要计算的百分比数。 默认值为 90,表示 90%。 取值范围为 0 到 100。 0% 基本上等同于最小值统计数据,而 100% 则等同于最大值。 值 50 所生成的结果基本等同于中值统计数据的结果。 仅当统计类型参数设置为百分位数或全部时,此参数才适用。 |
Double |
|
百分位插值类型 (可选) |
指定当百分位值落在输入赋值栅格中的两个像元值之间时将使用的插值方法。
|
String |
|
计算圆形统计数据 (可选) |
指定如何处理圆形数据的输入栅格。
|
Boolean |
|
圆换行值 (可选) |
用于将线性值舍入到给定圆形统计数据范围的值。 它必须为正整数值或浮点值。 默认值为 360 度。 仅当选中计算圆形统计数据参数时,才支持此参数。 |
Double |
|
以多维方式处理 (可选) |
指定当输入栅格为多维栅格时的计算方式。
|
Boolean |
|
将区域属性追加到输出要素 (可选) |
指定是否将输入区域的任何其他区域属性追加到输出要素类。
|
Boolean |
环境
自动提交, 像元大小, 像元大小投影方法, 压缩, 当前工作空间, 范围, 地理变换, 掩膜, 输出配置关键字, 输出坐标系, 并行处理因子, 维护全限定的字段名, 临时工作空间, 捕捉栅格, 分块大小, 传递字段属性域描述
许可信息
- 基本: 需要 Spatial Analyst
- 标准: 需要 Spatial Analyst
- 高级: 需要 Spatial Analyst