构建金字塔 (数据管理)

摘要

为栅格数据集构建栅格金字塔。

此工具也可用于删除金字塔。 要删除金字塔，请将金字塔等级参数设为 0。

插图

使用情况

• 构建金字塔可以改善栅格数据集的显示性能。

• 只需为每个数据集构建一次金字塔。 每次显示栅格数据集时，都会访问金字塔。

• 对于行或列中的像素少于 1,024 像素的栅格数据集，将不会为其构建金字塔。 由于该栅格数据集足够小，所以无需金字塔；且构建金字塔也将无助于改善性能。

• 小波压缩的栅格数据集（例如 ECW、JPEG2000 和 MrSID）无需构建金字塔。 这些格式具有编码时创建的内部金字塔。

• 可以使用栅格存储环境为金字塔概述文件选择压缩类型。 压缩操作将创建一个较小的 .ovr 文件。 当压缩不可用时，IMAGINE 格式和较早版本的 ArcGIS 将创建递减分辨率数据集文件 (.rrd)。

• 默认金字塔压缩将使用最佳压缩类型，具体取决于数据类型。 您也可以手动选择 LZ77、JPEG 或无压缩。

• JPEG 压缩只适用于可根据 JPEG 规范存储数据的文件格式。 受支持的栅格数据集文件格式列表列出了 JPEG 格式支持的文件格式说明。

参数

对话框

标注	说明	数据类型
输入栅格数据集	要构建金字塔的栅格数据集。 输入数据集的行数和列数都应超过 1,024 个。	Raster Dataset; Raster Layer
金字塔等级 (可选)	将构建的递减分辨率数据集图层的数量。 默认值为 -1（将构建完整的金字塔）。 值为 0 时，将不会获得金字塔等级。 要删除金字塔，请将等级数设为 0。 可以指定的最大金字塔等级数为 29。 任何大于或等于 30 的值都将恢复成 -1，并将创建一组完整的金字塔。	Long
跳过第一个等级 (可选)	指定是否将跳过第一个金字塔等级。 跳过第一个等级将略微降低占用的磁盘空间大小，但将降低这些比例的性能。 未选中 - 不会跳过第一个金字塔等级，将构建该等级。 这是默认设置。 选中 - 将跳过第一个金字塔等级，不会构建该等级。	Boolean
金字塔重采样技术 (可选)	指定将用于构建金字塔的重采样技术。 最邻近—重采样时，将使用最邻近像素的值将为输出像素分配值。 这是默认设置。 双线性—将基于四个最邻近的输入像素中心的加权平均距离确定像素的新值。 三次卷积—将通过拟合穿过 16 个最邻近输入像素中心的平滑曲线确定像素的新值。	String
金字塔压缩类型 (可选)	指定构建栅格金字塔时将使用的压缩类型。 默认值—如果使用小波压缩方法对源数据进行压缩，则将使用 JPEG 压缩类型构建金字塔；否则，将使用 LZ77。 此方法为默认压缩方法。 LZ77—将使用 LZ77 压缩算法来构建金字塔。 LZ77 可用于任意数据类型。 Jpeg—将使用 JPEG 压缩算法构建金字塔。 只有符合 JPEG 压缩规范的数据才能使用此压缩类型。 如果选择 JPEG，则可以设置压缩质量。 Jpeg 亮度和色度—将通过使用亮度 (Y) 和色度（Cb 与 Cr）颜色空间组件进行的有损压缩构建金字塔。 不压缩—构建金字塔时不使用任何压缩方法。	String
压缩质量(1-100) (可选)	使用 JPEG 压缩类型构建金字塔时将使用的压缩质量。 该值必须介于 0 到 100 之间 值越接近 100，图像质量越高，但压缩比越低。	Long
跳过现有的 (可选)	指定是在缺少金字塔的位置进行构建，还是重新生成金字塔（即使已经存在）。 未选中 - 即使金字塔已经存在仍将构建金字塔，现有金字塔将被覆盖。 这是默认设置。 选中 - 仅在不存在金字塔时才构建金字塔。	Boolean

