描述
从镶嵌数据集中移除选定栅格数据集。
使用方法
必须指定选择或查询,否则此工具不会运行。如果要从镶嵌数据集中删除所有记录,请指定一个用于选择所有栅格的查询,例如 "OBJECTID>=0"。
您可以选择移除概视图,但不将其删除。如果金字塔是在镶嵌数据集中生成的,在移除金字塔后,会将其删除(因为金字塔由镶嵌数据集管理)。如果概视图是在文件夹或非默认位置创建的,则不会完全由镶嵌数据集管理;因此,可以移除概视图但并不从磁盘中删除。如果在别处使用了该概视图,最好不要将其删除。
如果选择对受影响的概视图进行标记但不将其删除,则可以用“构建概视图”工具重新生成受影响的概视图。
此工具还会删除镶嵌数据集中为每个项目创建的缓存。可移除栅格缓存和 LAS 缓存。这些数据集的缓存的属性在其对应函数中定义。
此工具将不会重新计算镶嵌数据集的范围。要重新计算范围,需要重新计算镶嵌数据集属性窗口中的要素范围。
数据库碎片和频繁的数据操纵可显著增大镶嵌数据集的大小。如果由于恒定事务导致数据库膨胀,请运行数据库碎片整理工具。
语法
arcpy.management.RemoveRastersFromMosaicDataset(in_mosaic_dataset, {where_clause}, {update_boundary}, {mark_overviews_items}, {delete_overview_images}, {delete_item_cache}, {remove_items}, {update_cellsize_ranges})
参数 | 说明 | 数据类型 |
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 |
派生输出
名称 | 说明 | 数据类型 |
out_mosaic_dataset | 已更新的镶嵌数据集。 | 镶嵌图层 |
代码示例
RemoveRastersFromMosaicDataset 示例 1(Python 窗口)
这是 RemoveRastersFromMosaicDataset 的 Python 示例。
import arcpy
arcpy.RemoveRastersFromMosaicDataset_management(
"C:/Workspace/remove.gdb/md", "YEAR<1999", "UPDATE_BOUNDARY",
"MARK_OVERVIEW_ITEMS", "#", "#", "#", "#")
RemoveRastersFromMosaicDataset 示例 2(独立脚本)
这是 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)
环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是