​gdal_retile.py 重切片工具官方文档

gdal_retile.py

重新平铺一组瓷砖和/或构建平铺的金字塔级别。

概要Á

gdal_retile.py [-v] [-co NAME=VALUE]* [-of out_format] [-ps pixelWidth pixelHeight]

               [-overlap val_in_pixel]

               [-ot  {Byte/Int8/Int16/UInt16/UInt32/Int32/Float32/Float64/

                       CInt16/CInt32/CFloat32/CFloat64}]'

               [ -tileIndex tileIndexName [-tileIndexField tileIndexFieldName]]

               [ -csv fileName [-csvDelim delimiter]]

               [-s_srs srs_def]  [-pyramidOnly]

               [-r {near/bilinear/cubic/cubicspline/lanczos}]

               -levels numberoflevels

               [-useDirForEachRow] [-resume]

               -targetDir TileDirectory input_files

描述

该实用程序将重新平铺一组输入图块。所有输入图块都必须在同一坐标系中进行地理配准，并且具有匹配数量的波段。

可选地生成金字塔级别。所有金字塔级别都是从输入瓦片生成的（而不是从以前的级别）。

可以为平铺输出生成形状文件。

如果您的输入图块数量耗尽了命令行缓冲区，请使用通用的 –optfile选项

-targetDir <目录> 

创建切片结果的目录。金字塔存储在从 1 开始编号的子目录中。创建的图块名称具有编号模式并包含源图块的名称

-of <格式> 

选择输出格式。从 GDAL 2.3 开始，如果未指定，则从扩展中猜测格式（以前是 GTiff）。使用短格式名称。

-co <名称=值> 

许多格式都有一个或多个可选的创建选项，可用于控制有关创建文件的细节。例如，GeoTIFF 驱动程序支持创建选项来控制压缩，以及文件是否应该平铺。

可用的创建选项因格式驱动程序而异，一些简单格式根本没有创建选项。可以使用–formats命令行选项列出格式支持的选项列表 ，但格式文档是有关驱动程序创建选项的权威信息来源。有关每种格式的合法创建选项，请参阅光栅驱动程序格式特定文档。

-ot <类型> Á

强制 输出图像波段具有驱动程序支持的 特定数据类型，可能是以下之一：Byte、、、、、、、、、、、、、、、或。Int8UInt16Int16UInt32Int32UInt64Int64Float32Float64CInt16CInt32CFloat32CFloat64

-ps <pixelsize_x> <pixelsize_y> Á

用于输出文件的像素大小。如果未指定，则默认为 256 x 256

-重叠< <val_in_pixel> Á

连续图块之间的重叠像素。如果未指定，则默认为 0

2.2 版中的新功能。

-levels <numberOfLevels> Á

要建造的金字塔层数。

-vÁ

在完成时生成磁贴操作的详细输出。

-仅金字塔Á

不拆瓦，只建金字塔

-r <算法> Á

重采样算法，默认为near

-s_srs <srs_def> Á

要使用的源空间参考。可以传递的坐标系是 OGRSpatialReference.SetFromUserInput() 调用支持的任何坐标系，包括 EPSG、PCS 和 GCSes（即 EPSG:4296）、PROJ.4 声明（如上所述）或 .prj 的名称包含众所周知文本的文件。如果没有给出 srs_def，则使用源图块的 srs_def（如果有的话）。srs_def 将传播到创建的图块（如果可能）和可选的形状文件

-tileIndex <tileIndexName> Á

包含结果图块索引的形状文件的名称

-tileIndexField <tileIndexFieldName> Á

包含瓦片名称的属性名称

-csv <csv文件名> Á

包含图块地理配准信息的 csv 文件的名称。该文件包含 5 列：tilename,minx,maxx,miny,maxy

-csvDelim <列分隔符> Á

CSV 文件中使用的列分隔符，默认值为分号“;”

-useDirForEachRowÁ

通常，基本图像的图块按照中所述进行存储-targetDir。对于大图像，如果目录中的文件数量过多，某些文件系统会出现性能问题，导致 gdal_retile 无法在合理的时间内完成。使用此参数创建不同的输出结构。基础图像的图块存储在名为 0 的子目录中，子目录中的金字塔编号为 1,2,...。在这些目录中的每一个目录中，都会创建另一个级别的子目录，编号从 0 到 n，具体取决于每个级别需要多少瓦片行。最后，目录仅包含特定级别的一行的图块。对于大图像，可以实现 N 倍的性能改进。

-恢复Á

恢复模式。只生成丢失的文件。