构建概视图(Overview) (Data Management)

摘要

定义和生成镶嵌数据集的概视图。

用法

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

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

• 如果需要对概视图的定义进行更多控制，请优先使用定义概视图工具。

• 默认情况下，镶嵌数据集的概视图在文件地理数据库中生成，个人地理数据库存储在文件夹 <gdbname> 中，而概视图则存储在包含镶嵌数据集的地理数据库的存储位置上。在 SDE 上生成的镶嵌数据集概视图存储在包含镶嵌数据集的地理数据库中。优先使用定义概视图工具，然后再指定新位置可以更改这些位置。

• 不能为引用的镶嵌数据集构建概视图。

语法

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/Overviews.gdb/md", "OBJECTID<5", "DEFINE_MISSING_TILES", 
     "NO_GENERATE_OVERVIEWS", "IGNORE_MISSING_IMAGES", "IGNORE_STALE_IMAGES")

BuildOverviews 示例 2（独立脚本）

这是 BuildOverviews 的 Python 脚本示例。

# Define Overviews for selected items only

import arcpy
arcpy.env.workspace = "C:/Workspace"

    
arcpy.BuildOverviews_management("Overviews.gdb/md", "OBJECTID<5", 
                                "DEFINE_MISSING_TILES",
                                "NO_GENERATE_OVERVIEWS", "#", "#")

环境

范围, 并行处理因子

许可信息

ArcGIS for Desktop Basic:否

ArcGIS for Desktop Standard:是

ArcGIS for Desktop Advanced:是