Skip to main content

Remove Rasters From Mosaic Dataset (Data Management Tools)

Summary

Removes selected rasters from a mosaic dataset.

Usage

  • You must specify a selection or a query ; otherwise, the tool will not run. To delete all the records from the mosaic dataset, specify a query that selects all the rasters, such as "OBJECTID>=0".

  • If the overviews are generated in the mosaic dataset, they will be deleted when they are removed, because they are managed by the mosaic dataset. If you created the overviews in a folder or a location other than the default location, they are not fully managed by the mosaic dataset and you can remove them without deleting them from disk. You may want to do this if you are using the overviews elsewhere.

  • If you identify the affected overviews but do not delete them, you can use the Build Overviews tool to regenerate the affected overviews.

  • This tool will also delete the cache created for each item in the mosaic dataset. Both raster cache and LAS cache can be removed. The properties for the cache for these datasets is defined in their functions.

  • Database fragmentation and frequent data manipulation can significantly increase the size of a mosaic dataset. If the database size is large due to constant transactions, run the Compact tool.

Parameters

Label Explanation Data type

Mosaic Dataset

The mosaic dataset containing the rasters that will be removed.

Mosaic Layer

Query Definition

(Optional)

An SQL expression to select the raster datasets that will be removed from the mosaic dataset.

You must specify a selection or a query; otherwise, the tool will not run. To delete all the records from the mosaic dataset, specify a query that selects all the rasters, such as "OBJECTID>=0".

SQL Expression

Update Boundary

(Optional)

Specifies whether the boundary polygon of the mosaic dataset will be updated. By default, the boundary merges all the footprint polygons to create a single boundary representing the extent of the valid pixels.

  • Checked—The boundary polygon of the mosaic dataset will be updated. This is the default.

  • Unchecked—The boundary polygon of the mosaic dataset will not be updated.

Boolean

Mark Affected Overviews

(Optional)

Specifies whether affected overviews will be identified.

When the rasters in a mosaic dataset have been removed, overviews created using those rasters may no longer be accurate. Use this parameter to identify affected overviews so they can be updated or removed if they are no longer needed.

  • Checked—The affected overviews will be identified. This is the default.

  • Unchecked—The affected overviews will not be identified.

Boolean

Delete Overview Images

(Optional)

Specifies whether the overviews associated with the selected rasters will be removed.

  • Checked—The overviews associated with the selected rasters will be deleted. This is the default.

  • Unchecked—The overviews associated with the selected rasters will not be deleted.

Boolean

Delete Item Cache

(Optional)

Specifies whether the cache that is based on any source raster dataset that will be removed from the mosaic dataset will also be removed.

  • Checked—The cache that is based on any source raster dataset that will be removed from the mosaic dataset will also be removed. This is the default.

  • Unchecked—The cache will not be removed and will remain a part of the mosaic dataset.

Boolean

Remove Mosaic Dataset Items

(Optional)

Specifies whether mosaic dataset items will be removed.

  • Checked—Mosaic dataset items will be removed. This is the default.

  • Unchecked—Mosaic dataset items will not be removed.

Boolean

Update Cell Size Ranges

(Optional)

Specifies whether the cell size ranges for the mosaic dataset will be updated.

  • Checked—The cell size ranges for the mosaic dataset will be updated. Use this if you are removing all of the imagery at a specific cell size. This is the default.

  • Unchecked—The cell size ranges for the mosaic dataset will not be updated.

Boolean

Derived output

Label Explanation Data type

Updated Mosaic Dataset

The updated mosaic dataset.

Mosaic Layer

Environments

Extent, Parallel Processing Factor

Licensing information

  • Basic: No
  • Standard: Yes
  • Advanced: Yes