Skip To Content

Analyze Mosaic Dataset


Performs checks on a mosaic dataset for errors and possible improvements.


  • To examine the analysis results, open the mosaic dataset, right-click the mosaic dataset in the Contents pane and click Data > Analyze Mosaic Dataset. The Analyze Mosaic Dataset pane opens. Click on the Messages tab, which allows you to view and interact with the errors, warnings, and messages. When you right-click on an error, warning, or message, a recommended action is listed.

  • The errors and warnings are categorized in the following way:

    • A high-priority error indicates that an issue exists where you may not be able to use the mosaic dataset. Some examples of a high-priority error include invalid visibility or inability to open a raster dataset.
    • A medium-priority error indicates an issue that directly affects your mosaic dataset authoring experience. These errors will usually indicate that a geoprocessing tool will likely fail with these mosaic datasets. Some examples of a medium-priority error include an empty mosaic dataset or an invalid raster type ID.
    • A low-priority error indicates that an issue might affect some of the user experiences related to the mosaic dataset or a derived image service. Some examples of a low-priority error include an invalid CenterXY field or broken paths.
    • A high-priority warning indicates an issue related to performance or optimum display. Some examples of a high-priority warning include missing overviews, missing mosaic dataset statistics, and missing raster dataset statistics.
    • A low-priority warning indicates an issue with recommendations that may not have been followed. These recommendations usually ensure smoother and efficient operation, but are not required. Some examples of a low-priority warning include bad metadata, a JPEG quality set too low, too many uncompressed pixels in the mosaic dataset, or missing raster pyramids.

    The returned messages report statistical facts related to the mosaic dataset.

  • In the results table, many of the errors and warnings can be fixed by right-clicking on the issue.


AnalyzeMosaicDataset_management (in_mosaic_dataset, {where_clause}, {checker_keywords})
ParameterExplanationData Type

The mosaic dataset you want to analyze.

Mosaic Layer

An SQL statement that confines your analysis to specific raster datasets within this mosaic dataset.

SQL Expression

Choose which parts of the mosaic dataset you want to analyze for known issues.

  • FOOTPRINT Analyze the footprint geometry of each selected mosaic dataset item. This is checked on by default.
  • FUNCTION Analyze the function chains for each selected mosaic dataset item.
  • RASTER Analyze the original raster datasets. This is checked on by default.
  • PATHS Check for broken paths. This is checked on by default.
  • SOURCE_VALIDITY Analyze potential problems with the source data associated with each mosaic dataset item in the selected mosaic dataset. This is a good way to detect issues that may arise during synchronization workflows.
  • STALE Overviews are stale when the underlying source data has changed. Once the mosaic dataset is analyzed, you can select which items are stale by right-clicking on the error and choosing Select Associated Items on the context menu.
  • PYRAMIDS Analyze the raster pyramids associated with each mosaic dataset item in the selected mosaic dataset. Test for disconnected auxiliary files which can occur when they are stored in a raster proxy location.
  • STATISTICS Test for disconnected auxiliary statistics files if they are stored in the raster proxy location. Analyze the covariance matrix associated with the raster, when the Gram-Schmidt pan-sharpening method is enabled. Analyze the radiometric pixel depth of a mosaic dataset item against the pixel depth of the mosaic dataset.
  • PERFORMANCE Factors that increase performance include compression during transmission and caching items with many raster functions.
  • INFORMATION Generate general information about the mosaic dataset.

Code sample

AnalyzeMosaicDataset example 1 (Python window)

This is a Python sample for the AnalyzeMosaicDataset tool.

import arcpy
     "\\cpu\data\analyze.gdb\mosaicds", "SensorName = 'Landsat-7-ETM+'",
AnalyzeMosaicDataset example 2 (stand-alone script)

This is a Python script sample for the AnalyzeMosaicDataset tool.

#Analyze Mosaic Dataset with query definition
#Analyze all components of mosaic dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"

mdname = "analyzemd.gdb/mosaicds"
query = "SensorName = 'Landsat-7-ETM+'"

arcpy.AnalyzeMosaicDataset_management(mdname, query, checks)

Licensing information

  • ArcGIS Desktop Basic: No
  • ArcGIS Desktop Standard: Yes
  • ArcGIS Desktop Advanced: Yes