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.

Syntax

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

Parameter	Explanation	Data 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

Name	Explanation	Data 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)

Environments

Parallel Processing Factor

Licensing information

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