Python ArcGIS zonal_statistics_as_table用法及代码示例

本文简要介绍 python 语言中 arcgis.raster.analytics.zonal_statistics_as_table 的用法。

用法:

arcgis.raster.analytics.zonal_statistics_as_table(input_zone_raster_or_features, input_value_raster, zone_field, ignore_nodata=True, statistic_type='ALL', percentile_values=[90], process_as_multidimensional=False, percentile_interpolation_type='AUTO_DETECT', output_name=None, context=None, circular_calculation=False, circular_wrap_value=360, *, gis=None, future=False, **kwargs)

返回：

FeatureLayer

计算另一个数据集区域内的栅格值并将结果报告到表中。

Parameter	Description
input_zone_raster_or_features	必需的。定义区域的输入。栅格和要素都可用于区域输入。
input_value_raster	必需的栅格。包含汇总统计数据的值的栅格。
zone_field	必需参数。定义每个区域的字段。它可以是区域数据集的整数或字符串字段。
ignore_nodata	可选的布尔值。表示值输入中的NoData 值是否会影响它们所在区域的结果。 True - 在任何特定区域内，只有在输入值栅格中具有值的像元才会用于确定该区域的输出值。值栅格中的NoData 像元将在统计计算中被忽略。这是默认设置。 False - 在任何特定区域内，如果值栅格中存在任何NoData 个像元，则认为没有足够的信息对该区域内的所有像元进行统计计算；因此，整个区域将在输出栅格上收到 NoData 值。
statistic_type	可选字符串。选择要计算的统计量。值栅格为整数时，可用选项有 ALL、MEAN、MAJORITY、MAXIMUM、MEDIAN、MINIMUM、MINORITY、PERCENTILE、RANGE、STD、SUM、VARIETY、MIN_MAX、MEAN_STD 和MIN_MAX_MEAN。 如果值 raster 为浮点数，则选项为 ALL、MEAN、MAXIMUM、MINIMUM、RANGE、STD 和 SUM。 ALL - 将计算所有统计信息。这是默认设置。 MEAN - 计算要汇总的栅格层中与输出像元属于同一区域的所有像元的平均值。 MAJORITY - 确定要汇总的栅格图层中与输出像元属于同一区域的所有像元中最常出现的值。 MAXIMUM - 确定要汇总的栅格层中与输出像元属于同一区域的所有像元的最大值。 MEDIAN -确定要汇总的栅格层中与输出像元属于同一区域的所有像元的中值。 MINIMUM - 确定要汇总的栅格层中与输出像元属于同一区域的所有像元的最小值。 MINORITY - 确定要汇总的栅格图层中与输出像元属于同一区域的所有像元中出现频率最低的值。 PERCENTILE - 计算值栅格中与输出像元属于同一区域的所有像元的百分位数。默认情况下计算第 90 个百分位数。您可以使用 Percentile Values 参数指定其他值(从 0 到 100)。 RANGE - 计算要汇总的栅格层中与输出像元属于同一区域的所有像元的最大值和最小值之间的差。 STD -计算要汇总的栅格层中与输出像元属于同一区域的所有像元的标准偏差。 SUM - 计算栅格层中要汇总的与输出像元属于同一区域的所有像元的总值。 VARIETY - 计算要汇总的栅格图层中与输出像元属于同一区域的所有像元的唯一值的数量。 MIN_MAX - 计算最小和最大统计数据。 MEAN_STD - 计算均值和标准差统计。 MIN_MAX_MEAN - 计算最小值、最大值和平均值。
percentile_values	双精度值的可选列表。要计算的百分位数。默认值为 90，即第 90 个百分位数。值的范围可以从 0 到 100。第 0 个百分位数本质上等同于最小统计量，第 100 个百分位数等同于最大值。值 50 将产生与中位数统计量基本相同的结果。仅当统计类型参数设置为 PERCENTILE 或 ALL 时，此选项才可用。
process_as_multidimensional	可选 bool，如果输入栅格是多维的，则确定如何处理它们。 False - 将从多维影像服务的当前切片计算统计数据。这是默认设置。 True - 将为多维影像服务的所有维度(例如时间或深度)计算统计信息。
percentile_interpolation_type	可选的字符串。指定当指定的百分位值位于两个输入像元值之间时要使用的插值方法。 AUTO_DETECT - 如果输入值栅格具有整数像素类型，则使用 NEAREST 方法。如果输入值栅格具有浮点像素类型，则使用 LINEAR 方法。这是默认设置。 NEAREST - 与所需百分位数最近的值。 LINEAR - 来自所需百分位数的两个周围值的加权平均值。
circular_calculation	可选布尔值。表示统计计算是算术计算还是循环计算。 False - 计算算术统计数据。这是默认设置。 True - 计算适合循环量的循环统计数据，例如罗盘方向(以度为单位)、白天和实数的小数部分。 ArcGIS Image Server 11 及更高版本中可用的参数。
circular_wrap_value	可选浮点数。循环数据中可能的最高值(上限)。它是一个正数，默认为 360。该值也表示与可能的最低值(下界)相同的数量。仅当 circular_calculation 参数设置为 True 时，才会使用此参数。 ArcGIS Image Server 11 及更高版本中可用的参数。
output_name	可选字符串。要创建的输出特征项或表项的名称。如果未提供，则该方法会生成一个随机名称并用作输出名称。
gis	可选的 GIS 对象。如果未指定，则使用当前活动的连接。
future	仅关键字参数。可选的布尔值。如果为 True，则结果将是一个 GPJob 对象，并且结果将异步返回。
folder	仅关键字参数。可选的 str 或 dict。使用给定的文件夹名称在门户中创建一个文件夹(如果不存在)，并将输出保留在此文件夹中。 create_folder() 返回的字典也可以作为输入传入。 例子： {‘username’: ‘user1’, ‘id’: ‘6a3b77c187514ef7873ba73338cf1af8’, ‘title’: ‘trial’}

例子：

# Usage Example 1: Calculate the values of a raster within defined zones.

zone_data = gis.content.search("my_zone_data")[0].layers[0]
value_raster = gis.content.search("my_value_raster")[0].layers[0]

zonal_stats_table = zonal_statistics_as_table(input_zone_raster_or_features=zone_data,
                                              input_value_raster=value_raster,
                                              zone_field="my_zone_field",
                                              output_name="my_zonal_stats_table",
                                              gis=gis)