定义概视图 (数据管理)

描述

允许您设置生成镶嵌数据集概视图的方式。构建概视图工具将使用您通过此工具创建的设置。

使用方法

• 当需要设置特殊的参数来生成概视图时可使用此工具，例如

  • 定义文件写入位置
  • 定义根据边界而变化的范围
  • 定义概视图图像的属性，例如重采样或压缩方法
  • 定义概视图采样系数
  此外，您可以使用添加栅格至镶嵌数据集工具选中更新概视图选项，将使用默认设置。

• 使用构建概视图工具可在已通过此工具定义了概视图之后生成概视图。

• 可以使用面要素类定义概视图的覆盖区。如果不想使用要素类中的所有面，则可以对内容列表中的图层进行选择，或者使用按属性选择图层或按位置选择图层选择所需的面。

• 默认分块大小为 128 × 128。可以在“环境设置”中更改分块大小。

• 如果边界包含很多折点，则该工具的运行时间会比较长。

语法

arcpy.management.DefineOverviews(in_mosaic_dataset, {overview_image_folder}, {in_template_dataset}, {extent}, {pixel_size}, {number_of_levels}, {tile_rows}, {tile_cols}, {overview_factor}, {force_overview_tiles}, {resampling_method}, {compression_method}, {compression_quality})

参数	说明	数据类型
in_mosaic_dataset	要在其中构建概视图的镶嵌数据集。	Mosaic Layer
overview_image_folder （可选）	用于存储概视图的文件夹或地理数据库。	Workspace
in_template_dataset （可选）	一个栅格数据集或要素类，用来定义概视图的范围。	Raster Layer; Feature Layer
extent （可选）	使用最小和最大 x 和 y 坐标设置范围。 此参数按以下顺序以空格分隔的形式加以指定：X-minimum X-maximum Y-minimum Y-maximum。 如果未定义范围，则镶嵌数据集边界将确定概视图的范围。	Envelope
pixel_size （可选）	如果不想使用所有栅格金字塔，可指定将生成概视图的基础像素大小。 此参数的单位与镶嵌数据集的空间参考单位相同。	Double
number_of_levels （可选）	指定用于生成概视图的概视图等级数。值 -1 将用于确定最佳值。	Long
tile_rows （可选）	设置每个切片的行数（以像素为单位）。 较大值将生成更少的较大单个概视图，同时增加需要重新生成较低等级概视图的可能性。较小值将生成更多较小的文件。	Long
tile_cols （可选）	设置每个切片的列数（以像素为单位）。 较大值将生成更少的较大单个概视图，同时增加需要重新生成较低等级概视图的可能性。较小值将生成更多较小的文件。	Long
overview_factor （可选）	设置用于确定下一个概视图大小的比率。例如，如果第一个等级的像元大小为 10，概视图系数为 3，则下一个概视图像素大小将为 30。	Long
force_overview_tiles （可选）	在所有等级生成概视图，或仅在现有金字塔等级之上生成概视图。 NO_FORCE_OVERVIEW_TILES —在栅格金字塔等级之上创建概视图。这是默认设置。 FORCE_OVERVIEW_TILES — 在所有等级创建概视图。	Boolean
resampling_method （可选）	在概视图中选择聚合像素值的算法。 NEAREST —这是最快的重采样方法，因为此方法可将像素值的更改内容最小化。适用于离散数据，例如土地覆被。如果栅格元数据数据类型为专题型，则最邻近法为默认方法。 BILINEAR —可采用平均化（距离权重）周围 4 个像素的值计算每个像素的值。适用于连续数据。除非栅格元数据数据类型为专题型，否则这是默认方法。 CUBIC — 通过根据周围的 16 像素拟合平滑曲线来计算每个像素的值。生成平滑影像，但可创建位于源数据中超出范围外的值。适用于连续数据。	String
compression_method （可选）	定义存储概视图图像的数据压缩类型。 JPEG —有损压缩。除非栅格元数据数据类型为专题型，否则这是默认方法。此压缩方法仅在镶嵌数据集符合 JPEG 规范时才有效。 JPEG_YCbCr —有损压缩使用亮度 (Y) 和色度（Cb 和 Cr）颜色空间组件。 None —无数据压缩。 LZW —无损压缩。如果栅格元数据数据类型为专题型，则最邻近法为默认方法。	String
compression_quality （可选）	选择一个 1 到 100 之间的值。较高的值可生成更高质量的输出，但创建的文件也更大。	Long

派生输出

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

代码示例

DefineOverviews 示例 1（Python 窗口）

这是 DefineOverviews 的 Python 示例。

import arcpy
arcpy.DefineOverviews_management("c:/workspace/fgdb.gdb/md01", 
                                 "c:/temp", "#", "#", "30", "6", "4000", 
                                 "4000", "2", "CUBIC", "JPEG", "50")

DefineOverviews 示例 2（独立脚本）

这是 DefineOverviews 的 Python 脚本示例。

#Define Overviews to the default location
#Define Overviews for all levels - ignore the primary Raster pyramid
#Define Overviews compression and resampling method

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

    
arcpy.DefineOverviews_management("DefineOVR.gdb/md", "#", "#", "#", "#", 
                                 "#", "#", "#", "#", "FORCE_OVERVIEW_TILES",
                                     "BILINEAR", "JPEG", "50")

环境

范围, 并行处理因子, 分块大小

许可信息

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