Python ArcGIS find_argument_statistics用法及代碼示例

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

用法:

arcgis.raster.analytics.find_argument_statistics(input_raster, dimension=None, dimension_definition='ALL', interval_keyword=None, variables=None, statistics_type='ARGUMENT_MIN', min_value=None, max_value=None, multiple_occurrence_value=None, ignore_nodata=True, output_name=None, context=None, argument_value=None, comparison='EQUAL_TO', occurrence='FIRST_OCCURRENCE', *, gis=None, future=False, **kwargs)

返回：

output_raster：影像圖層項目

提取在多維柵格中為每個像素獲得給定統計信息的維度值。 ArcGIS Image Server 10.8 及更高版本中可用的函數。

Parameter	Description
input_raster	必需的 ImageryLayer 對象。輸入柵格。傳送門物品可以通過。
dimension	必需的字符串。從中提取統計信息的維度。如果輸入柵格不是多維柵格，則不需要此參數。
dimension_definition	必需的字符串。指定將分析數據的維度間隔。 ALL：將跨所有切片分析數據值。這是默認設置。 INTERVAL_KEYWORD：變量數據將使用眾所周知的區間進行分析。 例子： ‘ALL’
interval_keyword	必需的字符串。指定沿維度分析時將使用的關鍵字區間。當dimension_definition參數設置為INTERVAL_KEYWORD時需要該參數，並且分析必須是跨時間的。 可能的選項：每小時、每天、每周、每月、每季度、每年、RECURRING_DAILY、RECURRING_WEEKLY、RECURRING_MONTHLY、RECURRING_QUARTERLY
variables	可選列表。要分析的一個或多個變量。如果輸入柵格不是多維的，則將多波段柵格的像素值視為變量。如果輸入柵格是多維的且未指定變量，則將分析具有選定維度的所有變量。 例如，要查找溫度值最高的年份，請將溫度指定為要分析的變量。如果您未指定任何變量並且同時具有溫度和降水變量，則將對這兩個變量進行分析，並且輸出多維柵格將包含這兩個變量。
statistics_type	可選字符串。指定要從給定維度上的一個或多個變量中提取的統計信息。 ARGUMENT_MIN：將提取達到最小變量值的維度值。這是默認設置。 ARGUMENT_MAX：將提取達到最大變量值的維度值。 ARGUMENT_MEDIAN：將提取達到中間變量值的維度值。 DURATION：變量值介於最小值和最大值之間的最長維度持續時間。 ARGUMENT_VALUE：將提取達到指定變量值的尺寸值。
min_value	可選浮點數。用於提取持續時間的最小變量值。 當statistics_type 參數設置為 DURATION 時需要此參數。
max_value	可選浮點數。用於提取持續時間的最大變量值。
multiple_occurrence_value	可選整數。指定用於指示在輸入柵格數據集中多次達到給定參數統計信息的像素值。如果未指定，像素值將是第一次達到參數統計時的維度值。
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%”}
argument_value	可選整數。將進行比較以提取尺寸值的值。當statistics_type參數設置為ARGUMENT_VALUE時，需要此參數。 注意： 該參數目前僅在ArcGIS在線上可用。
comparison	可選字符串。指定將用於提取維度值的比較類型。 EQUAL_TO：提取的維度等於指定值。這是默認設置。 GREATER_THAN：提取的維度大於指定值。 SMALLER_THAN：提取的維度小於指定值。 注意： 該參數目前僅在ArcGIS在線上可用。
occurrence	可選字符串。指定是第一次還是最後一次達到參數統計量時返回維度值。 FIRST_OCCURRENCE：第一次達到參數統計量時將返回維度的值。這是默認設置。 LAST_OCCURRENCE：將返回最後一次達到參數統計量時的維度值。 注意： 該參數目前僅在ArcGIS在線上可用。
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 參數，默認情況下會生成動態影像圖層。

示例 1：

# Usage Example 1: This example finds the minimum precipitation and temperature values across a time series multidimensional raster.
# If the same minimum value is found multiple times, the pixel value will be 99999.

arg_stat_output = arcgis.raster.analytics.find_argument_statistics(input_raster=input_layer,
                                                                          dimension="StdTime",
                                                                          variables=["precip","temp"],
                                                                          statistics_type='ARGUMENT_MIN',
                                                                          multiple_occurrence_value=99999,
                                                                          ignore_nodata=True,
                                                                          output_name="arg_stat_output",
                                                                          gis=gis,
                                                                          folder="find_argument_statistics")

示例 2：

# Usage Example 2: This example finds the longest time interval for which salinity fell between 10 and 15 units of measurement in the multidimensional raster.

arg_stat_output = find_argument_statistics(input_raster=input_layer,
                                           dimension="StdTime",
                                           variables=["salinity"],
                                           statistics_type='DURATION',
                                           min_value=10,
                                           max_value=15,
                                           ignore_nodata=True,
                                           output_name="arg_stat_output",
                                           gis=gis,
                                           folder={'username': 'user1', 'id': '6a3b77c187514ef7873ba73338cf1af8', 'title': 'trial'})