摘要
为栅格数据集构建栅格金字塔。
此工具也可用于删除金字塔。要删除金字塔,请将金字塔等级参数设为 0。
插图
用法
构建金字塔可以改善栅格数据集的显示性能。
只需为每个数据集构建一次金字塔。每次显示栅格数据集时都将访问金字塔。
对于行或列中的像素少于 1,024 像素的栅格数据集,将不会为其构建金字塔。由于该栅格数据集足够小,所以无需金字塔;且构建金字塔也将无助于提高性能。
小波压缩栅格数据集(如 ECW 和 MrSID)无需构建金字塔。这些格式具有编码时创建的内部金字塔。
可在栅格存储环境中为金字塔概述文件选择压缩类型。压缩操作将创建一个较小的 .ovr 文件。IMAGINE 格式和较早版本的 ArcGIS 将创建递减分辨率数据集 (.rrd) 文件,这些文件不支持压缩。
默认情况下,金字塔压缩将根据给定的数据类型使用最佳的压缩类型。也可以手动选择压缩方法:LZ77、JPEG 或无压缩。
JPEG 压缩只适用于可根据 JPEG 规范存储数据的文件格式。受支持的栅格数据集文件格式列出了 JPEG 格式所支持的规范。
语法
BuildPyramids_management (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 (可选) | 选择是否跳过第一个金字塔等级。跳过第一个等级将略微降低占用的磁盘空间大小,但将降低这些比例的性能。
| Boolean |
resample_technique (可选) | 用于构建金字塔的重采样技术。
| String |
compression_type (可选) | 构建栅格金字塔时使用的压缩类型。
| String |
compression_quality (可选) | 使用 JPEG 压缩方法构建金字塔时使用的压缩质量。该值必须介于 0 到 100 之间 值越接近 100,图像质量越高,但压缩比越低。 | Long |
skip_existing (可选) | 指定在缺少金字塔的位置构建金字塔,还是重新构建全部金字塔(即使已经存在仍重新构建)。
| Boolean |
代码示例
BuildPyramids 示例 1(Python 窗口)
这是 BuildPyramids 工具的 Python 示例。
import arcpy
arcpy.BuildPyramids_management(
"C:/data/image.tif", "3", "NONE",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
BuildPyramids 示例 2(独立窗口)
这是 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)
环境
许可信息
- ArcGIS Desktop Basic: 是
- ArcGIS Desktop Standard: 是
- ArcGIS Desktop Advanced: 是