描述
允许您设置生成镶嵌数据集概视图的方式。构建概视图工具将使用您通过此工具创建的设置。
使用方法
当需要设置特殊的参数来生成概视图时可使用此工具,例如
- 定义文件写入位置
- 定义根据边界而变化的范围
- 定义概视图图像的属性,例如重采样或压缩方法
- 定义概视图采样系数
使用构建概视图工具可在已通过此工具定义了概视图之后生成概视图。
可以使用面要素类定义概视图的覆盖区。如果不想使用要素类中的所有面,则可以对内容列表中的图层进行选择,或者使用按属性选择图层或按位置选择图层选择所需的面。
默认分块大小为 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 (可选) | 在所有等级生成概视图,或仅在现有金字塔等级之上生成概视图。
| Boolean |
resampling_method (可选) | 在概视图中选择聚合像素值的算法。
| String |
compression_method (可选) | 定义存储概视图图像的数据压缩类型。
| 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: 是