gdallocationinfo
栅格查询工具
简介
Usage: gdallocationinfo [--help-general] [-xml] [-lifonly] [-valonly]
[-b band]* [-overview overview_level]
[-l_srs srs_def] [-geoloc] [-wgs84]
[-oo NAME=VALUE]* srcfile [x y]
描述
这个 gdallocationinfo 实用程序提供了一种机制,可以根据像素在各种坐标系中的位置查询有关该像素的信息。提供了几种报告选项。
- -xml
输出报告将采用XML格式,便于后期处理。
- -lifonly
唯一的输出是根据数据库从LocationInfo请求生成的文件名(即用于从VRT识别受影响的文件)。
- -valonly
唯一的输出是每个选定带上选定像素的像素值。
- -b <band>
选择要查询的标注栏。可以列出多个波段。默认情况下,将查询所有标注栏。
- -overview <overview_level>
查询(overview_level)th overview(overview_level=1是第一个overview),而不是基带。注意x,y的位置(如果坐标系是像素/线)仍然必须相对于基带给出。
- -l_srs <srs_def>
输入x,y位置的坐标系。
- -geoloc
表示输入的x、y点在图像的地理参照系统中。
- -wgs84
表示输入x,y点为WGS84长,纬度。
- -oo NAME=VALUE
数据集打开选项(特定于格式)
- <srcfile>
源GDAL栅格数据源名称。
- <x>
目标像素的X位置。默认情况下,坐标系为像素/直线,除非提供了-l_srs、-wgs84或-geoloc。
- <y>
目标像素的Y位置。默认情况下,坐标系为像素/直线,除非提供了-l_srs、-wgs84或-geoloc。
此实用程序旨在提供有关像素的各种信息。目前报告:
像素在像素/行空间中的位置。
对数据源执行LocationInfo元数据查询的结果。这是为VRT文件实现的,VRT文件将报告用于满足该像素请求的文件,并且 MBTiles 驱动
该像素对所有或一个子带的栅格像素值。
如果缩放和/或偏移应用于带区,则为未缩放像素值。
所选像素由命令行上的x/y坐标请求,或从stdin读取。从stdin读取坐标时,可以提供多个坐标对。默认情况下,需要像素/线坐标。但是使用 -geoloc
, -wgs84
或 -l_srs
可以在其他坐标系中指定位置。
默认报告是人类可读的文本格式。可以使用-xml开关请求xml输出。
为了编写脚本,提供了-valonly和-lifonly开关,以将输出限制为实际像素值,或为像素标识的LocationInfo文件。
预计未来将向gdallocationinfo添加额外的报告功能。
实例
关于文件utm.tif中像素(256256)的简单示例报告。
$ gdallocationinfo utm.tif 256 256
Report:
Location: (256P,256L)
Band 1:
Value: 115
查询在WGS84中提供位置的VRT文件,并以xml格式获取结果。
$ gdallocationinfo -xml -wgs84 utm.vrt -117.5 33.75
<Report pixel="217" line="282">
<BandReport band="1">
<LocationInfo>
<File>utm.tif</File>
</LocationInfo>
<Value>16</Value>
</BandReport>
</Report>
从stdin读取位置。
$ cat coordinates.txt
443020 3748359
441197 3749005
443852 3747743
$ cat coordinates.txt | gdallocationinfo -geoloc utmsmall.tif
Report:
Location: (38P,49L)
Band 1:
Value: 214
Report:
Location: (7P,38L)
Band 1:
Value: 107
Report:
Location: (52P,59L)
Band 1:
Value: 148