1gdalcompare(1) General Commands Manual gdalcompare(1)
2
3
4
6 gdalcompareCompare two images.
7
9 gdalcompare.py [-sds] golden_file new_file
10
12 The gdalcompare.py script compares two GDAL supported datasets and
13 reports the differences. In addition to reporting differences to the
14 standard out the script will also return the difference count in it's
15 exit value.
16
17 Image pixels, and various metadata are checked. There is also a byte by
18 byte comparison done which will count as one difference. So if it is
19 only important that the GDAL visible data is identical a difference
20 count of 1 (the binary difference) should be considered acceptable.
21
22 -sds:
23 If this flag is passed the script will compare all subdatasets that
24 are part of the dataset, otherwise subdatasets are ignored.
25
26 golden_file:
27 The file that is considered correct, referred to as the golden
28 file.
29
30 new_file:
31 The file being compared to the golden file, referred to as the new
32 file.
33
34 Note that the gdalcompare.py script can also be called as a library
35 from python code though it is not typically in the python path for
36 including. The primary entry point is gdalcompare.compare() which takes
37 a golden gdal.Dataset and a new gdal.Dataset as arguments and returns a
38 difference count (excluding the binary comparison). The
39 gdalcompare.compare_sds() entry point can be used to compare
40 subdatasets.
41
43 Frank Warmerdam warmerdam@pobox.com
44
45
46
47GDAL Tue Mar 3 2020 gdalcompare(1)