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

摘要

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

使用情况

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

  • 您可以选择移除概视图,但不将其删除。如果金字塔是在镶嵌数据集中生成的,在移除金字塔后,会将其删除(因为金字塔由镶嵌数据集管理)。如果概视图是在文件夹或非默认位置创建的,则不会完全由镶嵌数据集管理;因此,可以移除概视图但并不从磁盘中删除。如果在别处使用了该概视图,最好不要将其删除。

  • 如果选择对受影响的概视图进行标记但不将其删除,则可以用“构建概视图”工具重新生成受影响的概视图。

  • 此工具还会删除镶嵌数据集中为每个项目创建的缓存。可移除栅格缓存和 LAS 缓存。这些数据集的缓存的属性在其对应函数中定义。

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

参数

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

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

Mosaic Layer
查询定义
(可选)

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

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

SQL Expression
更新边界
(可选)

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

  • 选中 - 将更新边界。这是默认设置。
  • 取消选中 - 不更新边界。
Boolean
标记受影响的概视图
(可选)

镶嵌目录中的栅格被移除后,任何使用这些栅格创建的金字塔可能都不再准确,因此,可将其识别出来以便更新,如果不再需要这些金字塔,也可以将其移除。

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

移除与所选栅格相关的概视图。

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

将基于任何要从镶嵌数据集中移除的源栅格数据集移除缓存。

  • 选中 - 移除项目及其相应缓存。这是默认设置。
  • 取消选中 - 将缓存保留为镶嵌数据集的一部分。
Boolean
移除镶嵌数据集项
(可选)

移除项目、缓存、概视图和栅格数据集。或仅移除缓存和概视图,并保留栅格数据集。

  • 选中 - 从镶嵌数据集中移除项目。这是默认设置。
  • 取消选中 - 移除项目缓存和任何相关概视图,而不是项目本身。
Boolean
更新像元大小范围
(可选)

更新镶嵌数据集的像元大小范围。如果要移除所有具有特定像元大小的图像,请选择此选项。

  • 选中 - 更新像元大小范围。这是默认设置。
  • 取消选中 - 不更新像元大小范围。
Boolean

派生输出

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

已更新的镶嵌数据集。

镶嵌图层

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

已更新的镶嵌数据集。

镶嵌图层

代码示例

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: 是

相关主题