构建或重建概览图像。
~#~# 概要
```
gdaladdo [-r {nearest,average,gauss,cubic,cubicspline,lanczos,average_mp,
average_magphase,mode}]
[-b band]* [-minsize val]
[-ro] [-clean] [-oo NAME=VALUE]* [~-~-help-general] filename [levels]
```
~#~# 描述
gdaladdo实用程序可用于使用多种下采样算法之一构建或重建大多数支持的文件格式的概览图像。
~*~*-r {nearest (default),average,gauss,cubic,cubicspline,lanczos,average_mp,average_magphase,mode}:~*~*
选择重采样算法。
~*~*-b band:~*~*
（可从GDAL 1.10获得）选择用于概览生成的输入带段。 频带编号从1开始。多个-b开关可用于选择一组输入频带以生成概览。
~*~*-ro:~*~*
（可从GDAL 1.6.0获得）以只读模式打开数据集，以便生成外部概览（特别是GeoTIFF）。
~*~*-clean:~*~*
（可从GDAL 1.7.0获取）删除所有概述。
~*~*-oo NAME=VALUE:~*~*
（从GDAL 2.0开始）数据集打开选项（特定格式
~*~*-minsize val:~*~*
（从GDAL 2.3开始）最小的概览级别的最大宽度或高度。 仅在未指定显式级别时才考虑。 默认为256。
~*~*filename:~*~*
构建概述（或其概述必须删除）的文件。
~*~*levels:~*~*
要构建的整体概览级别列表。 忽略了“清除”选项。 从GDAL 2.3开始，级别不再需要构建概述。 在这种情况下，将选择适当的概述两个因素的因素，直到最小概览小于-minsize开关的值。
模式（可从GDAL 1.6.0获得）选择所有采样点最常出现的值。 average_mp不适合使用。 Average_magphase对磁/相空间中的复杂数据进行平均。 最近和平均值适用于正常图像数据。 最近应用最近邻（重采样）重采样器，而平均值计算所有非NODATA贡献像素的平均值。 立方重采样（可从GDAL 1.7.0获得）应用三次卷积核。 高斯重采样（可从GDAL 1.6.0获得）在计算概述之前应用高斯内核，这可以导致比例如具有高对比度或噪声模式的尖锐边缘的简单平均更好的结果。 建议的电平值应为2，4，8，...，以便选择3x3重采样高斯核。 CubicSpline重采样（可从GDAL 2.0获得）应用B样条曲线卷积核。 Lanczos重采样（可从GDAL 2.0获得）应用Lanczos窗口的sinc卷积核。
gdaladdo将正确遵守NODATA_VALUES元组（特殊数据集元数据），以便只有给定的RGB三元组（在RGB图像的情况下）将被视为nodata值，而不是每个频带独立的三元组的每个值。
选择像2这样的级别值会导致概要级别为要计算的基础层的分辨率（每个维度）的1/2。 如果文件具有所选级别的现有概览级别，则将重新计算和重写这些级别。
对于内部GeoTIFF概述（或GeoTIFF格式的外部概述），请注意，-clean不缩小文件。 稍后运行的具有概述级别的gdaladdo将导致扩展文件，而不是重新使用以前删除的概述的空间。 如果您只想对已经计算出概述的文件更改重采样方法，则不需要清除现有的概述。
一些格式驱动程序根本不支持概述。 许多格式的驱动程序将概要存储在一个辅助文件中，其扩展名为.ovr，实际上是TIFF格式。 默认情况下，GeoTIFF驱动程序会将内部的概述存储到操作的文件上（如果可写），除非指定了-ro标志。
大多数驱动程序还支持使用Erdas Imagine格式的备用概述格式。 要触发此操作，请使用USE_RRD = YES配置选项。 这将把概述放在一个相关的.aux文件中，以便与Imagine或ArcGIS以及GDAL应用程序直接使用。 （例如-config USE_RRD YES）
~#~# GeoTIFF格式的外部概述
可以使用COMPRESS_OVERVIEW配置选项压缩以TIFF格式创建的外部概述。 GeoTIFF驱动程序支持的所有压缩方法都可在此处使用。 （例如-config COMPRESS_OVERVIEW DEFLATE）。 可以使用-config PHOTOMETRIC_OVERVIEW {RGB，YCBCR，...}设置光度解释，并用-config INTERLEAVE_OVERVIEW {PIXEL | BAND}进行交织。
对于JPEG压缩外部概览，可以使用“~-~-config JPEG_QUALITY_OVERVIEW value”（GDAL 1.7.0或更高版本）设置JPEG质量。
对于LZW或DEFLATE压缩外部概览，可以使用“~-~-config PREDICTOR_OVERVIEW 1 | 2 | 3”（GDAL 1.8.0或更高版本）设置预测值。
为了生成最小的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，从GDAL 2.3.0开始（以前是IF_NEEDED）。 此选项的行为与GeoTIFF驱动程序文档中记录的BIGTIFF创建选项完全相同。
~* YES 强制使用BigTIFF。
~* NO 使用经典TIFF。
~* IF_NEEDED 如果明确需要（未压缩，概览大于4GB），则仅创建BigTIFF。
~* IF_SAFER 如果生成的文件可能超过4GB，将创建BigTIFF。
有关所有这些选项的进一步说明，请参阅GeoTIFF驱动程序的文档。
# 例子
创建概述，嵌入在提供的TIFF文件中，具有自动计算级别（GDAL 2.3或更高版本）
```
gdaladdo -r average abc.tif
```
创建概述，嵌入在提供的TIFF文件中：
```
gdaladdo -r average abc.tif 2 4 8 16
```
从ERDAS .IMG文件创建外部压缩的GeoTIFF概述文件：
```
gdaladdo -ro ~-~-config COMPRESS_OVERVIEW DEFLATE erdas.img 2 4 8 16
```
从3波段RGB数据集创建一个外部JPEG压缩GeoTIFF概述文件（如果数据集是可写的GeoTIFF，您还需要添加-ro选项来强制生成外部概览）：
```
gdaladdo ~-~-config COMPRESS_OVERVIEW JPEG ~-~-config PHOTOMETRIC_OVERVIEW YCBCR
~-~-config INTERLEAVE_OVERVIEW PIXEL rgb_dataset.ext 2 4 8 16
```
为指定的JPEG文件创建Erdas Imagine格式概述：
```
gdaladdo ~-~-config USE_RRD YES airphoto.jpg 3 9 27 81
```