ArcMap

管理切片缓存

描述

创建切片缓存或在现有的切片缓存中更新切片。 此工具用于创建切片、替换缺失切片、覆盖过时切片以及删除切片。

使用方法

  • 输入数据源参数值可以是地图；但此文档不能包含地图服务或图像服务。

  • 使用此工具创建切片缓存时，如果未指定感兴趣区域参数值，则将通过栅格的全图范围或地图文档的当前范围创建缓存。

  • 生成的缓存范围可能大于感兴趣区域参数值。 如果出现这种情况，此工具会将数据划分为几个大区域（称为超级切片），之后再将其剪切为指定大小的切片。 如果输入数据源参数值使用抗锯齿，则超级切片为 2,048 x 2,048 像素；否则为 4,096 x 4,096。 如果已指定的感兴趣区域要素与超级切片的边界相交，则将创建整个超级切片。 这意味着，在通过要素类进行缓存能够在节省时间和磁盘空间方面获得实际效果之前，可能需要进行放大。 如果您拥有多个感兴趣区域且其覆盖大部分输入数据源参数值，则由于大部分要素都将与超级切片相交，因此通过要素类进行缓存可能并不会给您带来多大好处。

  • 要在自定义切片方案中创建缓存，请确保在使用此工具前已为源数据集定义了切片方案。 可使用生成切片缓存切片方案工具创建切片方案。

  • 要在“ArcGIS Online 切片方案”中创建缓存，可以为输入切片方案参数指定 ARCGISONLINE_SCHEME。

  • 对于涉及较大地理范围或较大比例的缓存，此工具可能会需要较长的运行时间。 如果取消此工具，将停止切片创建，但不删除现有切片。 这意味着您可以随时取消工具，但如果要在稍候重新运行，则需为管理模式参数指定 RECREATE_EMPTY_TILES，而后工具将从中断位置继续运行。

  • 该工具支持“并行处理”环境设置。

语法

arcpy.management.ManageTileCache(in_cache_location, manage_mode, {in_cache_name}, {in_datasource}, {tiling_scheme}, {import_tiling_scheme}, {scales}, {area_of_interest}, {max_cell_size}, {min_cached_scale}, {max_cached_scale})
参数说明数据类型
in_cache_location

创建缓存数据集所在的文件夹、栅格图层或现有切片缓存的路径。

Folder; Raster Layer
manage_mode

指定将用于管理缓存的模式。

  • RECREATE_ALL_TILES —如果范围发生改变或将图层添加到多图层缓存，则需要更换现有切片并添加新切片。
  • RECREATE_EMPTY_TILES —只对空的切片重新创建。 现有切片将保持不变。
  • DELETE_TILES —将从缓存中删除切片。 缓存文件夹结构不会删除。
String
in_cache_name
（可选）

在缓存位置中待创建的缓存数据集的名称。

String
in_datasource
（可选）

栅格数据集、镶嵌数据集或地图文档。

如果已在 manage_mode 参数中指定 DELETE_TILES，则不需要此参数。

ArcMap 文档 (.mxd) 不能包含地图服务或图像服务。

ArcMap Document; Mosaic Layer; Raster Layer
tiling_scheme
（可选）

指定将使用的切片方案。

  • ARCGISONLINE_SCHEME —将使用默认 ArcGIS Online 切片方案。
  • IMPORT_SCHEME —将导入并使用现有的切片方案。
  • ARCGISONLINE_ELEVATION_SCHEME —将使用高程服务切片方案。
  • WGS84_V2_SCHEME —将使用 WGS84　版本　2　切片方案。
String
import_tiling_scheme
（可选）

现有方案文件 (.xml) 的路径或从现有影像服务或地图服务中导入的切片方案。

Image Service; Map Server; File
scales
[scale,...]
（可选）

一系列比例级别，将在这些比例级别上创建或删除切片，具体取决于 manage_mode 参数的值。 像素大小将基于切片方案的空间参考。

  • 默认情况下，生成缓存时将仅使用 min_cached_scale 和 max_cached_scale 的值。
  • 更改 min_cached_scale 或 max_cached_scale 参数的值将更改生成缓存时所使用的比例。
  • 生成缓存时将忽略不在 min_cached_scale 或 max_cached_scale 参数值范围之内的现有比例。
Double
area_of_interest
（可选）

定义感兴趣区以对将创建或删除的切片进行约束。

它可能是一个要素类，也可能是以交互方式定义的要素集。

该参数用于为形状不规则的区域管理切片。 当您要对某些区域进行预缓存或让较少访问的区域保持未缓存的状态时，这也同样有用。

Feature Set
max_cell_size
（可选）

用于定义生成了缓存的数据源的可见性的值。 默认情况下，该值为空。

如果该值为空，则以下适用：

  • 对于数据源可见性范围内的缓存级别，缓存是由数据源生成的。
  • 对于超出数据源可见性范围的缓存级别，缓存是由前一级缓存生成的。

如果该值大于零，则以下适用：

  • 对于像元大小小于等于最大源像元大小 (max_cell_size) 的级别，缓存是由数据源生成的。
  • 对于源像元大小大于最大源像元大小 (max_cell_size) 的级别，缓存是由前一级缓存生成的。

最大源像元大小值的单位应与源数据集的像元大小单位相同。

Double
min_cached_scale
（可选）

创建切片的最小比例。 这不必是切片方案中的最小比例。 由最小缓存比例确定生成缓存时将使用哪个比例。

Double
max_cached_scale
（可选）

创建切片的最大比例。 这不必是切片方案中的最大比例。 由最大缓存比例确定生成缓存时将使用哪个比例。

Double

派生输出

名称说明数据类型
out_cache_location

将在输出缓存位置中创建的缓存数据集。

Raster Dataset

代码示例

管理切片缓存 (ManageTileCache) 示例 1（Python 窗口）

这是 ManageTileCache 工具的 Python 示例。

import arcpy
            
arcpy.ManageTileCache_management(
      "C:/CacheDatasets/Manage", "RECREATE_ALL_TILES", "Test",
      "C:/Data/Cache.gdb/Md", "IMPORT_SCHEME", "C:/Data/Cache.gdb/Md",
      "#", "#", "#", "40000", "2000")
ManageTileCache 示例 2（独立脚本）

这是 ManageTileCache 工具的 Python 脚本。

#Generate tile cache for 3 out of 5 levels defined in tiling scheme

import arcpy

folder = "C:/Workspace/CacheDatasets/Manage"
mode = "RECREATE_ALL_TILES"
cacheName = "Test"
dataSource = "C:/Workspace/Cache.gdb/md"
method = "IMPORT_SCHEME"
tilingScheme = "C:/Workspace/Schemes/Tilingscheme.xml"
scales = "16000;8000;4000;2000;1000"
areaofinterest = "#"
maxcellsize = "#"
mincachedscale = "8000"
maxcachedscale = "2000"

arcpy.ManageTileCache_management(
       folder, mode, cacheName, dataSource, method, tilingScheme,
       scales, areaofinterest, maxcellsize, mincachedscale, maxcachedscale)

环境

  • 并行处理因子

许可信息

  • Basic: 是
  • Standard: 是
  • Advanced: 是

相关主题