派生输出

标注	说明	数据类型
更新的输入栅格	输出栅格数据集。	Raster Dataset

Python

arcpy.management.BuildPyramids(in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})

名称	说明	数据类型
in_raster_dataset	要构建金字塔的栅格数据集。 输入数据集的行数和列数都应超过 1,024 个。	Raster Dataset; Raster Layer
pyramid_level (可选)	将构建的递减分辨率数据集图层的数量。 默认值为 -1（将构建完整的金字塔）。 值为 0 时，将不会获得金字塔等级。 要删除金字塔，请将等级数设为 0。 可以指定的最大金字塔等级数为 29。 任何大于或等于 30 的值都将恢复成 -1，并将创建一组完整的金字塔。	Long
SKIP_FIRST (可选)	指定是否将跳过第一个金字塔等级。 跳过第一个等级将略微降低占用的磁盘空间大小，但将降低这些比例的性能。 NONE—不会跳过第一个金字塔等级，将构建该等级。 这是默认设置。 SKIP_FIRST—将跳过第一个金字塔等级，不会构建该等级。	Boolean
resample_technique (可选)	指定将用于构建金字塔的重采样技术。 NEAREST—重采样时，将使用最邻近像素的值将为输出像素分配值。 这是默认设置。 BILINEAR—将基于四个最邻近的输入像素中心的加权平均距离确定像素的新值。 CUBIC—将通过拟合穿过 16 个最邻近输入像素中心的平滑曲线确定像素的新值。	String
compression_type (可选)	指定构建栅格金字塔时将使用的压缩类型。 DEFAULT—如果使用小波压缩方法对源数据进行压缩，则将使用 JPEG 压缩类型构建金字塔；否则，将使用 LZ77。 此方法为默认压缩方法。 LZ77—将使用 LZ77 压缩算法来构建金字塔。 LZ77 可用于任意数据类型。 JPEG—将使用 JPEG 压缩算法构建金字塔。 只有符合 JPEG 压缩规范的数据才能使用此压缩类型。 如果选择 JPEG，则可以设置压缩质量。 JPEG_YCbCr—将通过使用亮度 (Y) 和色度（Cb 与 Cr）颜色空间组件进行的有损压缩构建金字塔。 NONE—构建金字塔时不使用任何压缩方法。	String
compression_quality (可选)	使用 JPEG 压缩类型构建金字塔时将使用的压缩质量。 该值必须介于 0 到 100 之间 值越接近 100，图像质量越高，但压缩比越低。	Long
skip_existing (可选)	指定是在缺少金字塔的位置进行构建，还是重新生成金字塔（即使已经存在）。 OVERWRITE—即使金字塔已经存在仍将构建金字塔，现有金字塔将被覆盖。 这是默认设置。 SKIP_EXISTING—只有当不存在金字塔时才构建金字塔。	Boolean

派生输出

名称	说明	数据类型
out_raster	输出栅格数据集。	Raster Dataset

代码示例

BuildPyramids 示例 1（Python 窗口）

这是 BuildPyramids 工具的 Python 示例。

import arcpy
arcpy.BatchBuildPyramids_management(
     "C:/data/img1.tif;C:/data/img2.img", "6", "SKIP_FIRST",
      "BILINEAR", "JPEG", "50", "SKIP_EXISTING")

BuildPyramids 示例 2（独立脚本）

这是 BuildPyramids 工具的 Python 脚本。

#Build Pyramids for multiple raster datasets in the workspace
#Skip the dataset that already has pyramid
#Build pyramids with compression and level setting

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

    
inras = "image1.tif;image2.img;fgdb.gdb/image3"
pylevels = "6"
skipfirst = "SKIP_FIRST"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"

arcpy.BatchBuildPyramids_management(
     inras, pylevels, skipfirst, resample, compress,
     quality, skipexist)

环境

当前工作空间, 金字塔, 并行处理因子, 临时工作空间

特殊情况

金字塔

金字塔等级、金字塔压缩和重采样方法不适用于 IMG 格式。

并行处理因子

仅适用于 CRF 格式。