构建金字塔 (数据管理)

描述

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

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

插图

使用方法

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

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

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

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

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

• 默认情况下，金字塔压缩将根据给定的数据类型使用最佳的压缩类型。也可以手动选择压缩方法：LZ77、JPEG 或无压缩。

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

语法

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	输出栅格数据集。	栅格数据集

代码示例

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 格式。

许可信息

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