Python ArcGIS generate_trend_raster用法及代码示例

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

用法:

arcgis.raster.analytics.generate_trend_raster(input_multidimensional_raster, dimension=None, variables=None, trend_line_type='LINEAR', frequency=None, ignore_nodata=True, output_name=None, context=None, cycle_length=None, cycle_unit='YEARS', rmse=True, r2=False, slope_p_value=False, seasonal_period='DAYS', *, gis=None, future=False, **kwargs)

返回：

output_raster：影像图层项目

估计多维栅格中给定变量的维度上每个像素的趋势。 ArcGIS Image Server 10.8 及更高版本中可用的函数。

Parameter	Description
input_multidimensional_raster	必需的 ImageryLayer 对象。输入多维栅格。传送门物品可以通过。
dimension	必需的字符串。为分析中选择的一个或多个变量提取趋势的维度。
variables	可选列表。将为其计算趋势的一个或多个变量。如果未指定变量，则将分析多维栅格中的第一个变量。
trend_line_type	可选字符串。指定用于拟合沿尺寸的像素值的线类型。 LINEAR：沿线性趋势线拟合变量的像素值。这是默认设置。 POLYNOMIAL：沿二阶多项式趋势线拟合变量的像素值。 谐波：沿谐波趋势线拟合变量的像素值。 MANN-KENDALL：可变像素值将使用Mann-Kendall 趋势测试进行评估。 ArcGIS Image Server 10.9 及更高版本中可用的选项。 SEASONAL-KENDALL：可变像素值将使用Seasonal-Kendall 趋势测试进行评估。 ArcGIS Image Server 10.9 及更高版本中可用的选项。
frequency	可选整数。 如果line_type 参数设置为 HARMONIC，则默认值为 1，即每年一个谐波周期。 如果line_type 参数设置为 POLYNOMIAL，则默认值为 2，即二阶多项式。
ignore_nodata	可选布尔值。指定在分析中是否忽略 NoData 值。 True：分析将包括沿给定维度的所有有效像素，并忽略任何 NoData 像素。这是默认设置。 错误：如果沿给定维度的像素有任何 NoData 值，则分析将导致 NoData。
output_name	可选字符串。如果未提供，则由该方法创建影像服务并将其用作输出栅格。您可以从 GIS 中传入现有的影像服务项目来使用它。 或者，您可以传入应通过此方法创建的输出图像服务的名称，以用作工具的输出。 如果该名称的服务已经存在，则会引发 RuntimeError
context	context 包含影响任务执行的其他设置。 context 参数覆盖通过arcgis.env 参数设置的值 此函数具有以下设置： Extent(范围)：定义分析区域的边界框。 例子： {“extent”: {“xmin”: -122.68, “ymin”: 45.53, “xmax”: -122.45, “ymax”: 45.6, “spatialReference”: {“wkid”: 4326}}} 输出空间参考 (outSR)：输出栅格将投影到输出空间参考中。 例子： {“outSR”: {spatial reference}} 捕捉栅格 (snapRaster)：输出栅格的像元将与指定的捕捉栅格对齐。 例子： {‘snapRaster’: {‘url’: ‘<image_service_url>’}} 像元大小(cellSize)：输出栅格将具有由像元大小指定的分辨率。 Example: {‘cellSize’: 11} or {‘cellSize’: {‘url’: <image_service_url>}} or {‘cellSize’: ‘MaxOfIn’} 并行处理因子(parallelProcessingFactor)：控制光栅处理(CPU)服务实例。 例子： 具有指定数量的处理实例的语法示例： {“parallelProcessingFactor”: “2”} 具有指定百分比的总处理实例的语法示例： {“parallelProcessingFactor”: “60%”}
cycle_length	可选浮点数。要建模的周期性变化的长度。当趋势线类型设置为谐波时需要此参数。例如，叶绿度通常在一年内有一个强烈的变化周期，因此周期长度为 1 年。每小时温度数据在一天内有一个强烈的变化周期，因此周期长度为 1 天。在ArcGIS Image Server 10.8.1 及更高版本中可用。
cycle_unit	可选字符串。默认为“YEARS”。指定用于谐波周期长度的时间单位。在ArcGIS Image Server 10.8.1 及更高版本中可用。
rmse	可选布尔值。默认值为真。指定是否计算趋势拟合线的均方根误差 (RMSE)。 ArcGIS Image Server 10.8.1 及更高版本中可用的参数。
r2	可选布尔值。默认值为假。指定是否计算趋势拟合线的 R-squared goodness-of-fit 统计量。 ArcGIS Image Server 10.8.1 及更高版本中可用的参数。
slope_p_value	可选布尔值。默认值为 False。指定是否计算趋势线斜率系数的 p 值统计量。该参数在 ArcGIS Image Server 10.8.1 及更高版本中可用。
seasonal_period	可选字符串。指定季节性时段。默认 - “DAYS” 可能的选项 - “DAYS”、“MONTHS” ArcGIS Image Server 10.9 及更高版本中可用的参数。
gis	仅关键字参数。可选的 GIS 对象。运行该工具的 GIS。如果未指定，则使用活动 GIS。
future	仅关键字参数。可选布尔值。如果为 True，则结果将是一个 GPJob 对象，并且结果将异步返回。
folder	仅关键字参数。可选的 str 或 dict。使用给定的文件夹名称在门户中创建一个文件夹(如果不存在)，并将输出保留在此文件夹中。 create_folder() 返回的字典也可以作为输入传入。 例子： {‘username’: ‘user1’, ‘id’: ‘6a3b77c187514ef7873ba73338cf1af8’, ‘title’: ‘trial’}
tiles_only	仅关键字参数。可选的布尔值。在ArcGIS Online 中，此函数的默认输出影像服务将是平铺影像图层。 要在 ArcGIS Online 上创建动态影像图层作为输出，请将 tiles_only 参数设置为 False。 函数将不支持ArcGIS Enterprise 中的tiles_only 参数，默认情况下会生成动态影像图层。

例子：

# Usage Example 1: This example aggregates temperature data into yearly data with the average temperature values.

trend_coeff_multidim  = generate_trend_raster(input_multidimensional_raster=multidimensional_lyr_input,
                                              variables=["NightLightData"],
                                              dimension="StdTime",
                                              trend_line_type='POLYNOMIAL',
                                              frequency=2,
                                              ignore_nodata=True,
                                              output_name="polynomial_trend_coefficients",
                                              gis=gis,
                                              folder="generate_trend_raster")