Raster Compare

Summary

Analyze the properties of two raster or mosaic datasets.

Usage

• The tool returns messages showing the comparison result.

• The parameter and attribute tolerances allow your comparisons to have a specified amount of deviation.

Syntax

RasterCompare_management (in_base_raster, in_test_raster, {compare_type}, {ignore_option}, {continue_compare}, {out_compare_file}, {parameter_tolerances}, {attribute_tolerances}, {omit_field})

Parameter	Explanation	Data Type
in_base_raster	The first raster or mosaic dataset to compare.	Raster Layer; Mosaic Layer
in_test_raster	The second raster or mosaic dataset to compare with the first.	Raster Layer; Mosaic Layer
compare_type (Optional)	The type of raster to be compared. RASTER_DATASET —Compare two raster datasets. GDB_RASTER_DATASET —Compare two raster datasets in a geodatabase. GDB_RASTER_CATALOG —Compare two raster catalogs in a geodatabase. MOSAIC_DATASET —Compare two mosaic datasets.	String
ignore_option [ignore_option,...] (Optional)	The properties you do not want to include in the comparison. To determine the full list of properties, open the tool dialog box and view the list of values for the Ignore Options parameter. The Compare Type will determine which Ignore Options are valid. BandCount —Ignore the number of bands. Extent —Ignore the extent. Columns And Rows —Ignore the number of columns and rows. Pixel Type —Ignore the pixel type. NoData —Ignore the NoData value. Spatial Reference —Ignore the spatial reference system. Pixel Value —Ignore the pixel values. Colormap —Ignore if a color map exists. Raster Attribute Table —Ignore if an attribute table exists. Statistics —Ignore the statistics. Metadata —Ignore any metadata. Pyramids Exist —Ignore if pyramids exist. Compression Type —Ignore the compression type.	String
continue_compare (Optional)	When a mismatch is encountered, stop the comparison. NO_CONTINUE_COMPARE —Stop comparing upon the discovery of a mismatch. This is the default. CONTINUE_COMPARE —Continue comparing the raster datasets if a mismatch is found.	Boolean
out_compare_file (Optional)	Create a text file containing the comparison results.	File
parameter_tolerances [[Parameter, Tolerance, Type],...] (Optional)	Incorporate some leeway into the accuracy when comparing parameters. You can have different tolerances for each parameter, if necessary. Set the tolerance type to either be the value you enter or use that value as a fraction. For example, if the base value is 100 and you set the fraction tolerance to 0.00001, the compare tolerance will be 100 * 0.00001 = 0.001. There are seven types of parameter tolerances you can adjust. All —Compare the extents, pixel values, minimums, maximums, means, and standard deviations to see if they are equal within the specified tolerance. Extent —If the difference of the extents is within the tolerance, consider them equal. Pixel_Value —If the difference of the pixel values is within the tolerance, consider them equal. Statistics_Minimum —If the difference of the minimums is within the tolerance, consider them equal. Statistics_Maximum —If the difference of the maximums is within the tolerance, consider them equal. Statistics_Mean —If the difference of the means is within the tolerance, consider them equal. Statistics_Standard_Deviation —If the difference of the standard deviations is within the tolerance, consider them equal.	Value Table
attribute_tolerances [[Field, Tolerance],...] (Optional)	The fields you want to compare to see if they are within a tolerance. The tolerance value is a value in the units of the attribute.	Value Table
omit_field [omit_field,...] (Optional)	The field or fields that will be omitted during comparison.	String

Code sample

RasterCompare example 1 (Python window)

This is a Python sample for RasterCompare tool.

import arcpy
RasterCompare_management("C:/workspace/image1.tif","C:/workspace/image2.tif",\
                         "RASTER_DATASET","'Pyramids Exist'",\
                         "CONTINUE_COMPARE","C:/workspace/compare01.txt",\
                         "Pixel_Value 1 Value","Count 5","OID")

RasterCompare example 2 (stand-alone script)

This is a Python sample for the RasterCompare tool.

##====================================
##Raster Compare
##Usage: RasterCompare_management in_base_raster in_test_raster {RASTER_DATASET |
##                                GDB_RASTER_DATASET | GDB_RASTER_CATALOG |
##                                MOSAIC_DATASET} {ignore_option;ignore_option...}
##                                {NO_CONTINUE_COMPARE | CONTINUE_COMPARE} 
##                                {out_compare_file} {Parameter {Tolerance} {Type};
##                                Parameter {Tolerance} {Type}...} {Field {Tolerance};
##                                Field {Tolerance}...} {omit_field;omit_field...} 
    
    
try:
    import arcpy
    
    arcpy.env.workspace = "c:/workspace"
    
    ##Compare two Raster dataset
    arcpy.RasterCompare_management("raster_base.tif","raster_test.tif","RASTER_DATASET",\
                                   "","CONTINUE_COMPARE","compareresult.txt","","","")
    
    ##Compare two Raster Catalog with ignore options
    arcpy.RasterCompare_management("fgdb.gdb/rc_base","fgdb.gdb/rc_test","RASTER_CATALOG",\
                                   "IsManaged;Extent","CONTINUE_COMPARE","compareresult2.txt",\
                                   "","","DATE")
    
    ##Compare two Mosaic Dataset with torelance
    arcpy.RasterCompare_management("fgdb.gdb/md_base","fgdb.gdb/md_test","MOSAIC_DATASET",\
                                   "IsEmbedded;Seamline","CONTINUE_COMPARE","compareresult3.txt",\
                                   "All 0.00001 Fraction","HighPS 0.0001;LowPS 0.0001",\
                                   "ItemTS;UriHash")
    
except:
    print "Raster Compare exsample failed."
    print arcpy.GetMessages()

Environments

• Current Workspace
• Scratch Workspace

Licensing information

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