获得 Image Analyst 许可后可用。
描述
通过基于维度间隔和聚合方法组合输入多维栅格中的剖切来创建栅格对象。
讨论
使用 Aggregate 函数可根据给定变量聚合多维栅格中的变量值。例如,如果您拥有每日降水量数据,则可以确定月平均降水量值。
此函数可创建一个栅格对象,该栅格对象为输入多维栅格的聚合。默认情况下,系统将计算与给定维度关联的所有变量的聚合。例如,如果降水量、温度和风速都具有时间维度,在将 dimension_name 设置为时间维度的情况下,系统将分别聚合所有三个变量。如果您只想聚合一个变量,请使用 Subset 函数,然后使用 Aggregate。
栅格对象的引用栅格数据集是临时的。要将其设置为永久,可以调用栅格对象的 save 方法。
语法
Aggregate (in_raster, dimension_name, raster_function, {raster_function_arguments}, {aggregation_definition})
参数 | 说明 | 数据类型 |
in_raster | 要聚合的输入多维栅格。 | Raster |
dimension_name | 聚合维度。这是聚合变量时所沿的维度。 | String |
raster_function | 采用字符串形式的栅格函数的名称(例如 Mean、Max、Min、Majority、Minority、Sum 等)或自定义栅格函数的路径(.rft.xml 文件)可用于计算聚合像素值。 | String |
raster_function_arguments | 与栅格函数或函数链关联的参数和值。如果未指定参数和值,则将使用默认值。 | Dictionary |
aggregation_definition | 指定聚合数据的维度间隔。键值对必须遵循以下格式之一:
如果未指定内容,则将聚合跨维度的所有剖切。 | Dictionary |
数据类型 | 说明 |
Raster | 输出聚合多维栅格。 |
代码示例
通过计算总体平均值、月平均值、10 天中的最小值以及 2 个范围中的最大值来聚合降水量数据。
import arcpy
from arcpy.ia import *
arcpy.CheckOutExtension("ImageAnalyst")
in_raster = Raster('ClimateData_Daily.nc', True)
# Choose the precipitation variable
prcp_raster = Subset(in_raster, variables = 'prcp')
# Calculate the average precipitation across the whole time period
avg_prcp = Aggregate(prcp_raster, 'StdTime', 'Mean')
# Calculate the monthly mean precipitation
monthly_avg_prcp = Aggregate(prcp_raster, 'StdTime',
'Mean', {'interval': 'monthly'})
# Calculate the minimum precipitation every 10 days
min_precip_10day = Aggregate(prcp_raster, 'StdTime', 'Min',
{'interval_value' : 10, 'interval_unit': 'day'})
# Calculate the maximum precipitation in two separate time ranges
max_prcp_range = Aggregate(prcp_raster, 'StdTime', 'Max',
{'interval_ranges': [('2001-01-01T00:00:00', '2001-02-01T00:00:00'),
('2001-12-01T00:00:00', '2001-12-24T00:00:00')]})