GDAL-RASTER-OVERVIEW-REFRESH(1)      GDAL      GDAL-RASTER-OVERVIEW-REFRESH(1)

<?><?><?> (NAME)
       gdal-raster-overview-refresh - <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?>

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


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

          Usage: gdal raster overview refresh [OPTIONS] <INPUT>

          Refresh overviews.

          Positional arguments:
            -i, --dataset, --input <INPUT>     Dataset (to be updated in-place, unless --external) [required]

          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:
            --external                         Refresh external overviews
            -r, --resampling <RESAMPLING>      Resampling method. RESAMPLING=nearest|average|cubic|cubicspline|lanczos|bilinear|gauss|average_magphase|rms|mode
            --levels <LEVELS>                  Levels / decimation factors [may be repeated]
            --bbox <BBOX>                      Bounding box to refresh
                                               Mutually exclusive with --like, --use-source-timestamp
            --like <LIKE>                      Use extent of dataset(s) [may be repeated]
                                               Mutually exclusive with --bbox, --use-source-timestamp
            --use-source-timestamp             Use timestamp of VRT or GTI sources as refresh criterion
                                               Mutually exclusive with --bbox, --like

          Advanced Options:
            --oo, --open-option <KEY>=<VALUE>  Open options [may be repeated]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> gdal raster overview refresh <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> (dataset) <?><?> <?><?><?> <?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       (level) <?>/<?><?> <?><?><?><?><?><?> (extent) <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?>.

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

       --bbox <xmin>,<ymin>,<xmax>,ymax>
              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> CRS <?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?><?><?> 'x' <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> CRS <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?>
              <?><?><?><?> (easting) <?><?><?><?> CRS <?><?><?><?><?><?><?><?>
              <?><?><?>.  <?><?><?><?><?> 'y' <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> CRS <?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?>
              <?><?><?><?><?> (northing) <?><?><?><?> CRS
              <?><?><?><?><?><?><?><?> <?><?><?>.

       --dataset <DATASET>
              <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              (<?><?><?> <?><?><?><?><?> --external <?><?><?><?> <?><?><?>
              <?><?><?><?>). <?><?><?><?><?><?> <?><?><?>.

       --external
              <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> .ovr.

       --levels <level1,level2,...>
              <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?>
              <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?> <?><?><?><?>.

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

       --like <filename1>[,<filenameN>]...
              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?>
              <?><?><?> <?><?><?><?> (<?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>)
              <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.
              <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>. <?><?>
              <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?>.

       -r, --resampling
       {nearest|average|cubic|cubicspline|lanczos|bilinear|gauss|average_magphase|rms|mode}
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> (resampling).
              <?><?><?><?><?> <?><?><?><?><?><?><?> nearest <?><?><?> <?><?>
              <?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?>.

              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> TIFF <?><?><?><?><?><?>
              <?><?><?><?><?><?> -r <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?> <?><?><?> (<?><?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> RESAMPLING
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>) <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?>.

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

              <?><?><?> nearest <?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              (<?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?>) <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?> average <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?> NODATA <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

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

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

              <?><?><?> cubicspline <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> B-Spline <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?> lanczos <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> sinc <?><?><?><?><?> <?><?> Lanczos
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?> gauss <?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?> <?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?> <?>...
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?>x<?> <?><?><?><?><?><?> <?><?><?>.

              <?><?><?> average_magphase <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?>/<?><?><?> (mag/phase)
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?><?> rms <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> / <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?> NODATA <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?>.

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

       --use-source-timestamp
              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?> VRT -- GDAL Virtual Format
              <?><?> GTI -- GDAL Raster Tile Index <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> (timestamp) <?><?><?><?>
              <?><?><?><?><?> VRT <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> VRT <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?>.  <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>. <?><?>
              <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?>.

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

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

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

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> 0 <?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?>).

<?><?><?><?><?><?><?> (EXAMPLES)
   <?><?><?><?> <?>: <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> VRT <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       vrt.ovr. <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>:

          gdal raster mosaic tile1.tif tile2.tif my.vrt               # create VRT
          gdal raster overview add --external -r cubic my.vrt         # initial overview generation
          touch tile1.tif                                             # simulate update of one of the source tiles
          gdal raster overview refresh --external -r cubic \
                                    --use-source-timestamp my.vrt     # refresh overviews

   <?><?><?><?> <?>: <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> (<?><?><?><?><?>) <?><?>
       <?><?><?><?> TIFF

          gdal raster mosaic tile1.tif tile2.tif mosaic.tif       # create mosaic
          gdal raster overview add -r cubic mosaic.tif            # initial overview generation
          gdalwarp tile1_modif.tif mosaic.tif                     # update mosaic
          gdal raster overview refresh --like=tile1.tif my.tif    # refresh overviews

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

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

                                August 18, 2026
                                               GDAL-RASTER-OVERVIEW-REFRESH(1)