构建金字塔(Overview) (数据管理)

摘要

定义和生成镶嵌数据集的金字塔。

用法

• 此工具支持镶嵌数据集的默认设置，而不支持对镶嵌数据集图层所设置的属性。例如，此工具不接受如波段计数、镶嵌方法、范围或查询等图层属性变化，这些属性由镶嵌数据集及其默认属性所确定。

• 必须选中定义缺失金字塔(overview)分块、生成金字塔，或者同时选中这两项。

• 如果需要对金字塔的定义进行更多控制，请优先使用“定义金字塔(Overview)”工具。

• 默认情况下，金字塔存储在包含镶嵌数据集的地理数据库中。可先使用“定义金字塔(Overview)”工具然后再指定位置来更改此设置。

• 不能为引用的镶嵌数据集构建金字塔。

语法

BuildOverviews_management (in_mosaic_dataset, {where_clause}, {define_missing_tiles}, {generate_overviews}, {generate_missing_images}, {regenerate_stale_images})

参数	说明	数据类型
in_mosaic_dataset	镶嵌数据集的路径和名称。	Mosaic Layer
where_clause （可选）	可以使用 SQL 定义查询，或者使用查询构建器构建查询。	SQL Expression
define_missing_tiles （可选）	在金字塔定义不足或添加新数据而未定义附加金字塔时生成金字塔。 DEFINE_MISSING_TILES —这会自动识别需要金字塔的位置并在该处定义金字塔。这是默认设置。 NO_DEFINE_MISSING_TILES — 不会定义新的金字塔。	Boolean
generate_overviews （可选）	生成所有需要创建或重新创建的金字塔。这包括缺失的金字塔和过时的金字塔。 GENERATE_OVERVIEWS — 生成所有类型和所有状态的金字塔。这是默认设置。 NO_GENERATE_OVERVIEWS — 仅构建已经定义但未生成的金字塔。	Boolean
generate_missing_images （可选）	在已经定义但尚未生成金字塔时使用。 GENERATE_MISSING_IMAGES —生成已经定义但尚未生成的金字塔。这是默认设置。 IGNORE_MISSING_IMAGES — 不生成已经定义但尚未生成的金字塔。	Boolean
regenerate_stale_images （可选）	如果基础栅格数据集发生更改或其属性进行过修改，会将金字塔识别为过时的金字塔。 REGENERATE_STALE_IMAGES —更新过时的金字塔。这是默认设置。 IGNORE_STALE_IMAGES — 不更新过时的金字塔。	Boolean

代码示例

BuildOverviews 示例 1（Python 窗口）

这是 BuildOverviews 的 Python 示例。

import arcpy
arcpy.BuildOverviews_management("c:/workspace/fgdb.gdb/md", "OBJECTID<5",\
                                "DEFINE_MISSING_TILES", "NO_GENERATE_OVERVIEWS",\
                                "#", "#")

BuildOverviews 示例 2（独立脚本）

这是 BuildOverviews 的 Python 脚本示例。

##===========================
##Build Overviews
##Usage: BuildOverviews_management in_mosaic_dataset {where_clause} 
##                                 {DEFINE_MISSING_TILES | NO_DEFINE_MISSING_TILES}
##                                 {GENERATE_OVERVIEWS | NO_GENERATE_OVERVIEWS}
##                                 {GENERATE_MISSING_IMAGES | IGNORE_MISSING_IMAGES}
##                                 {REGENERATE_STALE_IMAGES | IGNORE_STALE_IMAGES}

try:
    import arcpy
    arcpy.env.workspace = "C:/Workspace"
    # Define Overviews for selected items only
    arcpy.BuildOverviews_management("Overviews.gdb/md", "OBJECTID<5", "DEFINE_MISSING_TILES",\
                                    "NO_GENERATE_OVERVIEWS", "#", "#")
    
    # Define and Build Overviews for all
    arcpy.BuildOverviews_management("Overviews.gdb/md", "#", "DEFINE_MISSING_TILES",\
                                    "GENERATE_OVERVIEWS", "GENERATE_MISSING_IMAGES",\
                                    "REGENERATE_STALE_IMAGES")
    
except:
    print "Build Overviews example failed."
    print arcpy.GetMessages()

环境

范围

许可信息

ArcView: 否

ArcEditor: 是

ArcInfo: 是