从镶嵌数据集中移除栅格 (数据管理)

摘要

从镶嵌数据集中移除所选的栅格。

使用情况

  • 必须指定选择或查询;否则,该工具将不会运行。 要从镶嵌数据集中删除所有记录,请指定一个选择所有栅格的查询,例如 "OBJECTID>=0"

  • 如果概视图是在镶嵌数据集中生成的,则其将在移除时被删除,因为它们是由镶嵌数据集管理的。 如果您在文件夹或默认位置以外的位置创建了概视图,则它们不完全由镶嵌数据集管理,可以将其移除而不会从磁盘中将其删除。 如果在其他位置使用概视图,则可能需要执行此操作。

  • 如果您已识别受影响的概视图但不删除它们,则可以使用构建概视图工具重新生成受影响的概视图。

  • 此工具还将删除为镶嵌数据集中的各项目创建的缓存。 将移除栅格缓存和 LAS 缓存。 这些数据集的缓存属性将在其函数中进行定义。

  • 数据库碎片和频繁的数据操纵可显著增大镶嵌数据集的大小。 如果由于恒定事务导致数据库大小增加,请运行数据库碎片整理工具。

参数

标注说明数据类型
镶嵌数据集

包含要移除的栅格的镶嵌数据集。

Mosaic Layer
查询定义
(可选)

用于选择将从镶嵌数据集中移除的栅格数据集的 SQL 表达式。

必须指定选择或查询;否则,该工具将不会运行。 要从镶嵌数据集中删除所有记录,请指定一个选择所有栅格的查询,例如 "OBJECTID>=0"

SQL Expression
更新边界
(可选)

指定是否更新镶嵌数据集的边界面。 默认情况下,边界会合并所有轮廓线面以创建一个表示有效像素范围的边界。

  • 选中 - 将更新镶嵌数据集的边界面。 这是默认设置。
  • 未选中 - 不会更新镶嵌数据集的边界面。
Boolean
标记受影响的概视图
(可选)

指定是否将识别受影响的概视图。

移除镶嵌数据集中的栅格后,使用这些栅格创建的概视图可能不再准确。 使用此参数可识别受影响的概视图,以便在不再需要时对其进行更新或移除。

  • 选中 - 将识别受影响的概视图。 这是默认设置。
  • 未选中 - 不会识别受影响的概视图。
Boolean
删除概视图图像
(可选)

指定是否删除与所选栅格关联的概视图。

  • 选中 - 将删除与所选栅格关联的概视图。 这是默认设置。
  • 未选中 - 不会删除与所选栅格关联的概视图。
Boolean
删除项目缓存
(可选)

指定是否移除基于要从镶嵌数据集中移除的所有源栅格数据集的缓存。

  • 选中 - 将移除基于要从镶嵌数据集中移除的所有源栅格数据集的缓存。 这是默认设置。
  • 未选中 - 不会移除缓存,其将作为镶嵌数据集的一部分保留。
Boolean
移除镶嵌数据集项目
(可选)

指定是否移除镶嵌数据集项目。

  • 选中 - 将移除镶嵌数据集项目。 这是默认设置。
  • 未选中 - 不会移除镶嵌数据集项目。
Boolean
更新像元大小范围
(可选)

指定是否更新镶嵌数据集的像元大小范围。

  • 选中 - 将更新镶嵌数据集的像元大小范围。 这是默认设置。
  • 未选中 - 不会更新镶嵌数据集的像元大小范围。
Boolean

派生输出

标注说明数据类型
更新的镶嵌数据集

已更新的镶嵌数据集。

Mosaic Layer

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
(可选)

指定是否更新镶嵌数据集的边界面。 默认情况下,边界会合并所有轮廓线面以创建一个表示有效像素范围的边界。

  • UPDATE_BOUNDARY将更新镶嵌数据集的边界面。 这是默认设置。
  • NO_BOUNDARY不会更新镶嵌数据集的边界面。
Boolean
mark_overviews_items
(可选)

指定是否将识别受影响的概视图。

移除镶嵌数据集中的栅格后,使用这些栅格创建的概视图可能不再准确。 使用此参数可识别受影响的概视图,以便在不再需要时对其进行更新或移除。

  • MARK_OVERVIEW_ITEMS将识别受影响的概视图。 这是默认设置。
  • NO_MARK_OVERVIEW_ITEMS不会识别受影响的概视图。
Boolean
delete_overview_images
(可选)

指定是否移除与所选栅格关联的概视图。

  • DELETE_OVERVIEW_IMAGES将删除与所选栅格关联的概视图。 这是默认设置。
  • NO_DELETE_OVERVIEW_IMAGES不会删除与所选栅格关联的概视图。
Boolean
delete_item_cache
(可选)

指定是否移除基于要从镶嵌数据集中移除的所有源栅格数据集的缓存。

  • DELETE_ITEM_CACHE将移除基于要从镶嵌数据集中移除的所有源栅格数据集的缓存。 这是默认设置。
  • NO_DELETE_ITEM_CACHE不会移除缓存,其将作为镶嵌数据集的一部分保留。
Boolean
remove_items
(可选)

指定是否移除镶嵌数据集项目。

  • REMOVE_MOSAICDATASET_ITEMS将移除镶嵌数据集项目。 这是默认设置。
  • NO_REMOVE_MOSAICDATASET_ITEMS不会移除镶嵌数据集项目。
Boolean
update_cellsize_ranges
(可选)

指定是否更新镶嵌数据集的像元大小范围。

  • UPDATE_CELL_SIZES将更新镶嵌数据集的像元大小范围。 如果要移除特定像元大小的所有影像,请使用此选项。 这是默认设置。
  • NO_CELL_SIZES不会更新镶嵌数据集的像元大小范围。
Boolean

派生输出

名称说明数据类型
out_mosaic_dataset

已更新的镶嵌数据集。

Mosaic Layer

代码示例

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)