同步镶嵌数据集 (数据管理)
摘要
使用最初添加镶嵌数据集时所使用的栅格类型及选项在镶嵌数据集中重新构建栅格项目和更新受影响的字段。
用法
-
此工具会使用相应的数据源在镶嵌数据集中重新构建所选项目。由于所选项目会重新进行构建，因此自上次构建以来对这些项目所做的任何修改都会丢失。
此工具对于使镶嵌数据集保持最新状态特别有用。可以使用此工具检测和添加已添加到镶嵌数据集中的数据所在的文件夹位置的新栅格数据集。用外部托管数据库中的表填充的镶嵌数据集也可以使用此工具进行更新。
此工具还可为镶嵌数据集所引用的所有栅格数据集构建金字塔、计算统计数据以及创建缩略图。
语法
| 参数 | 说明 | 数据类型 |
in_mosaic_dataset |
镶嵌数据集的路径和名称。 | Mosaic Layer |
where_clause （可选） |
可以使用 SQL 定义查询，或者使用查询构建器构建查询。 | SQL Expression |
new_items （可选） | 选择镶嵌数据集是否与新添加的项目进行同步。如果您选择使用此选项，则将为新图像搜索项目的工作空间。当图像添加到镶嵌数据集后，其使用的栅格类型将与同一工作空间内的其他项目相同。 如果选择使用新项目进行更新，则可以选择是否更新像元大小范围、更新边界或更新金字塔参数。
| Boolean |
sync_only_stale （可选） |
如果用于创建派生栅格（如金字塔）的基础栅格已经同步，则会更新金字塔。
| Boolean |
update_cellsize_ranges （可选） | 选择是否更新像元大小范围。仅当已将 new_items 设置为 UPDATE_WITH_NEW_ITEMS 时此参数才可用。
| Boolean |
update_boundary （可选） | 选择是否更新边界。仅当已将 new_items 设置为 UPDATE_WITH_NEW_ITEMS 时此参数才可用。
| Boolean |
update_overviews （可选） | 选择是否更新像元大小范围。仅当已将 new_items 设置为 UPDATE_WITH_NEW_ITEMS 时此参数才可用。
| Boolean |
build_overviews （可选） |
金字塔是为提高查看镶嵌数据集时的显示速度而创建的低分辨率栅格数据集。通常，创建的金字塔会覆盖镶嵌数据集中栅格数据的范围。它们类似于栅格金字塔。 如果修改了基础栅格，可能需要重新构建金字塔。
| Boolean |
build_pyramids （可选） |
可以为镶嵌数据集中的每个栅格项目构建金字塔。金字塔可以提高每个栅格的显示速度。
| Boolean |
calculate_statistics （可选） |
可以为镶嵌数据集中的每个栅格项目计算统计数据。在执行某些任务时（如应用对比度拉伸），需要对镶嵌数据集进行统计。
| Boolean |
build_thumbnails （可选） |
缩略图是可为镶嵌定义中的每个栅格项目创建的较小的高度重采样图像。可在以影像服务形式访问镶嵌数据集时访问缩略图，缩略图将显示为元数据（项目描述）的一部分。
| Boolean |
代码示例
这是 SynchronizeMosaicDataset 的 Python 示例。
import arcpy
arcpy.SynchronizeMosaicDataset_management("c:/workspace/fgdb.gdb/sync", \
"Year>1999", "UPDATE_WITH_NEW_ITEMS", \
"SYNC_STALE","#", "#", \
"UPDATE_OVERVIEWS", "#", "#", \
"BUILD_THUMBNAILS")
这是 SynchronizeMosaicDataset 的 Python 脚本示例。
##===========================
##Synchronize Mosaic Dataset
##Usage: SynchronizeMosaicDataset_management in_mosaic_dataset {where_clause}
## {NO_NEW_ITEMS | UPDATE_WITH_NEW_ITEMS}
## {SYNC_STALE | SYNC_ALL} {UPDATE_CELL_SIZES
## | NO_CELL_SIZES} {UPDATE_BOUNDARY | NO_BOUNDARY}
## {NO_OVERVIEWS | UPDATE_OVERVIEWS} {NO_PYRAMIDS
## | BUILD_PYRAMIDS} {NO_STATISTICS |
## CALCULATE_STATISTICS} {NO_THUMBNAILS
## | BUILD_THUMBNAILS}
try:
import arcpy
arcpy.env.workspace = r"C:/Workspace"
# Synchronize data item after Year 1999
arcpy.SynchronizeMosaicDataset_management("Sync.gdb/md", "Year>1999", \
"UPDATE_WITH_NEW_ITEMS", "SYNC_STALE",\
"#", "#", "UPDATE_OVERVIEWS", "#",
"#", "BUILD_THUMBNAILS")
except:
print "Synchronize Mosaic Dataset example failed."
print arcpy.GetMessages()