构建概视图 (数据管理)

描述

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

使用方法

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

• 必须选中定义缺失概视图切片、生成概视图，或者同时选中这两项。

• 概视图的第一个级别在镶嵌数据集的全分辨率下创建。后续各个级别均在上一次生成的概视图级别基础上构建。

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

• 默认情况下，如果概视图是针对文件地理数据库中的镶嵌数据集而生成的，它们将存储在文件夹 <gdbname>.Overviews 中，该文件夹与包含镶嵌数据集的地理数据库处于同一位置。在企业级地理数据库上生成的镶嵌数据集概视图存储在包含镶嵌数据集的地理数据库中。更改这些位置优先使用定义概视图工具，并指定新位置。

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

语法

arcpy.management.BuildOverviews(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

派生输出

名称	说明	数据类型
out_mosaic_dataset	已更新的镶嵌数据集。	镶嵌图层

代码示例

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", "#", "#")

环境

并行处理因子

许可信息

• Basic: 否
• Standard: 是
• Advanced: 是