返回顶部

管理切片缓存 (数据管理)

在本主题中

  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息

摘要

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

使用情况

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

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

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

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

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

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

  • 选中即用型格式参数后，将使用开放切片包规范生成缓存内容。 缓存格式为 Compact V2，且缓存方案采用 JSON 格式，而非 XML 格式。 有关可学习格式的详细信息，请参阅从缓存数据集发布切片图层。

参数

对话框Python

标注说明数据类型
缓存位置

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

Folder; Raster Layer
管理模式

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

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

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

String
输入数据源
(可选)

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

如果已将管理模式参数设置为删除切片，则不需要此参数。

地图文件 (.mapx) 不能包含地图服务或图像服务。

Mosaic Layer; Raster Layer; Map
输入切片方案
(可选)

指定将使用的切片方案。

  • ArcGIS Online 方案—将使用默认 ArcGIS Online 切片方案。
  • 导入方案—将导入并使用现有的切片方案。
  • 高程切片方案—将使用高程服务切片方案。
  • WGS84　版本　2　切片方案—将使用 WGS84　版本　2　切片方案。
  • WGS84　版本　2　高程切片方案—将使用 WGS84 版本 2 切片方案来构建高程数据的切片缓存。
String
导入切片方案
(可选)

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

Image Service; Map Server; File
比例 [像素大小]（预计占用的磁盘空间）
(可选)

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

  • 默认情况下，仅使用最小缓存比例和最大缓存比例的值。
  • 更改最小缓存比例或最大缓存比例参数的值将选中或取消选中相应的比例值。
  • 生成缓存时将忽略选中的比例以及不在最小缓存比例或最大缓存比例参数值范围之内的比例。
Double
感兴趣区域
(可选)

将使用感兴趣区对将创建或删除的切片进行约束。

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

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

Feature Set
最大源像元大小
(可选)

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

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

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

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

  • 对于像元大小小于等于此参数的级别，缓存将由数据源生成。
  • 对于源像元大小大于此参数的级别，缓存将由前一级缓存生成。

该参数值的测量单位应与源数据集像元大小的测量单位一致。

Double
最小缓存比例
(可选)

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

Double
最大缓存比例
(可选)

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

Double
即用型格式
(可选)

指定缓存内容是否按照开放切片包规范生成，并确定缓存方案的文件格式。

  • 选中 - 将使用开放切片包规范生成缓存内容。 切片包可以打包为 Zip 归档，便于执行离线工作流。 缓存格式为 Compact V2，且缓存方案采用 JSON 格式。
  • 未选中 - 缓存内容将使用 XML 格式存储的方案生成。 这是默认设置。

Boolean

派生输出

标注说明数据类型
缓存名称

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

Raster Dataset

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}, {ready_to_serve_format})
名称说明数据类型
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 时，不需要此参数。

地图文件 (.mapx) 不能包含地图服务或图像服务。

Mosaic Layer; Raster Layer; Map
tiling_scheme
(可选)

指定将使用的切片方案。

  • ARCGISONLINE_SCHEME—将使用默认 ArcGIS Online 切片方案。
  • IMPORT_SCHEME—将导入并使用现有的切片方案。
  • ARCGISONLINE_ELEVATION_SCHEME—将使用高程服务切片方案。
  • WGS84_V2_SCHEME—将使用 WGS84　版本　2　切片方案。
  • WGS84_V2_ELEVATION_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
(可选)

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

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

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

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

  • 对于像元大小小于等于此参数的级别，缓存将由数据源生成。
  • 对于源像元大小大于此参数的级别，缓存将由前一级缓存生成。

该参数值的测量单位应与源数据集像元大小的测量单位一致。

Double
min_cached_scale
(可选)

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

Double
max_cached_scale
(可选)

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

Double
ready_to_serve_format
(可选)

指定缓存内容是否按照开放切片包规范生成，并确定缓存方案的文件格式。

  • READY_TO_SERVE_FORMAT—将使用开放切片包规范生成缓存内容 (https://github.com/Esri/tile-package-spec)。 切片包可以打包为 Zip 归档，便于执行离线工作流。 缓存格式为 Compact V2，且缓存方案采用 JSON 格式。
  • NON_READY_TO_SERVE_FORMAT—缓存内容将使用 XML 格式存储的方案生成。 这是默认设置。
Boolean

派生输出

名称说明数据类型
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", "NON_READY_TO_SERVE_FORMAT")
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"
ready_to_serve_format="NON_READY_TO_SERVE_FORMAT"

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

环境

并行处理因子

特殊情况

并行处理因子

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

许可信息

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

相关主题

  • 切片缓存工具集概述
  • 查找地理处理工具

有关此主题的反馈?

在本主题中
  1. 摘要
  2. 使用情况
  3. 参数
  4. 环境
  5. 许可信息