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