构建金字塔 (Pyramid) (Data Management)

许可等级:BasicStandardAdvanced

摘要

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

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

插图

Build Pyramids

用法

语法

BuildPyramids_management (in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
参数说明数据类型
in_raster_dataset

输入栅格数据集。

输入数据集的行数和列数都应超过 1024 个。

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

代码实例

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)

环境

金字塔

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

相关主题

许可信息

ArcGIS for Desktop Basic: 是
ArcGIS for Desktop Standard: 是
ArcGIS for Desktop Advanced: 是
5/10/2014