批量构建金字塔 (数据管理)

摘要

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

使用情况

• 如果栅格数据集的目录很大但没有金字塔，则批量构建金字塔十分有用。

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

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

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

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

参数

对话框

标注	说明	数据类型
输入栅格数据集	要构建栅格金字塔的栅格数据集。 每个输入数据集的行数和列数都应超过 1024 个。	Raster Dataset
金字塔等级 (可选)	将构建的递减分辨率数据集图层的数量。 默认值为 -1（将构建完整的金字塔）。 值为 0 时，将不会获得金字塔等级。	Long
跳过第一个等级 (可选)	指定是否将跳过第一个金字塔等级。 跳过第一个等级将略微降低占用的磁盘空间大小，但将降低这些比例的性能。 未选中 - 不会跳过第一个金字塔等级，将构建该等级。 这是默认设置。 选中 - 将跳过第一个金字塔等级，不会构建该等级。	Boolean
金字塔重采样技术 (可选)	指定将用于构建金字塔的重采样技术。 NEAREST—重采样时，像元的新值将基于最邻近像元。 这是默认设置。 BILINEAR—像元的新值将基于到四个最邻近输入像元中心的加权平均距离。 CUBIC—通过拟合穿过 16 个最邻近输入像元中心的平滑曲线确定像元的新值。	String
金字塔压缩类型 (可选)	指定构建金字塔时使用的压缩类型。 DEFAULT—如果使用小波压缩方法对源数据进行压缩，则将使用 JPEG 压缩类型构建金字塔；否则，将使用 LZ77。 这是默认设置。 LZ77—将使用 LZ77 压缩算法来构建金字塔。 LZ77 可用于任意数据类型。 JPEG—将使用 JPEG 压缩算法构建金字塔。 只有符合 JPEG 压缩规范的数据才能使用此压缩类型。 如果选择 JPEG，则可以设置压缩质量。 NONE—构建金字塔时不使用任何压缩方法。	String
压缩质量 (可选)	使用 JPEG 压缩类型构建金字塔时将使用的压缩质量。 该值必须介于 0 到 100 之间 值越接近 100，图像质量越高，但压缩比越低。	Long
跳过现有的 (可选)	指定是仅在金字塔不存在时才构建金字塔，还是即使存在也构建金字塔。 未选中 - 即使金字塔已经存在仍将构建金字塔，并且将覆盖现有金字塔。 这是默认设置。 选中 - 仅当金字塔不存在时才构建金字塔，并且将跳过现有金字塔。	Boolean

派生输出

标注	说明	数据类型
批量构建金字塔成功	将返回工具是否成功运行。	Boolean

Python

arcpy.management.BatchBuildPyramids(Input_Raster_Datasets, {Pyramid_levels}, {Skip_first_level}, {Pyramid_resampling_technique}, {Pyramid_compression_type}, {Compression_quality}, {Skip_Existing})

名称	说明	数据类型
Input_Raster_Datasets [Input_Raster_Datasets,...]	要构建栅格金字塔的栅格数据集。 每个输入数据集的行数和列数都应超过 1024 个。	Raster Dataset
Pyramid_levels (可选)	将构建的递减分辨率数据集图层的数量。 默认值为 -1（将构建完整的金字塔）。 值为 0 时，将不会获得金字塔等级。	Long
Skip_first_level (可选)	指定是否将跳过第一个金字塔等级。 跳过第一个等级将略微降低占用的磁盘空间大小，但将降低这些比例的性能。 NONE—不会跳过第一个金字塔等级，将构建该等级。 这是默认设置。 SKIP_FIRST—将跳过第一个金字塔等级，不会构建该等级。	Boolean
Pyramid_resampling_technique (可选)	指定将用于构建金字塔的重采样技术。 NEAREST—重采样时，像元的新值将基于最邻近像元。 这是默认设置。 BILINEAR—像元的新值将基于到四个最邻近输入像元中心的加权平均距离。 CUBIC—通过拟合穿过 16 个最邻近输入像元中心的平滑曲线确定像元的新值。	String
Pyramid_compression_type (可选)	指定构建金字塔时使用的压缩类型。 DEFAULT—如果使用小波压缩方法对源数据进行压缩，则将使用 JPEG 压缩类型构建金字塔；否则，将使用 LZ77。 这是默认设置。 LZ77—将使用 LZ77 压缩算法来构建金字塔。 LZ77 可用于任意数据类型。 JPEG—将使用 JPEG 压缩算法构建金字塔。 只有符合 JPEG 压缩规范的数据才能使用此压缩类型。 如果选择 JPEG，则可以设置压缩质量。 NONE—构建金字塔时不使用任何压缩方法。	String
Compression_quality (可选)	使用 JPEG 压缩类型构建金字塔时将使用的压缩质量。 该值必须介于 0 到 100 之间 值越接近 100，图像质量越高，但压缩比越低。	Long
Skip_Existing (可选)	指定是仅在金字塔不存在时才构建金字塔，还是即使存在也构建金字塔。 OVERWRITE—即使金字塔已经存在仍将构建金字塔，并且将覆盖现有金字塔。 这是默认设置。 SKIP_EXISTING—仅当金字塔不存在时才构建金字塔，并且将跳过现有金字塔。	Boolean

派生输出

名称	说明	数据类型
Batch_Build_Pyramids_Succeeded	将返回工具是否成功运行。	Boolean

代码示例

BatchBuildPyramids 示例 1（Python 窗口）

这是 BatchBuildPyramids 函数的 Python 示例。

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

BatchBuildPyramids 示例 2（独立脚本）

这是 BatchBuildPyramids 函数的 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 格式。