为多个栅格数据集构建金字塔。
构建金字塔可以改善栅格数据集的显示性能。
如果栅格数据集的目录很大但没有金字塔，则批量构建金字塔十分有用。
小波压缩的栅格数据集（例如 ECW、JPEG2000 和 MrSID）无需构建金字塔。 这些格式具有编码时创建的内部金字塔。
对于行或列中的像素少于 1,024 像素的栅格数据集，将不会为其构建金字塔。 由于该栅格数据集足够小，所以无需金字塔；且构建金字塔也将无助于改善性能。
可以使用栅格存储环境为金字塔概述文件选择压缩类型。 压缩操作将创建一个较小的 .ovr 文件。 当压缩不可用时，IMAGINE 格式和较早版本的 ArcGIS 将创建递减分辨率数据集文件 (.rrd)。
默认金字塔压缩将使用最佳压缩类型，具体取决于数据类型。 您也可以手动选择 LZ77、JPEG 或无压缩。
| 标注 | 说明 | 数据类型 |
输入栅格数据集 | 要构建栅格金字塔的栅格数据集。 每个输入数据集的行数和列数都应超过 1024 个。 | Raster Dataset |
金字塔等级 (可选) | 将构建的递减分辨率数据集图层的数量。 默认值为 -1（将构建完整的金字塔）。 值为 0 时，将不会获得金字塔等级。 | Long |
跳过第一个等级 (可选) |
指定是否将跳过第一个金字塔等级。 跳过第一个等级将略微降低占用的磁盘空间大小，但将降低这些比例的性能。
| Boolean |
金字塔重采样技术 (可选) | 指定将用于构建金字塔的重采样技术。
| String |
金字塔压缩类型 (可选) | 指定构建金字塔时使用的压缩类型。
| String |
压缩质量 (可选) | 使用 JPEG 压缩类型构建金字塔时将使用的压缩质量。 该值必须介于 0 到 100 之间 值越接近 100，图像质量越高，但压缩比越低。 | Long |
跳过现有的 (可选) | 指定是仅在金字塔不存在时才构建金字塔，还是即使存在也构建金字塔。
| Boolean |
| 标注 | 说明 | 数据类型 |
| 批量构建金字塔成功 | 将返回工具是否成功运行。 | Boolean |
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 (可选) | 指定是否将跳过第一个金字塔等级。 跳过第一个等级将略微降低占用的磁盘空间大小，但将降低这些比例的性能。
| Boolean |
Pyramid_resampling_technique (可选) | 指定将用于构建金字塔的重采样技术。
| String |
Pyramid_compression_type (可选) | 指定构建金字塔时使用的压缩类型。
| String |
Compression_quality (可选) | 使用 JPEG 压缩类型构建金字塔时将使用的压缩质量。 该值必须介于 0 到 100 之间 值越接近 100，图像质量越高，但压缩比越低。 | Long |
Skip_Existing (可选) | 指定是仅在金字塔不存在时才构建金字塔，还是即使存在也构建金字塔。
| Boolean |
| 名称 | 说明 | 数据类型 |
| Batch_Build_Pyramids_Succeeded | 将返回工具是否成功运行。 | Boolean |
这是 BatchBuildPyramids 函数的 Python 示例。
import arcpy
arcpy.BatchBuildPyramids_management(
"C:/data/img1.tif;C:/data/img2.img", "6", "SKIP_FIRST",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")这是 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)