Python ArcGIS zonal_statistics_as_table用法及代碼示例

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

用法:

arcgis.raster.analytics.zonal_statistics_as_table(input_zone_raster_or_features, input_value_raster, zone_field, ignore_nodata=True, statistic_type='ALL', percentile_values=[90], process_as_multidimensional=False, percentile_interpolation_type='AUTO_DETECT', output_name=None, context=None, circular_calculation=False, circular_wrap_value=360, *, gis=None, future=False, **kwargs)

返回：

FeatureLayer

計算另一個數據集區域內的柵格值並將結果報告到表中。

Parameter	Description
input_zone_raster_or_features	必需的。定義區域的輸入。柵格和要素都可用於區域輸入。
input_value_raster	必需的柵格。包含匯總統計數據的值的柵格。
zone_field	必需參數。定義每個區域的字段。它可以是區域數據集的整數或字符串字段。
ignore_nodata	可選的布爾值。表示值輸入中的NoData 值是否會影響它們所在區域的結果。 True - 在任何特定區域內，隻有在輸入值柵格中具有值的像元才會用於確定該區域的輸出值。值柵格中的NoData 像元將在統計計算中被忽略。這是默認設置。 False - 在任何特定區域內，如果值柵格中存在任何NoData 個像元，則認為沒有足夠的信息對該區域內的所有像元進行統計計算；因此，整個區域將在輸出柵格上收到 NoData 值。
statistic_type	可選字符串。選擇要計算的統計量。值柵格為整數時，可用選項有 ALL、MEAN、MAJORITY、MAXIMUM、MEDIAN、MINIMUM、MINORITY、PERCENTILE、RANGE、STD、SUM、VARIETY、MIN_MAX、MEAN_STD 和MIN_MAX_MEAN。 如果值 raster 為浮點數，則選項為 ALL、MEAN、MAXIMUM、MINIMUM、RANGE、STD 和 SUM。 ALL - 將計算所有統計信息。這是默認設置。 MEAN - 計算要匯總的柵格層中與輸出像元屬於同一區域的所有像元的平均值。 MAJORITY - 確定要匯總的柵格圖層中與輸出像元屬於同一區域的所有像元中最常出現的值。 MAXIMUM - 確定要匯總的柵格層中與輸出像元屬於同一區域的所有像元的最大值。 MEDIAN -確定要匯總的柵格層中與輸出像元屬於同一區域的所有像元的中值。 MINIMUM - 確定要匯總的柵格層中與輸出像元屬於同一區域的所有像元的最小值。 MINORITY - 確定要匯總的柵格圖層中與輸出像元屬於同一區域的所有像元中出現頻率最低的值。 PERCENTILE - 計算值柵格中與輸出像元屬於同一區域的所有像元的百分位數。默認情況下計算第 90 個百分位數。您可以使用 Percentile Values 參數指定其他值(從 0 到 100)。 RANGE - 計算要匯總的柵格層中與輸出像元屬於同一區域的所有像元的最大值和最小值之間的差。 STD -計算要匯總的柵格層中與輸出像元屬於同一區域的所有像元的標準偏差。 SUM - 計算柵格層中要匯總的與輸出像元屬於同一區域的所有像元的總值。 VARIETY - 計算要匯總的柵格圖層中與輸出像元屬於同一區域的所有像元的唯一值的數量。 MIN_MAX - 計算最小和最大統計數據。 MEAN_STD - 計算均值和標準差統計。 MIN_MAX_MEAN - 計算最小值、最大值和平均值。
percentile_values	雙精度值的可選列表。要計算的百分位數。默認值為 90，即第 90 個百分位數。值的範圍可以從 0 到 100。第 0 個百分位數本質上等同於最小統計量，第 100 個百分位數等同於最大值。值 50 將產生與中位數統計量基本相同的結果。僅當統計類型參數設置為 PERCENTILE 或 ALL 時，此選項才可用。
process_as_multidimensional	可選 bool，如果輸入柵格是多維的，則確定如何處理它們。 False - 將從多維影像服務的當前切片計算統計數據。這是默認設置。 True - 將為多維影像服務的所有維度(例如時間或深度)計算統計信息。
percentile_interpolation_type	可選的字符串。指定當指定的百分位值位於兩個輸入像元值之間時要使用的插值方法。 AUTO_DETECT - 如果輸入值柵格具有整數像素類型，則使用 NEAREST 方法。如果輸入值柵格具有浮點像素類型，則使用 LINEAR 方法。這是默認設置。 NEAREST - 與所需百分位數最近的值。 LINEAR - 來自所需百分位數的兩個周圍值的加權平均值。
circular_calculation	可選布爾值。表示統計計算是算術計算還是循環計算。 False - 計算算術統計數據。這是默認設置。 True - 計算適合循環量的循環統計數據，例如羅盤方向(以度為單位)、白天和實數的小數部分。 ArcGIS Image Server 11 及更高版本中可用的參數。
circular_wrap_value	可選浮點數。循環數據中可能的最高值(上限)。它是一個正數，默認為 360。該值也表示與可能的最低值(下界)相同的數量。僅當 circular_calculation 參數設置為 True 時，才會使用此參數。 ArcGIS Image Server 11 及更高版本中可用的參數。
output_name	可選字符串。要創建的輸出特征項或表項的名稱。如果未提供，則該方法會生成一個隨機名稱並用作輸出名稱。
gis	可選的 GIS 對象。如果未指定，則使用當前活動的連接。
future	僅關鍵字參數。可選的布爾值。如果為 True，則結果將是一個 GPJob 對象，並且結果將異步返回。
folder	僅關鍵字參數。可選的 str 或 dict。使用給定的文件夾名稱在門戶中創建一個文件夾(如果不存在)，並將輸出保留在此文件夾中。 create_folder() 返回的字典也可以作為輸入傳入。 例子： {‘username’: ‘user1’, ‘id’: ‘6a3b77c187514ef7873ba73338cf1af8’, ‘title’: ‘trial’}

例子：

# Usage Example 1: Calculate the values of a raster within defined zones.

zone_data = gis.content.search("my_zone_data")[0].layers[0]
value_raster = gis.content.search("my_value_raster")[0].layers[0]

zonal_stats_table = zonal_statistics_as_table(input_zone_raster_or_features=zone_data,
                                              input_value_raster=value_raster,
                                              zone_field="my_zone_field",
                                              output_name="my_zonal_stats_table",
                                              gis=gis)