GDAL-RASTER-COMPARE(1)               GDAL               GDAL-RASTER-COMPARE(1)

<?><?><?> (NAME)
       gdal-raster-compare - <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>

       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> 3.12.


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)

          Usage: gdal raster compare [OPTIONS] <REFERENCE> <INPUT>

          Compare two raster datasets.

          Positional arguments:
            --reference <REFERENCE>              Reference dataset [required]
            -i, --input <INPUT>                  Input raster dataset [required] [not available in pipelines]

          Common Options:
            -h, --help                           Display help message and exit
            --json-usage                         Display usage as JSON document and exit
            --config <KEY>=<VALUE>               Configuration option [may be repeated]
            -q, --quiet                          Quiet mode (no progress bar or warning message) [not available in pipelines]

          Options:
            --skip-all-optional                  Skip all optional comparisons
            --skip-binary                        Skip binary file comparison
            --skip-crs                           Skip CRS comparison
            --skip-geotransform                  Skip geotransform comparison
            --skip-overview                      Skip overview comparison
            --skip-metadata                      Skip metadata comparison
            --skip-rpc                           Skip RPC metadata comparison
            --skip-geolocation                   Skip Geolocation metadata comparison
            --skip-subdataset                    Skip subdataset comparison

          Advanced Options:
            --if, --input-format <INPUT-FORMAT>  Input formats [may be repeated] [not available in pipelines]
            --oo, --open-option <KEY>=<VALUE>    Open options [may be repeated] [not available in pipelines]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> gdal raster compare <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> GDAL <?><?> <?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.

       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> --reference<?>
       <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?>/<?><?><?><?>/<?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> --input<?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?>. <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> GDAL <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> 1 (<?><?><?><?><?> <?><?><?><?><?><?>)
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       --skip-binary <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> (raster pipeline) <?><?><?> <?><?> <?><?><?>
       <?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?>:

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       (PROGRAM-SPECIFIC OPTIONS)

       --input <input-dataset>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

       --reference <reference-dataset>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>.

       --skip-all-optional
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> --skip-XXXX <?><?><?>.

              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>:

              o <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?>
                <?><?><?><?><?> <?><?><?><?><?><?><?>
                <?><?><?><?><?><?><?><?><?><?><?>

              o <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
                <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?> <?><?><?><?><?>
                nodata

              o <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>

       --skip-binary
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              (<?><?><?><?><?><?>).

       --skip-crs
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              (CRS).

       --skip-geolocation
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> GEOLOCATION.

       --skip-geotransform
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> (geotransform).

       --skip-metadata
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> (<?><?><?><?><?><?><?>).

       --skip-overview
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> (overviews).

       --skip-rpc
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (RPC).

       --skip-subdataset
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (STANDARD OPTIONS)

       --if, --input-format <format>
              <?><?><?> <?><?><?><?>/<?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?>(<?><?><?>) <?><?><?><?><?>. <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.  <?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?>.  <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

              <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       --oo, --open-option <NAME>=<VALUE>
              <?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?> <?><?>
              <?><?><?><?>).

              <?><?><?><?> <?><?><?><?><?> <?><?><?>.

<?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> (RETURN STATUS CODE)
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> 0<?> <?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       (<?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>).

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?> <?>: <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?>

          $ gdal raster compare autotest/gcore/data/byte.tif autotest/gcore/data/uint16.tif
          Reference file has size 736 bytes, whereas input file has size 1136 bytes.
          Reference band 1 has data type Byte, but input band has data type UInt16

          $ echo $?
          2

   <?><?><?><?> <?>: <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?>

          $ gdal raster pipeline read test_in_foot.tif ! calc --calc "X * 0.3048" ! compare --reference=reference_in_meter.tif

<?><?><?><?><?><?><?> (AUTHOR)
       Even Rouault <even.rouault@spatialys.com>

<?><?> <?><?><?> (COPYRIGHT)
       1998-2026

                                August 18, 2026         GDAL-RASTER-COMPARE(1)