dwww Home | Manual pages | Find package

GDALCOMPARE(1)                       GDAL                       GDALCOMPARE(1)

NAME
       gdalcompare -  Compare two images.

SYNOPSIS
          gdalcompare.py [-sds] golden_file new_file

DESCRIPTION
       The  gdalcompare.py script compares two GDAL supported datasets and re-
       ports 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 re-
       turns a difference count (excluding the binary comparison).  The  gdal-
       compare.compare_sds() entry point can be used to compare subdatasets.

AUTHOR
       Frank Warmerdam <warmerdam@pobox.com>

COPYRIGHT
       1998-2021

                                 Dec 27, 2021                   GDALCOMPARE(1)

Generated by dwww version 1.14 on Fri Jan 24 06:24:31 CET 2025.