构建金字塔 (Pyramid) (Data Management)
摘要
为栅格数据集构建栅格金字塔。
此工具也可用于删除金字塔。要删除金字塔，请将金字塔等级参数设为 0。
插图
 |
用法
-
构建金字塔可以改善栅格数据集的显示性能。
-
只需为每个数据集构建一次金字塔。每次显示栅格数据集时都将访问金字塔。
-
对于行或列中的像素少于 1024 像素的栅格数据集，将不会为其构建金字塔。由于该栅格数据集足够小，所以无需金字塔；且构建金字塔也将无助于提高性能。
-
小波压缩栅格数据集（如 ECW 和 MrSID）无需构建金字塔。这些格式具有编码时创建的内部金字塔。
-
可在栅格存储环境设置中为金字塔概述文件选择压缩类型。压缩操作将创建一个较小的 .ovr 文件。IMAGINE 格式和较早版本的 ArcGIS 将创建递减分辨率数据集 (.rrd) 文件，这些文件不支持压缩。
-
默认情况下，金字塔压缩将根据给定的数据类型使用最佳的压缩类型。也可以手动选择压缩方法：LZ77、JPEG 或无压缩。
-
JPEG 压缩只适用于可根据 JPEG 规范存储数据的文件格式。支持的栅格数据集文件格式主题列出了 JPEG 格式会支持的说明。
语法
| 参数 | 说明 | 数据类型 |
in_raster_dataset |
输入栅格数据集。 输入数据集的行数和列数都应超过 1024 个。 | Raster Dataset; Raster Layer |
pyramid_level (可选) | 选择将构建的递减分辨率数据集图层的数量。默认值为 -1（将构建完整的金字塔）。值为 0 时，将不会获得金字塔等级。 要删除金字塔，请将等级数设为 0。 可以指定的最大金字塔等级数为 29。任何大于或等于 30 的值都将恢复成 -1，并将创建一组完整的金字塔。 | Long |
SKIP_FIRST (可选) | 选择是否跳过第一个金字塔等级。跳过第一个等级将略微降低占用的磁盘空间大小，但将降低这些比例的性能。
| Boolean |
resample_technique (可选) |
用于构建金字塔的重采样技术。
| String |
compression_type (可选) |
构建栅格金字塔时使用的压缩类型。
| String |
compression_quality (可选) | 使用 JPEG 压缩方法构建金字塔时使用的压缩质量。该值必须处于 0 到 100 之间。值越接近 100，图像质量越高，但压缩比越低。 | Long |
skip_existing (可选) | 指定在缺少金字塔的位置构建金字塔，还是重新构建全部金字塔（即使已经存在仍重新构建）。
| Boolean |
代码实例
这是 BuildPyramids 的 Python 示例。
import arcpy
arcpy.BuildPyramids_management(
"C:/data/image.tif", "3", "NONE",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
这是 BuildPyramids 的 Python 脚本示例。
#Build Pyramids for single Raster Dataset
#Define the type and compression of pyramids in the tool
#Skip if dataset already has pyramids
import arcpy
arcpy.env.workspace = "C:/Workspace"
inras = "image.tif"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BuildPyramids_management(inras, pylevel, skipfirst, resample,
compress, quality, skipexist)