gdal_edit.py

就地编辑现有GDAL数据集的各种信息。

简介

gdal_edit [--help-general] [-ro] [-a_srs srs_def]
        [-a_ullr ulx uly lrx lry] [-a_ulurll ulx uly urx ury llx lly]
        [-tr xres yres] [-unsetgt] [-unsetrpc] [-a_nodata value] [-unsetnodata]
        [-unsetstats] [-stats] [-approx_stats]
        [-setstats min max mean stddev]
        [-scale value] [-offset value] [-units value]
        [-colorinterp_X red|green|blue|alpha|gray|undefined]*
        [-gcp pixel line easting northing [elevation]]*
        [-unsetmd] [-oo NAME=VALUE]* [-mo "META-TAG=VALUE"]*  datasetname

描述

这个 gdal_edit.py 脚本可用于就地编辑现有GDAL数据集(投影、geotransform、nodata、元数据)的各种信息。

它只适用于支持对现有数据集的更新访问的栅格格式。

小心

根据格式的不同,更新信息的旧值可能仍然在文件中处于“ghost”状态,即使不再可以通过GDAL API访问。例如 GTiff—GeoTIFF文件格式 格式(这不是一个详尽的列表)。

--help-general

给出通用GDAL命令行选项和exit的简短用法消息。

-ro

以只读方式打开数据集。对于拒绝在更新模式下使用数据集的驱动程序可能很有用。在这种情况下,更新的信息将进入PAM .aux.xml 文件夹。

-a_srs <srs_def>

定义目标坐标系。此坐标系将写入数据集。如果指定了空字符串或“无”,则将删除现有坐标系(对于TIFF/GeoTIFF,除此之外可能不太受支持)。

-a_ullr ulx uly lrx lry:

指定/覆盖数据集的地理参考边界。

-a_ulurll ulx uly urx ury llx lly:

从三个点指定/覆盖数据集的地理参考边界:左上、右上和左下。不像 -a_ullr ,这也支持旋转数据集(边不平行于坐标系轴)。

3.1 新版功能.

-tr <xres> <yres>

设定目标分辨率。这些值必须用地理参考单位表示。两者都必须是正值。

-unsetgt

删除地理参考信息。

-unsetrpc

删除RPC信息。

2.4 新版功能.

-unsetstats

删除波段统计信息。

2.0 新版功能.

-stats

计算并存储波段统计信息。

2.0 新版功能.

-setstats min max mean stddev

存储用户定义的频带统计值(最小值、最大值、平均值和标准偏差)。如果任何值设置为“无”,则实际统计数据将从文件中计算出来,而设置为“无”的值将从实际统计数据中使用。

2.4 新版功能.

-approx_stats

计算并存储大概的波段统计信息。

2.0 新版功能.

-a_nodata <value>

为输出频带分配指定的nodata值。

-unsetnodata

删除现有的nodata值。

2.1 新版功能.

-scale <value>

为输出标注栏指定比例值。如果提供单个刻度值,则将为所有标注栏设置该值。或者,可以为每个频带提供一个刻度值,在这种情况下,刻度值的数量必须与频带的数量匹配。如果不需要缩放,建议将该值设置为1。比例和偏移通常一起使用。例如,scale和offset可用于在精度为0.1且从-100开始的无符号16位整数文件中存储高程。真值计算如下:真值=(像素值*比例)+偏移量

备注

这些值可以在 gdal_translate 跑。

2.2 新版功能.

-offset <value>

为输出标注栏指定偏移值。如果提供单个偏移值,则将为所有标注栏设置该值。或者,可以为每个频带提供一个偏移值,在这种情况下,偏移值的数量必须与频带的数量匹配。如果不需要偏移,建议将该值设置为0。有关更多信息,请参见比例。

2.2 新版功能.

-units <value>

为输出频带分配一个单元。

3.1 新版功能.

-colorinterp_X red|green|blue|alpha|gray|undefined

更改波段X的颜色解释(其中X是有效的波段号,从1开始)。

2.3 新版功能.

-gcp pixel line easting northing [elevation]

将指定的地面控制点添加到数据集。可多次提供此选项以提供一组GCP。

-unsetmd

删除现有元数据(在默认元数据域中)。可以与 -mo .

2.0 新版功能.

-mo META-TAG=VALUE

如果可能,传递要在输出数据集上设置的元数据键和值。此元数据将添加到现有元数据项中,除非 -unsetmd 也指定了。

-oo NAME=VALUE

打开选项(特定于格式)。

2.0 新版功能.

这个 -a_ullr-a_ulurll-tr-unsetgt 选项是唯一的。

这个 -unsetstats 而且 -stats-approx_stats 选项是唯一的。

例子

gdal_edit -mo DATUM=WGS84 -mo PROJ=GEODETIC -a_ullr 7 47 8 46 test.ecw
gdal_edit -scale 1e3 1e4 -offset 0 10 twoBand.tif