构建镶嵌数据集项目缓存 (Data Management)

许可等级:BasicStandardAdvanced

摘要

向镶嵌数据集中项的函数链插入“缓存栅格”函数。

用法

语法

BuildMosaicDatasetItemCache_management (in_mosaic_dataset, {where_clause}, {define_cache}, {generate_cache}, {item_cache_folder}, {compression_method}, {compression_quality}, {max_allowed_rows}, {max_allowed_columns}, {request_size_type}, {request_size})
参数说明数据类型
in_mosaic_dataset

输入镶嵌数据集。

Image Service; Mosaic Layer; String
where_clause
(可选)

如果想选择要缓存的项目,可以使用 SQL 来定义查询,或者使用查询构建器构建查询。

SQL Expression
define_cache
(可选)

选择定义镶嵌数据集缓存。“缓存栅格”函数将插入到选定项目中。如果项目已经具有“缓存栅格”函数,将不再添加。

  • DEFINE_CACHE“缓存栅格”函数将添加到选定项目中。如果项目已经具有该函数,将不再添加。这是默认设置。
  • NO_DEFINE_CACHE不定义栅格缓存。
Boolean
generate_cache
(可选)

根据“缓存栅格”函数中定义的属性(例如,缓存的位置和压缩)选择生成缓存文件。

  • GENERATE_CACHE将生成缓存。这是默认设置。
  • NO_GENERATE_CACHE不生成缓存。
Boolean
item_cache_folder
(可选)

缓存数据集的存储位置。

默认情况下,会在镶嵌数据集所处位置旁的文件夹中生成和存储缓存。此文件夹的名称与地理数据库的名称相同,但扩展名为 .cache。但是,如果镶嵌数据集创建于 ArcSDE 地理数据库,则将在该地理数据库中创建缓存。

项目缓存创建完成后,就不可能通过指定不同的“缓存路径”并重新运行此工具,而在其它位置上重新生成项目缓存,只能继续在首次生成项目缓存的位置上生成。不过,可删除此函数,然后在新路径中插入一个新函数;或者使用修复镶嵌数据集工具修改缓存路径,然后运行此工具,在其它位置上生成项目缓存。

Workspace
compression_method
(可选)

如果存在压缩类型,则可将其应用于生成缓存。

  • 无损无损压缩可在生成缓存数据集时保留各像素的值。
  • 有损有损压缩在生成缓存数据集时不保留各像素的准确值。使用此方法时,还可设置压缩质量。
  • 生成缓存数据集时不使用任何压缩方法。
String
compression_quality
(可选)

采用有损压缩方法时使用的压缩质量。压缩质量值介于 1% 到 100% 之间。

Long
max_allowed_rows
(可选)

利用行像素的数量限制缓存数据集的大小。

如果大小超过该限值,将不生成缓存栅格。

Long
max_allowed_columns
(可选)

利用列像素的数量限制缓存数据集的大小。

如果大小超过该限值,将不生成缓存栅格。

Long
request_size_type
(可选)

对项目缓存进行重采样时,要选择是否要指定像素大小因子或像素大小。

  • PIXEL_SIZE_FACTOR允许选择比例因子,以对缓存栅格进行重采样。这是默认设置。如果不希望对缓存进行重采样,请将 PIXEL_SIZE_FACTOR 的因子设为 1。
  • PIXEL_SIZE允许指定创建缓存栅格的像素大小。
String
request_size
(可选)

指定请求大小。键入的值将基于 request_size_type 选项。如果选择 PIXEL_SIZE_FACTOR,则输入数值将为比例因子。如果选择 PIXEL_SIZE,则输入数值将为重采样像素大小。

Double

代码实例

BuildMosaicDatasetItemCache 示例 1(Python 窗口)

这是 BuildMosaicDatasetItemCache 的 Python 示例。

import arcpy
arcpy.BuildMosaicDatasetItemCache_management(
     "C:/Workspace/itemcache.gdb/md",  "#", "DEFINE_CACHE", 
     "NO_GENERATE_CACHE", "C:/workspace/itemcache", "LOSSY", 
     "80", "#", "#")
BuildMosaicDatasetItemCache 示例 2(独立窗口)

这是 BuildMosaicDatasetItemCache 的 Python 脚本示例。

#Define mosaic dataset item cache without generating the cache file

import arcpy
arcpy.env.workspace = "C:/Workspace"

mdname = "itemcache.gdb/md"
query = "#"
definecache = "DEFINE_CACHE"
generatecache = "NO_GENERATE_CACHE"
cachepath = "C:/workspace/itemcache"
compression = "LOSSY"
compquality = "80"
maxrow = "#"
maxcolumn = "#"

arcpy.BuildMosaicDatasetItemCache_management(
     mdname, query, definecache, generatecache, cachepath, compression, 
     compquality, maxrow, maxcolumn)

环境

相关主题

许可信息

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