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)