Python ArcGIS Raster.save用法及代碼示例

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

用法:

save(output_name=None, for_viz=False, process_as_multidimensional=None, build_transpose=None, gis=None, future=False, **kwargs)

返回：

表示輸出數據位置的字符串

當使用 image_server 引擎運行時，save 方法將此 Raster 作為 ImageryLayer 項持久保存到 GIS 。

如果 for_viz 是 True ，則會創建一個新的 Item ，它使用應用的柵格函數通過動態圖像處理以顯示分辨率進行可視化。如果 for_viz 是 False ，則分布式柵格分析用於通過在輸出影像圖層範圍內以源分辨率應用柵格函數來生成新的柵格信息產品。

注意：

使用 arcpy 引擎運行時，save 將此柵格保存到 output_name 中指定的位置。

Parameter	Description
output_name	可選字符串。 使用image_server 引擎運行時，指定輸出名稱。如果未提供，則該方法會創建影像圖層項目並將其用作輸出。您可以傳入應通過此方法創建的輸出柵格的名稱，以用作工具的輸出。或者，如果 for_viz 為 False，您可以從 GIS 中傳入現有的圖像圖層項來使用它。如果該名稱的圖層已經存在，則會引發 RuntimeError 使用 arcpy 引擎運行時，output_name 是表示輸出位置的名稱字符串。
for_viz	可選布爾值。如果為 True，則創建一個新項目，該項目使用應用的光柵函數，通過動態圖像處理以顯示分辨率進行可視化。如果 for_viz 為 False，則分布式柵格分析用於通過在輸出柵格範圍內以源分辨率應用柵格函數來生成新的柵格信息產品，以用於分析和可視化。 (僅在使用image_server 引擎時可用)
process_as_multidimensional	可選的布爾值。如果輸入是多維柵格，則輸出將被處理為多維，如果設置為 True
build_transpose	可選 bool，如果設置為 true，則轉換輸出多維柵格。僅當 process_as_multidimensional 設置為 True 時才有效
gis	可選 arcgis.gis.GIS 對象。用於保存輸出的 GIS。僅關鍵字參數。 (僅在使用image_server 引擎時可用)
future	可選的布爾值。如果為 True，則結果將是一個 GPJob 對象，並且結果將異步返回。僅關鍵字參數。 (僅在使用image_server 引擎時可用)
folder	可選字符串或字典。使用給定的文件夾名稱在門戶中創建一個文件夾(如果不存在)，並將輸出保留在此文件夾中。 gis.content.create_folder() 返回的字典也可以作為輸入傳入。 (僅在使用image_server 引擎時可用) 例子： {‘username’：‘user1’, ‘id’：‘6a3b77c187514ef7873ba73338cf1af8’, ‘title’：‘trial’}
tiles_only	在ArcGIS Online 中，此函數的默認輸出影像服務將是平鋪影像圖層。 要在 ArcGIS Online 上創建動態影像圖層作為輸出，請將 tiles_only 參數設置為 False。 函數將不支持ArcGIS Enterprise 中的tiles_only 參數，默認情況下會生成動態影像圖層。 (僅在使用image_server 引擎時可用)

例子：

# Usage Example 1: Saves the local raster output to a new location (usecase for arcpy engine rasters)

raster1.save(output_name=r"/path/to/output_location/raster.crf",
             process_as_multidimensional=True)

# Usage Example 2: Saves the raster to the active GIS as an Imagery Layer Item (usecase for image_server engine rasters)

raster2.save(output_name="output_imagery_layer_name",
             folder="my_rasters",
             gis=gis)