GDALADDO(1) GDAL GDALADDO(1) (NAME) gdaladdo - (overview). (SYNOPSIS) Usage: gdaladdo [--help] [--long-usage] [--help-general] [-r nearest|average|rms|gauss|bilinear|cubic|cubicspline|lanczos|average_magphase|mode] [-ro] [--quiet] [-b ]... [-oo ]... [-minsize ] [[-clean]|[--partial-refresh-from-source-timestamp]| [--partial-refresh-from-projwin ]| [--partial-refresh-from-source-extent [,]...]] filename []... (DESCRIPTION) gdaladdo (overview) (downsampling) . : "gdal": gdal raster overview add gdal raster overview delete gdal raster overview refresh. --help . --help-general GDAL . -q, --quiet . -r {nearest|average|rms|gauss|bilinear|cubic|cubicspline|lanczos|average_magphase|mode} (resampling). nearest (sub-pixel) . GDAL 3.9 TIFF -r ( RESAMPLING ) . : nearest ( ) . average NODATA . GDAL 3.1 . rms / NODATA (GDAL >= 3.3). gauss (Gaussian kernel) . ... x . bilinear (bilinear convolution) . cubic (cubic convolution) . cubicspline B-Spline . lanczos (Lanczos windowed sinc) . average_magphase / (mag/phase) . mode . -b band . . -b . -ro ( GeoTIFF). -clean . -oo = ( ). -minsize . . . --partial-refresh-from-source-timestamp 3.8. VRT . (timestamp) VRT VRT . . . --partial-refresh-from-projwin 3.8. X - Y - X - Y - . . --partial-refresh-from-source-extent [,]... 3.8. ( ) . . . . . ( ). . -clean . . -minsize . GDAL 3.9 . gdaladdo NODATA_VALUES ( ) RGB ( RGB) nodata . 2 () ( ) . . GeoTIFF ( GeoTIFF) -clean . gdaladdo . . . .ovr TIFF . GeoTIFF ( ) -ro . Erdas Imagine . USE_RRD=YES ( ). .aux Imagine ArcGIS GDAL ( --config USE_RRD YES). GEOTIFF (EXTERNAL OVERVIEWS IN GEOTIFF FORMAT) TIFF COMPRESS_OVERVIEW . GeoTIFF ( --config COMPRESS_OVERVIEW DEFLATE). (photometric interpretation) PHOTOMETRIC_OVERVIEW=RGB/YCBCR/... (interleaving) INTERLEAVE_OVERVIEW=PIXEL/BAND . GDAL 3.6 COMPRESS_OVERVIEW INTERLEAVE_OVERVIEW TIFF . JPEG ( ) JPEG --config JPEG_QUALITY_OVERVIEW value . WEBP ( ) WEBP --config WEBP_LEVEL_OVERVIEW value . . WEBP ( ) / (lossless/lossy) --config WEBP_LOSSLESS_OVERVIEW value . NO () . GDAL 3.6.0. LERC ( ) --config MAX_Z_ERROR_OVERVIEW value . () . GDAL 3.4.1. DEFLATE LERC_DEFLATE ( ) --config ZLEVEL_OVERVIEW value . . GDAL 3.4.1. ZSTD LERC_ZSTD ( ) --config ZSTD_LEVEL_OVERVIEW value . . GDAL 3.4.1. JPEG-XL ( ) GDAL 3.9.0 : o --config JXL_LOSSLESS_OVERVIEW YES|NO. YES . o --config JXL_EFFORT_OVERVIEW value () (/). . o --config JXL_DISTANCE_OVERVIEW value : 0= 1.0= [0.5,3]. 1.0 . JXL_LOSSLESS_OVERVIEW YES . o --config JXL_ALPHA_DISTANCE_OVERVIEW value : 0= 1.0= [0.5,3]. JXL_DISTANCE_OVERVIEW . JXL_LOSSLESS_OVERVIEW YES . LZW ZSTD DEFLATE (predictor) --config PREDICTOR_OVERVIEW 1|2|3 . JPEG-In-TIFF : --config COMPRESS_OVERVIEW JPEG --config PHOTOMETRIC_OVERVIEW YCBCR --config INTERLEAVE_OVERVIEW PIXEL BIGTIFF_OVERVIEW BigTIFF : --config BIGTIFF_OVERVIEW {IF_NEEDED|IF_SAFER|YES|NO}. IF_SAFER . BIGTIFF GeoTIFF . o YES BigTIFF . o NO TIFF . o IF_NEEDED BigTIFF ( ). o IF_SAFER BigTIFF . (sparse) GeoTIFF ( nodata ) --config SPARSE_OK_OVERVIEW ON . GDAL 3.4.1. GTiff -- GeoTIFF . GEOTIFF (SETTING BLOCKSIZE IN GEOTIFF OVERVIEWS) --config GDAL_TIFF_OVR_BLOCKSIZE : --config GDAL_TIFF_OVR_BLOCKSIZE 256 GDAL 3.1 GeoTIFF . : ( ). / NODATA (NODATA / SOURCE VALIDITY MASK HANDLING DURING RESAMPLING) nodata . : o nearest ( ) . . o bilinear cubic cubicspline lanczos . cubic lanczos : / (overshoot/undershoot) . nodata . o . . nodata . (MULTITHREADING) 3.2. GDAL_NUM_THREADS ALL_CPUS . (RETURN STATUS CODE) ( ). (C API) C GDALBuildOverviews() . (EXAMPLES) : TIFF gdaladdo -r average abc.tif : TIFF gdaladdo -r average abc.tif 2 4 8 16 : GeoTIFF .IMG ERDAS gdaladdo -ro --config COMPRESS_OVERVIEW=YES erdas.img 2 4 8 16 : GeoTIFF JPEG RGB GeoTIFF -ro . gdaladdo --config COMPRESS_OVERVIEW=JPEG --config PHOTOMETRIC_OVERVIEW=YCBCR --config INTERLEAVE_OVERVIEW=PIXEL rgb_dataset.ext 2 4 8 16 : Erdas Imagine JPEG gdaladdo --config USE_RRD=YES airphoto.jpg 3 9 27 81 : GeoPackage ( "filename" gdalinfo ): gdaladdo GPKG:file.gpkg:layer : VRT .vrt.ovr : gdalbuildvrt my.vrt tile1.tif tile2.tif # create VRT gdaladdo -r cubic my.vrt # initial overview generation touch tile1.tif # simulate update of one of the source tiles gdaladdo --partial-refresh-from-source-timestamp -r cubic my.vrt # refresh overviews : TIFF gdalwarp -overwrite tile1.tif tile2.tif mosaic.tif # create mosaic gdaladdo -r cubic mosaic.tif # initial overview generation touch tile1.tif # simulate update of one of the source tiles gdalwarp tile1.tif mosaic.tif # update mosaic gdaladdo --partial-refresh-from-source-extent tile1.tif -r cubic mosaic.tif # refresh overviews (AUTHORS) Frank Warmerdam , Silke Reimer (COPYRIGHT) 1998-2026 August 18, 2026 GDALADDO(1)