从镶嵌数据集中移除栅格 (Data Management)
摘要
从镶嵌数据集中移除选定栅格(项目)。
用法
- 必须指定选择或查询;否则此工具不会运行。如果要从镶嵌数据集中删除所有记录,请指定一个用于选择所有栅格的查询,例如“OBJECTID>=0”。 
- 
您可以选择移除概视图,但不将其删除。如果概视图是在镶嵌数据集内生成的,则在移除概视图后,会自动将其删除(因为概视图由镶嵌数据集管理)。如果概视图是在文件夹或非默认位置创建的,则不会完全由镶嵌数据集管理;因此,可以移除概视图但并不从磁盘中删除。如果在别处使用了该概视图,最好不要将其删除。 
- 如果选择对受影响的概视图进行标记但不将其删除,则可以用“构建概视图”工具重新生成受影响的概视图。 
- 此工具还会删除镶嵌数据集中为每个项目创建的缓存。可移除栅格缓存和 LAS 缓存。这些数据集的缓存的属性在其对应函数中定义。 
- 此工具将不会重新计算镶嵌数据集的范围。要重新计算范围,需要重新计算镶嵌数据集属性 窗口中的要素范围。 
- 数据库碎片和频繁的数据操纵可能会显著增大镶嵌数据集的大小。如果由于恒定事务导致数据库膨胀,则应运行数据库碎片整理工具。 
语法
| 参数 | 说明 | 数据类型 | 
| in_mosaic_dataset | 镶嵌数据集的路径和名称。 | Mosaic Layer | 
| where_clause (可选) | 使用 SQL 定义的查询或使用“查询构建器”构建的查询都可用于定义将从镶嵌数据集中移除的栅格数据集。 必须指定选择或查询;否则此工具不会运行。如果要从镶嵌数据集中删除所有记录,请指定一个用于选择所有栅格的查询,例如“OBJECTID>=0”。 | SQL Expression | 
| update_boundary (可选) | 更新镶嵌数据集的边界面。默认情况下,边界会合并所有轮廓线面以创建一个表示有效像素范围的边界。 
 | Boolean | 
| mark_overviews_items (可选) | 镶嵌目录中的栅格被移除后,任何使用这些栅格创建的概视图可能都不再准确,因此,可将其识别出来以便更新,如果不再需要这些概视图,也可以将其移除。 
 | Boolean | 
| delete_overview_images (可选) | 源栅格被移除后,所有不再需要的概视图也都可从镶嵌数据集中移除。仅当选择了概视图项时,才能移除概视图。 
 | Boolean | 
| delete_item_cache (可选) | 选择是否删除与正在移除的任何镶嵌数据集项目相关联的缓存。 
 | Boolean | 
| remove_items (可选) | 选择是从镶嵌数据集删除项目(例如栅格数据集),还是只删除相关联的概视图或缓存。 
 | Boolean | 
| update_cellsize_ranges (可选) | 选择是否为镶嵌数据集更新像元大小范围。 
 | Boolean | 
代码实例
这是 RemoveRastersFromMosaicDataset 的 Python 示例。
import arcpy
arcpy.RemoveRastersFromMosaicDataset_management(
     "C:/Workspace/remove.gdb/md", "YEAR<1999", "UPDATE_BOUNDARY", 
     "MARK_OVERVIEW_ITEMS",  "#", "#", "#", "#")
这是 RemoveRastersFromMosaicDataset 的 Python 脚本示例。
#Delete Overviews with Query
import arcpy
arcpy.env.workspace = "C:/Workspace"
mdname = "remove.gdb/md2"
query = "#"
updatebnd = "#"
markovr = "#"
delovr = "DELETE_OVERVIEW_IMAGES"
delitemcache = "#"
removeitem = "NO_REMOVE_MOSAICDATASET_ITEMS"
updatecs = "UPDATE_CELL_SIZES"
arcpy.RemoveRastersFromMosaicDataset_management(
     mdname, query, updatebnd, markovr, delovr, delitemcache, 
     removeitem, updatecs)