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)