定义金字塔 (Overview) (数据管理)
摘要
为预处理的栅格数据集定义切片方案和属性，这些栅格数据集将包括以不同分辨率显示的部分或全部镶嵌数据集。
用法
-
当存在需要设置的特定参数以生成金字塔时可使用此工具，例如
- 定义文件写入位置
- 定义根据边界而变化的范围
- 定义金字塔图像的属性，例如重采样或压缩方法
- 定义金字塔重采样系数
-
使用构建金字塔(Overview) 工具可在已通过此工具定义了金字塔之后生成金字塔。
可以使用面要素类定义金字塔的形状。将为要素类中的每个面创建金字塔图像。理想情况下，要素类将用来创建一个金字塔图像。如果不想使用要素类中的所有面，则可以对内容列表中的图层进行选择，或者使用“创建要素图层”等工具来创建一个仅表示所需面的临时图层。
默认切片大小为 128 × 128。可在“环境设置”中更改切片大小。
如果边界包含很多折点，则该工具的运行时间会比较长。
语法
| 参数 | 说明 | 数据类型 |
in_mosaic_dataset |
镶嵌数据集的路径和名称。 | Mosaic Layer |
overview_image_folder （可选） |
用来存储金字塔的文件夹或地理数据库。 在个人地理数据库和文件地理数据库内存储和管理的金字塔具有默认的金字塔文件夹位置，该位置与现有的地理数据库位于同一工作空间中。 | Workspace |
in_template_dataset （可选） |
一个栅格数据集或面要素类，用来定义金字塔的范围或形状。 使用栅格数据集时将使用栅格数据集的范围。使用要素类时将使用面的形状。 | Raster Layer; Feature Layer |
extent （可选） |
将生成四个用于定义金字塔范围的坐标。 此参数按以下顺序以空格分隔的形式加以指定：X 最小值 X 最大值 Y 最小值 Y 最大值。 如果未定义范围，将使用镶嵌数据集边界来确定金字塔的范围。 | Extent |
pixel_size （可选） |
用来生成金字塔的基本像素大小。默认值由软件确定。 | Double |
number_of_levels （可选） |
将生成的金字塔等级数。 如果是大于 0 的数，它将是生成的金字塔等级数。例如，3 表示将生成三个金字塔等级。如果值留空或为 -1，则生成的金字塔最多可达 1500 行（或列）。 | Long |
tile_rows （可选） |
金字塔中的最佳行数。 值越大，文件也就越大，下方的任意图像发生变化时需要重新生成文件的可能性也越大。 该数字可能会影响创建的金字塔图像数。如果是一个较大的数字，则会生成较少的金字塔。如果是一个较小的数字，则会生成较多的文件。 | Long |
tile_cols （可选） |
金字塔中的最佳列数。 值越大，文件也就越大，下方的任意图像发生变化时需要重新生成文件的可能性也越大。 该数字可能会影响创建的金字塔图像数。如果是一个较大的数字，则会生成较少的金字塔。如果是一个较小的数字，则会生成较多的文件。 | Long |
overview_factor （可选） |
用来确定下一个金字塔大小的比率。例如，如果第一个等级的像元大小为 x，金字塔系数为 3，则下一个金字塔像素大小将为 3x。 | Long |
force_overview_tiles （可选） |
影响将生成的金字塔所处的等级。
| Boolean |
resampling_method （可选） |
创建金字塔 (overview) 时使用的重采样算法。
| String |
compression_method （可选） |
此参数用于定义存储金字塔图像时使用的数据压缩类型。
| String |
compression_quality （可选） |
JPEG 压缩方法所采用的压缩质量。压缩质量的变化范围是 1 到 100。数字较大，意味着图像的质量较高，但压缩程度较低。 | Long |
代码示例
这是 DefineOverviews 的 Python 示例。
import arcpy
arcpy.DefineOverviews_management("c:/workspace/fgdb.gdb/md01", "c:/temp",
"#", "#", "30", "6", "4000", "4000", "2",
"CUBIC", "JPEG", "50")
这是 DefineOverviews 的 Python 脚本示例。
##===========================
##Define Overviews
##Usage: DefineOverviews_management in_mosaic_dataset {overview_image_folder}
## {in_template_dataset} {extent} {pixel_size}
## {number_of_levels} {tile_rows} {tile_cols}
## {overview_factor} {NO_FORCE_OVERVIEW_TILES
## | FORCE_OVERVIEW_TILES} {BILINEAR | NEAREST
## | CUBIC}, {JPEG | None | LZW} {compression_quality}
try:
import arcpy
arcpy.env.workspace = "C:/Workspace"
# Define Overviews to the default location
# Define Overviews for all levels - ignore the primary Raster pyramid
# Define Overviews compression and resampling method
arcpy.DefineOverviews_management("DefineOVR.gdb/md", "#", "#", "#", "#", "#",
"#", "#", "#", "FORCE_OVERVIEW_TILES",
"BILINEAR", "JPEG", "50")
# Define Overviews to the same File Geodatabase
# Define Overview starting cell size, number of levels, maximum size and factor
arcpy.DefineOverviews_management("DefineOVR.gdb/md", "DefineOVR.gdb", "#",
"#", "3", "6", "4000", "4000", "2", "#",
"CUBIC", "None", "#")
except:
print "Define Overviews example failed."
print arcpy.GetMessages()