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。
- -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