Python ArcGIS generate_multidimensional_anomaly用法及代碼示例

本文簡要介紹 python 語言中 arcgis.raster.analytics.generate_multidimensional_anomaly 的用法。

用法:

arcgis.raster.analytics.generate_multidimensional_anomaly(input_multidimensional_raster, variables=None, method='DIFFERENCE_FROM_MEAN', calculation_interval=None, ignore_nodata=True, output_name=None, context=None, reference_mean_raster=None, *, gis=None, future=False, **kwargs)

返回：

output_raster：影像圖層項目

計算多維柵格中每個切片的異常以生成多維數據集。異常是觀測值與其標準值或平均值的偏差。 ArcGIS Image Server 10.8 及更高版本中可用的函數。

Parameter	Description
input_multidimensional_raster	輸入影像圖層對象。
variables	可選列表。將為其計算異常的一個或多個變量。如果未指定變量，則將分析所有具有時間維度的變量。
method	可選字符串。指定將用於計算異常的方法。 DIFFERENCE_FROM_MEAN：將計算像素值與間隔定義的切片中該像素值的平均值之間的差異。這是默認設置。 PERCENT_DIFFERENCE_FROM_MEAN：將計算像素值與間隔定義的切片中該像素值的平均值之間的百分比差異。 PERCENT_OF_MEAN：將計算平均值的百分比。 Z_SCORE：將計算每個像素的z-score。 z-score 為 0 表示像素的值與平均值相同。 z-score 為 1 表示像素的值與平均值相差 1 個標準差。如果 z-score 為 2，則像素值是平均值的 2 個標準差，依此類推。 DIFFERENCE_FROM_MEDIAN：將計算一個像素值與該像素值在由區間定義的切片之間的中值之間的差異 PERCENT_DIFFERENCE_FROM_MEDIAN：將計算像素值與間隔定義的切片中該像素值的中值之間的百分比差異。 PERCENT_OF_MEDIAN：將計算中位數的百分比。
calculation_interval	可選字符串。指定將用於計算平均值的時間間隔。 ALL：計算每個像素的所有切片的平均值。 YEARLY：計算每個像素的年平均值。 RECURRING_MONTHLY：計算每個像素的月平均值。 RECURRING_WEEKLY：計算每個像素的每周平均值。 RECURRING_DAILY：計算每個像素的每日平均值。 HOURLY：計算每個像素的小時平均值。 EXTERNAL_RASTER：引用包含每個像素的平均值或中值的現有柵格數據集。
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)：輸出柵格將具有由像元大小指定的分辨率。 例子： {‘cellSize’: 11} or {‘cellSize’: {‘url’: <image_service_url>}} or {‘cellSize’: ‘MaxOfIn’} 並行處理因子(parallelProcessingFactor)：控製光柵處理(CPU)服務實例。 例子： 具有指定數量的處理實例的語法示例： {“parallelProcessingFactor”: “2”} 具有指定百分比的總處理實例的語法示例： {“parallelProcessingFactor”: “60%”}
reference_mean_raster	表示參考平均柵格的可選影像圖層對象。在ArcGIS Image Server 10.8.1 及更高版本中可用。
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 generates an anomaly multidimensional raster for temperature data, comparing pixel values with the mean
# pixel value across all slices.

generate_anomaly = generate_multidimensional_anomaly(input_multidimensional_raster=multidimensional_lyr_input,
                                                     variables=["oceantemp"],
                                                     method="PERCENT_DIFFERENCE_FROM_MEAN",
                                                     temporal_interval="YEARLY",
                                                     output_name="temp_anomaly",
                                                     ignore_nodata=True,
                                                     gis=gis,
                                                     folder="generate_mdim_anomaly")