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")