Analyze Mosaic Dataset (Data Management)

Summary

Examines a mosaic dataset to determine solutions for known errors and other issues, and to detect methods for optimization. The errors, warnings, and messages can be examined when the mosaic dataset is open within ArcMap.

Usage

• To examine the analysis results, open the mosaic dataset in ArcMap, right-click the mosaic dataset in the table of contents and click Data > View Analysis Results. The Prepare window opens allowing 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.

  A message reports 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.

• Messages do not have a solution, since there is no issue at hand.

Syntax

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

Parameter	Explanation	Data Type
in_mosaic_dataset	The mosaic dataset to be analyzed.	Image Service; Mosaic Layer; String
where_clause (Optional)	You can define a query to confine the analysis to specific rasters within the mosaic dataset. Using SQL you can define a query or use the Query Builder to build a query.	SQL Expression
checker_keywords [checker_keywords,...] (Optional)	Choose which parts of the mosaic dataset you want to analyze for known issues. FOOTPRINT —The checker analyzes the footprint geometry of each selected mosaic dataset item. This is checked on by default. FUNCTION —The checker analyzes the raster function stack of the raster associated with each selected mosaic dataset item. This is checked on by default. RASTER —The checker analyzes the actual raster dataset stored within each selected row. This is checked on by default. PATHS —The checker analyzes for broken paths. This is checked on by default. SOURCE_VALIDITY —The checker analyzes 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 —The checker analyzes each mosaic dataset item for staleness. 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 —The checker analyzes the raster pyramids associated with each mosaic dataset item in the selected mosaic dataset. The pyramids will be tested for disconnected auxiliary files. The auxiliary files may be disconnected when they are stored in the raster proxy location. STATISTICS —The checker analyzes the raster statistics and histogram associated with each mosaic dataset item in the selected mosaic dataset. The statistics will be tested for disconnected auxiliary files in case they are stored in the raster proxy location. This checker also analyzes the covariance matrix associated with the raster, when the Gram-Schmidt pan-sharpening method is enabled. Lastly, the checker will analyze the radiometric pixel depth of a mosaic dataset item against the pixel depth of the mosaic dataset. PERFORMANCE —The checker analyzes the entire mosaic dataset and each selected item for performance-related issues. Examples of performance-related issues include no compression during transmission or recommending item cache on items where there are a lot of raster functions involved.This checker remains unchecked by default. INFORMATION —The checker analyzes the mosaic dataset and its items, and generates an information log for the analysis.	String

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

Current Workspace, Parallel Processing Factor

Licensing Information

ArcGIS for Desktop Basic: No

ArcGIS for Desktop Standard: Yes

ArcGIS for Desktop Advanced: Yes