cubediff
Compare two cubes for differences
This program compares two cube files pixel by pixel, with results written to the log and/or user specified output file.
Output:
Label | Description |
---|---|
Compare | The files are different if any pair of pixels is different, otherwise the files are identical. |
Sample | The sample of the first pair of pixels that is different |
Line | The line of the first pair of pixels that is different |
Band | The band of the first pair of pixels that is different |
AverageDifference | The average absolute value of the differences of all pairs of pixels |
StandardDeviation | The standard deviation of the absolute value of the differences of all pairs of pixels |
Variance | The variance of the absolute value of the differences of all pairs of pixels |
MinimumDifference | The smallest absolute value of the differences of all pairs of pixels |
MaximumDifference | The largest absolute value of the differences of all pairs of pixels |
MaxDifferenceSample | The sample of the pair of pixels with the largest difference |
MaxDifferenceLine | The line of the pair of pixels with the largest difference |
MaxDifferenceBand | The band of the pair of pixels with the largest difference |
ValidPixelDifferences | The number of pairs of nonspecial pixels that are different |
SpecialPixelDifferences | The number of pairs of pixels that are different where at least one pixel is special |
SigFigAccuracy | The minimum value of the approximate number of significant figures of the differences of all pairs of pixels. The approximation is given by floor(log10(in1)) - floor(log10(abs(in1 - in2)) where in1 and in2 are the pair of pixels. |
SigFigMaxDifferenceSample | The sample of the first pair of pixels where SigFigAccuracy in minimized |
SigFigMaxDifferenceLine | The line of the first pair of pixels where SigFigAccuracy in minimized |
SigFigMaxDifferenceBand | The band of the first pair of pixels where SigFigAccuracy in minimized |
Categories
History
Tracie Sucharski | 2002-10-10 | Original version |
Tracie Sucharski | 2002-11-12 | Add user parameter, IGNORESPECIAL, which indicates whether special pixel values in either file are ignored in the comparison. |
K Teal Thompson | 2002-11-25 | Add example. |
K Teal Thompson | 2003-04-11 | Make images smaller |
Stuart Sides | 2003-04-29 | Added the band number to the logged information |
Stuart Sides | 2003-05-01 | Fixed multipal run bug where once the inputs were reported as different any files entered after that would aldo be reported as different. |
Stuart Sides | 2003-05-16 | Modified schema location from astogeology... to isis.astrogeology... |
Stuart Sides | 2003-07-29 | Modified filename parameters to be cube parameters where necessary |
Jeff Anderson | 2003-08-26 | Changed default extension handling mechanism |
Stuart Sides | 2003-11-07 | Modified results pvl to not include the results group |
Jacob Danton | 2006-04-07 | Changed the IGNORESPECIAL from a string to a bool. |
Elizabeth Miller | 2006-05-19 | Modified to output statistical data about the differences |
Elizabeth Miller | 2006-06-15 | Added ValidPixelDifferences to output |
Brendan George | 2006-09-28 | Documentation fixes |
Tracie Sucharski | 2007-02-26 | Documentation correction-Description said program exited at first difference. This is no longer the case, all pixels are compared and statistics are collected. |
Brendan George | 2007-04-25 | Added tabular output option. Option allows the program to collect and print out a table of the differences found |
Brendan George | 2007-04-26 | Changed name from compare to cubediff |
Steven Lambright | 2007-06-08 | Fixed problems with the special pixel comparisons: changed IGNORESPECIAL to only ignore the case where one pixel has a DN value and the other pixel is special, fixed a problem where the special pixel difference would never be the first difference, fixed a comparison of DN value differences before checking if the pixel is special. Added significant figure reports for testing purposes. |
Steven Lambright | 2007-06-11 | Removed IGNORESPECIAL |
Steven Lambright | 2007-06-12 | Updated example images |
Steven Lambright | 2007-06-18 | Fixed bug where sig. fig. accuracy would report "1" when it should report "0" |
Brendan George | 2007-08-09 | Integrated WriteTabular and Column (tabular output objects) as application-specific classes |
Steven Koechle | 2009-05-14 | Changed output, if no valid pixel differences, output zero instead of NULL8 |
Sharmila Prasad | 2010-02-26 | Incuded keywords MaxDifference Line, Sample and Band in the output to indicate the line, sample, band where the max cube difference occured |
Jeffrey Covington | 2015-01-09 | Added descriptions for each label of the output |
Jeffrey Covington | 2015-01-13 | Fixed output when run multiple times in the GUI |
Parameters
Files
Type | cube |
---|---|
File Mode | input |
Filter | *.cub |
Type | cube |
---|---|
File Mode | input |
Filter | *.cub |
Type | filename |
---|---|
File Mode | output |
Internal Default | None |
Options
Type | double |
---|---|
Internal Default | DBL_EPSILON |
Table Parameters
Type | boolean |
---|---|
Default | false |
Inclusions |
|
Type | integer |
---|---|
Default | 3 |
Inclusions |
|
Type | integer |
---|---|
Default | 100 |
Inclusions |
|
Example 1
Different
Command Line
cubediff cubediff from=isisTruth.cub+1 from2=isisTruth.cub+2
GUI Screenshot
Example GUI
compare GUIScreenshot of GUI with parameters filled in to perform the compare operation
Input Images
First input image for compare
Input image
Parameter Name:
FROM
This is the first input image for the compare example.
Second input image for compare
Input image
Parameter Name:
FROM2
This is the second input image for the compare example.