管理切片缓存 (Data Management)

许可等级:BasicStandardAdvanced

摘要

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

用法

语法

ManageTileCache_management (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 Document; Mosaic Layer; Raster Layer
tiling_scheme
(可选)

用于指定切片方案的可选参数。

  • ARCGISONLINE_SCHEME使用默认 ArcGIS Online 切片方案。
  • IMPORT_SCHEME导入现有的切片方案。
String
import_tiling_scheme
(可选)

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

Image Service; MapServer; File
scales
[scale,...]
(可选)

一系列比例级别,运行此工具时将在这些比例级别上创建或删除切片,具体取决于 manage_mode 参数的值。像素大小是根据切片方案的空间参考表示的。

  • 默认情况下,生成缓存时仅使用 min_cached_scalemax_cached_scale 中的比例。
  • 更改 min_cached_scalemax_cached_scale 参数的值将改变生成缓存时所使用的比例。
  • 生成缓存时,将忽略已存在但不在 min_cached_scalemax_cached_scale 范围内的比例。
Double
area_of_interest
(可选)

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

它可能是一个要素类,也可能是在 ArcMap 中以交互方式定义的要素。

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

Feature Set
max_cell_size
(可选)

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

如果该值为空,

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

如果该值大于零,

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

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

Double
min_cached_scale
(可选)

想要创建切片的最小比例。这不必是您的切片方案中的最小比例。最小缓存比例将决定生成缓存时所使用的比例。

Double
max_cached_scale
(可选)

想要创建切片的最大比例。这不必是您的切片方案中的最大比例。最大缓存比例将决定生成缓存时所使用的比例。

Double

代码实例

管理切片缓存 (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)

环境

并行处理因子

如果“并行处理因子”值为空,该工具会以默认值的 50% 运行(可用核的一半)。

相关主题

许可信息

ArcGIS for Desktop Basic: 是
ArcGIS for Desktop Standard: 是
ArcGIS for Desktop Advanced: 是
5/10/2014