Python ArcGIS summarize_categorical_raster用法及代碼示例

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

用法:

arcgis.raster.analytics.summarize_categorical_raster(input_categorical_raster, dimension=None, area_of_interest=None, area_of_interest_id_field=None, output_summary_table_name=None, context=None, *, gis=None, future=False, **kwargs)

返回：

要素圖層

生成一個表，其中包含輸入分類柵格的每個切片中每個類的像素計數。該函數在 ArcGIS Image Server 10.9.1 及更高版本中可用(在 ArcGIS Online 中不可用)。

Parameter	Description
input_from_raster	必需的 ImageryLayer 對象。要匯總的多維分類柵格。
dimension	可選字符串。用於摘要的維度的名稱。如果有多個維度且未指定值，則將使用維度值的所有組合匯總所有切片。
area_of_interest	可選的 FeatureLayer 對象。包含計算每個類別的像素計數時要使用的一個或多個感興趣區域的麵要素圖層。如果未指定感興趣區域，則整個柵格將包含在分析中。
area_of_interest_id_field	可選字符串/整數。定義每個感興趣區域的麵要素圖層中的字段。
output_summary_table_name	可選字符串。要創建的輸出特征項或表項的名稱如果未提供，則該方法生成一個隨機名稱並用作輸出名稱。
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}} 並行處理因子(parallelProcessingFactor)：控製光柵處理(CPU)服務實例。 例子： 具有指定數量的處理實例的語法示例： {“parallelProcessingFactor”: “2”} 具有指定百分比的總處理實例的語法示例： {“parallelProcessingFactor”: “60%”}
gis	可選的地理信息係統。運行此工具的 GIS 。如果未指定，則使用活動 GIS。
future	僅關鍵字參數。可選布爾值。如果為 True，則結果將是一個 GPJob 對象，並且結果將異步返回。
folder	僅關鍵字參數。可選的 str 或 dict。使用給定的文件夾名稱在門戶中創建一個文件夾(如果不存在)，並將輸出保留在此文件夾中。 create_folder() 返回的字典也可以作為輸入傳入。 例子： {‘username’: ‘user1’, ‘id’: ‘6a3b77c187514ef7873ba73338cf1af8’, ‘title’: ‘trial’}

例子：

# Usage Example 1:

my_categorical_raster = gis.content.search("categorical_raster", item_type="Imagery Layer")[0].layers[0]
my_aoi = gis.content.search("area_of_interest_polygon", item_type="Feature Layer")[0].layers[0]

summarize_categorical_raster_op = summarize_categorical_raster(input_categorical_raster=my_categorical_raster,
                                                               dimension="StdTime",
                                                               area_of_interest=my_aoi,
                                                               gis=gis)