描述
基于源数据集的信息创建切片方案文件。当创建缓存切片时,切片方案文件随后可在管理切片缓存工具中使用。
该工具可用来编辑现有切片方案的属性,例如切片格式、存储格式、切片大小等等。此外,该工具还可用于向现有切片方案添加新的比例级别。
使用方法
默认情况下,切片原点起始于源数据集所用坐标系的左上角。
可以使用几种不同的方法来加载现有切片方案。
- 加载来自在线地图服务(如 ArcGIS Online、Google 地图、Bing 地图或 Yahoo 等等)的切片方案。这些切片方案将保存在 ArcGIS Pro 安装 目录中的 <install>/resources/TilingSchemes 文件夹中。
- 加载来自现有影像服务或地图服务缓存的切片方案。
- 加载此工具上一次运行时您所创建的切片方案。
语法
arcpy.management.GenerateTileCacheTilingScheme(in_dataset, out_tiling_scheme, tiling_scheme_generation_method, number_of_scales, {predefined_tiling_scheme}, {scales}, {scales_type}, {tile_origin}, {dpi}, {tile_size}, {tile_format}, {tile_compression_quality}, {storage_format}, {lerc_error})
参数 | 说明 | 数据类型 |
in_dataset | 将用来生成切片方案的源。它可以是栅格数据集、镶嵌数据集或地图。 | Raster Layer; Mosaic Layer; Map |
out_tiling_scheme | 要创建的输出切片方案的路径和文件名。 | File |
tiling_scheme_generation_method | 选择采用新的切片方案还是预定义切片方案。使用此工具可以定义一个新的切片方案,也可以浏览到一个预定义的切片方案文件 (.xml)。
| String |
number_of_scales | 要在切片方案中创建的比例级数。 | Long |
predefined_tiling_scheme (可选) | 预定义切片方案文件(通常名为 conf.xml)的路径。仅当预定义选项被选为切片方案生成方法时,此参数才可用。 | File |
scales [scale,...] (可选) | 要包含在切片方案中的比例级别。默认情况下,不使用分数表示比例级别。而是使用 500 表示比例 1:500,依此类推。在比例级数参数中输入的值将会生成一组默认比例级别。 | Value Table |
scales_type (可选) | 确定 scales 参数的单位。
| Boolean |
tile_origin (可选) | 切片方案原点(左上角),采用源数据集空间参考的坐标值。源数据集的范围必须在此原点范围内(但不必与原点重合)。 | Point |
dpi (可选) | 专用输出设备的每英寸点数。如果所选择的 DPI 与输出设备(通常是显示器)的分辨率不匹配,则切片将显示错误比例。默认值为 96。 | Long |
tile_size (可选) | 缓存切片的宽度和高度(以像素为单位)。默认值为 256 x 256。 为在性能和可管理性之间寻求最佳平衡,应避免偏离宽度值 256 或 512。
| String |
tile_format (可选) | 缓存中切片的文件格式。
| String |
tile_compression_quality (可选) | 针对 JPEG 或 MIXED 压缩质量输入一个介于 1 和 100 之间的值。默认值为 75。 只有 MIXED 和 JPEG 格式支持压缩。选择较高的值,则图像质量也较高,但文件会较大。使用较低的值,则图像质量也较低且文件较小。 | Long |
storage_format (可选) | 确定切片的存储格式。
| String |
lerc_error (可选) | 设置通过 LERC 进行压缩时像素值的最大容差。 | Double |
代码示例
这是 GenerateTileCacheTilingScheme 工具的 Python 示例。
import arcpy
arcpy.GenerateTileCacheTilingScheme_management(
"C:/Data/Cache.gdb/Md","C:/TilingSchemes/scheme.xml",
"NEW","8","#","#","#","#","96","256 x 256","MIXED",
"75","COMPACT")
这是 GenerateTileCacheTilingScheme 工具的 Python 脚本示例。
#Generate tiling scheme for a mosaic dataset
#Generate 5 default scales
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "C:/Workspace/Cache.gdb/md"
outScheme = "C:/Workspace/Schemes/Tilingscheme.xml"
method = "NEW"
numscales = "5"
predefScheme = "#"
scales = "#"
scaleType = "SCALE"
tileOrigin = "-20037700 30198300"
dpi = "96"
tileSize ="256 x 256"
tileFormat = "MIXED"
compQuality = "75"
storageFormat = "COMPACT"
arcpy.GenerateTileCacheTilingScheme_management(
mdName, outScheme, method, numscales, predefScheme, scales,
scaleType, tileOrigin, dpi, tileSize, compQuality, storageFormat)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是