gdaladdo

生成或重建概述图像。

简介

gdaladdo [-r {nearest,average,rms,bilinear,gauss,cubic,cubicspline,lanczos,average_magphase,mode}]
        [-b band]* [-minsize val]
        [-ro] [-clean] [-oo NAME=VALUE]* [--help-general] filename [levels]

描述

这个 gdaladdo 该实用程序可用于为大多数受支持的文件格式生成或重建概览图像，方法是使用几个下采样算法之一。

-r {nearest (default),average,rms,gauss,cubic,cubicspline,lanczos,average_magphase,mode}

选择重采样算法。

nearest 应用近邻（简单采样）重采样器

average 计算所有非NODATA贡献像素的平均值。从gdal3.1开始，这是一个加权平均值，适当地考虑了源像素的权重对目标像素的影响。

rms 计算所有非NODATA贡献像素的均方根/二次平均值（GDAL>=3.3）

bilinear 应用双线性卷积核。

gauss 在计算总览之前应用高斯核，这可能会比简单的平均得到更好的结果，例如在具有高对比度或噪声图案的锐边的情况下。建议的水平值应该是2，4，8。。。从而选择3x3重采样高斯核。

cubic 应用三次卷积核。

cubicspline 应用B样条卷积核。

lanczos 应用Lanczos窗口sinc卷积核。

average_magphase 平均mag/相空间中的复杂数据。

mode 选择在所有采样点中最常出现的值。

-b <band>

选择输入波段 band 用于生成概述。波段编号从1开始。多重 -b 开关可用于选择一组输入频带以生成概述。

-ro

以只读模式打开数据集，以便生成外部概述（特别是GeoTIFF）。

-clean

删除所有概述。

-oo NAME=VALUE

数据集打开选项（特定于格式）

-minsize <val>

最小总览级别的最大宽度或高度。仅在未指定显式级别时考虑。默认为256。

2.3 新版功能.

<filename>

要为其生成概述的文件（或必须删除其概述的文件）。

<levels>

要构建的整体概述级别的列表。忽略 -clean 选择权。

2.3 新版功能: 不再需要级别来构建概述。在这种情况下，将选择两个因素的适当概览功率，直到最小概览小于-minsize开关的值。

gdaladdo将适当地遵守NODATA_VALUES元组（特殊数据集元数据），以便仅将给定的RGB三元组（在RGB图像的情况下）视为NODATA值，而不是每个频带独立地考虑三元组的每个值。

选择级别值，如 2 导致计算的概述级别为基础层分辨率（在每个维度中）的1/2。如果文件在选定的级别上具有现有的概述级别，则这些级别将重新计算并重写到位。

对于内部GeoTIFF概述（或GeoTIFF格式的外部概述），请注意-clean不会收缩文件。稍后运行具有概述级别的gdaladdo将导致文件被扩展，而不是重用先前删除的概述的空间。如果只想更改已计算过概述的文件的重采样方法，则不需要清除现有概述。

一些格式驱动程序根本不支持概述。许多格式驱动程序将概述存储在扩展名为.ovr的辅助文件中，该文件实际上是TIFF格式的。默认情况下，GeoTIFF驱动程序将概述存储在操作文件的内部（如果它是可写的），除非指定了-ro标志。

大多数驱动程序还支持使用Erdas Imagine格式的备用概述格式。使用 USE_RRD =是配置选项。这将把概述放在一个相关的.aux文件中，适合与Imagine或ArcGIS以及GDAL应用程序直接使用。（例如——配置-使用-是）

GeoTIFF格式的外部概述

以TIFF格式创建的外部概述可以使用 COMPRESS_OVERVIEW 配置选项。这里提供了GeoTIFF驱动程序支持的所有压缩方法。（例如。 --config COMPRESS_OVERVIEW DEFLATE ). 可以使用 PHOTOMETRIC_OVERVIEW =RGB/YCBCR/。。。配置选项，以及与 INTERLEAVE_OVERVIEW =像素/波段配置选项。

For JPEG compressed external and internal overviews, the JPEG quality can be set with --config JPEG_QUALITY_OVERVIEW value.

对于WEBP压缩的外部和内部概述，可以使用 --config WEBP_LEVEL_OVERVIEW value . 如果未设置，将默认为75。

For LERC compressed external and internal overviews, the max error threshold can be set with --config MAX_Z_ERROR_OVERVIEW value. If not set, will default to 0 (lossless). Added in GDAL 3.4.1

For DEFLATE or LERC_DEFLATE compressed external and internal overviews, the compression level can be set with --config ZLEVEL_OVERVIEW value. If not set, will default to 6. Added in GDAL 3.4.1

For ZSTD or LERC_ZSTD compressed external and internal overviews, the compression level can be set with --config ZSTD_LEVEL_OVERVIEW value. If not set, will default to 9. Added in GDAL 3.4.1

For LZW, ZSTD or DEFLATE compressed external overviews, the predictor value can be set with --config PREDICTOR_OVERVIEW 1|2|3.

要在TIFF概述中生成尽可能小的JPEG，应使用：

--config COMPRESS_OVERVIEW JPEG --config PHOTOMETRIC_OVERVIEW YCBCR --config INTERLEAVE_OVERVIEW PIXEL

可以使用BigTIFF格式创建外部概述 BIGTIFF_OVERVIEW 配置选项： --config BIGTIFF_OVERVIEW {{IF_NEEDED|IF_SAFER|YES|NO}} .

默认值是IFu safe，从gdal2.3.0开始（以前是IFu NEEDED）。此选项的行为与GeoTIFF驱动程序文档中记录的BIGTIFF创建选项完全相同。

• 是的，迫使大人物。

• 不强迫经典的TIFF。

• 如果需要，只会在明显需要时（未压缩，且概述大于4GB）创建一个大的tiff。

• 如果安全将创建BigTIFF如果结果文件 可以 超过4GB。

Sparse GeoTIFF overview files (that is tiles which are omitted if all their pixels are at the nodata value, when there's one, or at 0 otherwise) can be obtained with --config SPARSE_OK_OVERVIEW ON. Added in GDAL 3.4.1

参见 GTiff—GeoTIFF文件格式 司机进一步解释所有这些选项。

在Geotiff概述中设置块大小

--config GDAL_TIFF_OVR_BLOCKSIZE <size>

例子： --config GDAL_TIFF_OVR_BLOCKSIZE 256

Default value is 128, or starting with GDAL 3.1, if creating overviews on a tiled GeoTIFF file, the tile size of the full resolution image. Note: without this setting, the file can have the full resolution image with a blocksize different from overviews blocksize.(e.g. full resolution image at blocksize 256, overviews at blocksize 128)

多线程

3.2 新版功能.

这个 GDAL_NUM_THREADS 配置选项可以设置为 ALL_CPUS 或一个整数值，以指定用于概览计算的线程数。

计算机辅助编程接口

这个实用程序的功能可以通过 GDALBuildOverviews() .

实例

创建概述，嵌入到提供的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

为特定子数据集创建概述，例如GeoPackage中可能有许多栅格图层之一（“filename”参数必须是驱动程序前缀、文件名和子数据集名称，例如由gdalinfo显示）：

gdaladdo GPKG:file.gpkg:layer