--dataset <DATASET>

Dataset name, to be updated in-place by default (unless --external is specified). Required for standalone execution, implicit when run as a pipeline step

--external

Create external .ovr overviews as GeoTIFF files. Not available when run as a pipeline step.

--overview-src <INPUT>

Added in version 3.12.

Add specified input raster datasets as overviews of the target dataset. Source overviews may come from any GDAL supported format, provided they have the same number of bands and geospatial extent than the target dataset.

That mode is currently only implemented when the target dataset is in GeoTIFF format, or when using --external.

Mutually exclusive with --levels

--resampling {nearest|average|cubic|cubicspline|lanczos|bilinear|gauss|average_magphase|rms|mode}

Select a resampling algorithm. The default is nearest, which is generally not appropriate if sub-pixel accuracy is desired.

When refreshing existing TIFF overviews, the previously used method, as noted in the RESAMPLING metadata item of the overview, will be used if -r is not specified.

The available methods are:

nearest applies a nearest neighbour (simple sampling) resampler.

average computes the average of all non-NODATA contributing pixels. This is a weighted average taking into account properly the weight of source pixels not contributing fully to the target pixel.

bilinear applies a bilinear convolution kernel.

cubic applies a cubic convolution kernel.

cubicspline applies a B-Spline convolution kernel.

lanczos applies a Lanczos windowed sinc convolution kernel.

gauss applies a Gaussian kernel before computing the overview, which can lead to better results than simple averaging in e.g case of sharp edges with high contrast or noisy patterns. The advised level values should be 2, 4, 8, ... so that a 3x3 resampling Gaussian kernel is selected.

average_magphase averages complex data in mag/phase space.

rms computes the root mean squared / quadratic mean of all non-NODATA contributing pixels

mode selects the value which appears most often of all the sampled points.

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

A list of overview levels to build. Each overview level must be an integer value greater or equal to 2.

When explicit levels are not specified,

Mutually exclusive with --overview-src

--min-size <val>

Maximum width or height of the smallest overview level. Only taken into account if explicit levels are not specified. Defaults to 256.

--co <NAME>=<VALUE>

Added in version 3.12.

Overview creation options. May be repeated.

Many formats have one or more optional creation options that can be used to control particulars about the created overviews. Options available can be obtained by looking at the OverviewCreationOptionList returned by gdal --format <FORMAT-NAME>.

Most formats will support external overviews in a GeoTIFF file in a side-car file of extension .ovr. You can consult the overview creation options for GeoTIFF.