构建概视图 (数据管理)

摘要

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

使用情况

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

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

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

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

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

参数

对话框

标注	说明	数据类型
镶嵌数据集	用来构建概视图的镶嵌数据集。	Mosaic Layer
查询定义 (可选)	用来在镶嵌数据集中选择特定栅格的 SQL 语句。选定栅格将构建其自己的概视图。	SQL Expression
定义缺失概视图切片 (可选)	识别需要概视图的位置并定义概视图。 选中 - 自动识别需要概视图的位置并定义概视图。这是默认设置。 未选中 - 不定义新的概视图。	Boolean
生成概视图 (可选)	生成所有需要创建或重新创建的概视图。这包括缺失的概视图和过时的概视图。 选中 - 生成所有概视图，包括已经存在的概视图。这是默认设置。 未选中 - 只生成已经定义但尚未生成的概视图。	Boolean
仅生成缺失概视图影像 (可选)	在已经定义但尚未生成概视图时使用。 选中 - 生成已经定义但尚未生成的概视图。这是默认设置。 取消选中 - 不生成已经定义但尚未生成的金字塔。	Boolean
仅重新生成过时概视图影像 (可选)	更改基础栅格数据集或修改其属性时，会导致概视图过时。 选中 - 识别并重新生成过时概视图。这是默认设置。 未选中 - 不重新生成过时概视图。	Boolean

派生输出

标注	说明	数据类型
更新的镶嵌数据集	已更新的镶嵌数据集。	镶嵌图层

Python

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

环境

并行处理因子