NAME

       gdalcompare -  Compare two images.

SYNOPSIS

          gdalcompare.py [-sds] golden_file new_file

DESCRIPTION

       The   gdalcompare.py   script  compares  two  GDAL  supported  datasets  and  reports  the
       differences. In addition to reporting differences to the standard output the  script  will
       also return the difference count in its exit value.

       Image  pixels,  and  various metadata are checked. There is also a byte by byte comparison
       done which will count as one difference. So if it is only important that the GDAL  visible
       data  is  identical  a  difference count of 1 (the binary difference) should be considered
       acceptable.

       -sds   If this flag is passed the script will compare all subdatasets that are part of the
              dataset, otherwise subdatasets are ignored.

       <golden_file>
              The file that is considered correct, referred to as the golden file.

       <new_file>
              The file being compared to the golden file, referred to as the new file.

       Note  that  the gdalcompare.py script (like all the other scripts) can also be called as a
       library from python code: from osgeo_utils import gdalcompare.  The primary entry point is
       gdalcompare.compare()  which  takes  a  golden  gdal.Dataset  and  a  new  gdal.Dataset as
       arguments  and  returns  a  difference  count  (excluding  the  binary  comparison).   The
       gdalcompare.compare_sds() entry point can be used to compare subdatasets.

AUTHOR

       Frank Warmerdam <warmerdam@pobox.com>

COPYRIGHT

       1998-2022

                                           Jun 30, 2022                            GDALCOMPARE(1)