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

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

用法:

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

返回：

output_raster - ImageryLayer 項目

save 方法將此影像圖層作為 ImageryLayer 項目保存到 GIS。如果 for_viz 是 True ，則會創建一個新的 Item ，該新的 Item 使用應用的柵格函數通過動態圖像處理以顯示分辨率進行可視化。如果 for_viz 為 False ，則分布式柵格分析用於通過在輸出影像圖層範圍內以源分辨率應用柵格函數來生成新的柵格信息產品。

Parameter	Description
output_name	可選字符串。如果未提供，則該方法會創建影像圖層項目並將其用作輸出。您可以傳入應通過此方法創建的輸出影像圖層的名稱，以用作工具的輸出。或者，如果 for_viz 為 False，您可以從 GIS 中傳入現有的圖像圖層項來使用它。如果該名稱的圖層已經存在，則會引發 RuntimeError
for_viz	可選的布爾值。如果為 True，則創建一個新項目，該項目使用應用的柵格函數通過動態圖像處理以顯示分辨率進行可視化。如果 for_viz 為 False，則分布式柵格分析用於生成新的柵格信息產品以用於分析和可視化，方法是在輸出影像圖層範圍內以源分辨率應用柵格函數。
process_as_multidimensional	可選的布爾值。如果輸入是多維柵格，則輸出將被處理為多維，如果設置為 True
build_transpose	可選 bool，如果設置為 true，則轉換輸出多維柵格。僅當 process_as_multidimensional 設置為 True 時才有效
context	context 包含影響任務執行的其他設置。 context 參數覆蓋通過arcgis.env 參數設置的值 此函數具有以下設置： Extent (extent): A bounding box that defines the analysis area. Example: {“extent”: {“xmin”: -122.68, “ymin”: 45.53, “xmax”: -122.45, “ymax”: 45.6, “spatialReference”: {“wkid”: 4326}}} Output Spatial Reference (outSR): The output raster will be projected into the output spatial reference. Example: {“outSR”: {spatial reference}} Snap Raster (snapRaster): The output raster will have its cells aligned with the specified snap raster. Example: {‘snapRaster’: {‘url’: ‘<image_service_url>’}} Mask (mask): Only cells that fall within the analysis mask will be considered in the operation. Example: {“mask”: {“url”: “<image_service_url>”}} Cell Size (cellSize): The output raster will have the resolution specified by cell size. Example: {‘cellSize’: 11} or {‘cellSize’: {‘url’: <image_service_url>}} or {‘cellSize’: ‘MaxOfIn’} Parallel Processing Factor (parallelProcessingFactor): controls Raster Processing (CPU) service instances. Example: Syntax example with a specified number of processing instances: {“parallelProcessingFactor”: “2”} Syntax example with a specified percentage of total processing instances: {“parallelProcessingFactor”: “60%”} Resampling Method (resamplingMethod): The output raster will be resampled to method specified. The supported values are: BILINEAR, NEAREST, CUBIC. Example: {‘resamplingMethod’: “NEAREST”}
gis	可選的 GIS 對象。用於保存輸出的 GIS。僅關鍵字參數。
future	可選布爾值。如果為 True，則將返回 future 對象，並且進程不會等待任務完成。默認為False，表示等待結果。
folder	可選字符串或字典。使用給定的文件夾名稱在門戶中創建一個文件夾(如果不存在)，並將輸出保留在此文件夾中。 gis.content.create_folder() 返回的字典也可以作為輸入傳入。 例子： {‘username’：‘user1’, ‘id’：‘6a3b77c187514ef7873ba73338cf1af8’, ‘title’：‘trial’}
tiles_only	在ArcGIS Online 中，此函數的默認輸出影像服務將是平鋪影像圖層。 要在 ArcGIS Online 上創建動態影像圖層作為輸出，請將 tiles_only 參數設置為 False 。 函數將不支持ArcGIS Enterprise 中的tiles_only 參數，默認情況下會生成動態影像圖層。

例子：

# Usage Example

img_lyr.save(output_name="saved_imagery_layer",
             process_as_multidimensional=True,
             build_transpose=True,
             folder="my_imagery_layers",
             gis=gis)