Analyze Mosaic Dataset (Data Management)

Summary

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

Usage

  • 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 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.

Parameters

LabelExplanationData Type
Mosaic Dataset

The mosaic dataset you want to analyze.

Mosaic Layer
Query Definition
(Optional)

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

SQL Expression
Checks Performed
(Optional)

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

  • Footprint geometry — Analyze the footprint geometry of each selected mosaic dataset item. This is checked on by default.
  • Function chains — Analyze the function chains for each selected mosaic dataset item.
  • Raster — Analyze the original raster datasets. This is checked on by default.
  • Broken 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 — 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 clicking 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.
String

Derived Output

LabelExplanationData Type
Mosaic Dataset

The updated mosaic dataset.

Mosaic Layer

arcpy.management.AnalyzeMosaicDataset(in_mosaic_dataset, {where_clause}, {checker_keywords})
NameExplanationData Type
in_mosaic_dataset

The mosaic dataset you want to analyze.

Mosaic Layer
where_clause
(Optional)

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

SQL Expression
checker_keywords
[checker_keywords,...]
(Optional)

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 clicking 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.
String

Derived Output

NameExplanationData Type
out_mosaic_dataset

The updated mosaic dataset.

Mosaic Layer

Code sample

AnalyzeMosaicDataset example 1 (Python window)

This is a Python sample for the AnalyzeMosaicDataset tool.

import arcpy
arcpy.AnalyzeMosaicDataset_management(
     "\\cpu\data\analyze.gdb\mosaicds", "SensorName = 'Landsat-7-ETM+'",
     "FOOTPRINT;FUNCTION;RASTER;PATHS;PYRAMIDS")
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+'"
checks = "FOOTPRINT;FUNCTION;RASTER;PATHS;STALE;PYRAMIDS;PERFORMANCE"

arcpy.AnalyzeMosaicDataset_management(mdname, query, checks)

Licensing information

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

Related topics