gdal_proximity.py

生成栅格近似地图。

简介

gdal_proximity.py <srcfile> <dstfile> [-srcband n] [-dstband n]
                  [-of format] [-co name=value]*
                  [-ot Byte/UInt16/UInt32/Float32/etc]
                  [-values n,n,n] [-distunits PIXEL/GEO]
                  [-maxdist n] [-nodata n] [-use_input_nodata YES/NO]
                  [-fixed-buf-val n]

描述

这个 gdal_proximity.py 脚本生成一个栅格接近图,指示从每个像素的中心到最近的被标识为目标像素的像素的中心的距离。目标像素是源栅格中的那些像素,其栅格像素值在目标像素值集中。

<srcfile>

用于标识目标像素的源栅格文件。

<dstfile>

邻近地图将写入的目标栅格文件。它可能是与srcfile大小相同的预先存在的文件。如果它不存在,它将被创建。

-srcband <n>

标识要使用的源文件中的带区(默认值为1)。

-dstband <n>

标识要使用的目标文件中的带区(默认值为1)。

-of <format>

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

-co <NAME=VALUE>

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

可用的创建选项因格式驱动程序而异,有些简单格式根本没有创建选项。格式支持的选项列表可以与 --formats 命令行选项,但该格式的文档是有关驱动程序创建选项的最终信息源。见 栅格驱动器 每种格式的法律创建选项的特定格式文档。

-ot <type>

指定驱动程序支持的数据类型,可以是以下类型之一: ByteUInt16Int16UInt32Int32Float32 (默认),或 Float64 .

-values <n>,<n>,<n>

源图像中被视为目标像素的目标像素值列表。如果未指定,所有非零像素将被视为目标像素。

-distunits PIXEL|GEO

指示生成的距离应为像素坐标还是地理参考坐标(默认像素)。

-maxdist <n>

要生成的最大距离。nodata值将用于超过此距离的像素。如果未提供nodata值,则将查询输出频带以获取其nodata值。如果输出频带没有nodata值,则将使用值65535。除非指定了-distunits GEO,否则距离以像素为单位进行解释。

-nodata <n>

指定要用于目标接近栅格的节点数据值。

-use_input_nodata YES/NO

指示输入栅格中的nodata像素是否应为输出栅格中的nodata(默认为否)。

-fixed-buf-val <n>

指定要应用于目标像素(包括目标像素)的-maxdist范围内的所有像素的值,而不是距离值。