从镶嵌数据集中移除栅格 (Data Management)
摘要
从镶嵌数据集中移除选定栅格(项目)。
用法
必须指定选择或查询;否则此工具不会运行。如果要从镶嵌数据集中删除所有记录,请指定一个用于选择所有栅格的查询,例如“OBJECTID>=0”。
-
您可以选择移除金字塔 (overview),但不将其删除。如果金字塔是在镶嵌数据集内生成的,在移除金字塔后,会自动将其删除(因为金字塔由镶嵌数据集管理)。如果金字塔是在文件夹或非默认位置创建的,则不会完全由镶嵌数据集管理;因此,可以移除金字塔但并不从磁盘中删除。如果在别处使用了该金字塔,最好不要将其删除。
如果选择对受影响的金字塔进行标记但不将其删除,则可以用“构建金字塔(Overview)”工具重新生成受影响的金字塔。
此工具还会删除镶嵌数据集中为每个项目创建的缓存。可移除栅格缓存和 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)