geotiffinfo

R2026b

关于 GeoTIFF 文件的信息

全页折叠

语法

info = geotiffinfo(filename)

info = geotiffinfo(url)

描述

info = geotiffinfo(filename) 会创建一个包含 GeoTIFF 文件相关信息的结构体。

示例

info = geotiffinfo(url) 从 URL 读取 GeoTIFF 图像。

示例

全部折叠

返回关于 GeoTIFF 文件的信息

打开实时脚本

返回有关 GeoTIFF 文件的信息。geotiffinfo 函数将信息存储在一个结构体中。

info = geotiffinfo("boston.tif")

info = struct with fields:
             Filename: '/tmp/Bdoc26b_3351752_548615/tp5229ae81/map-ex98657947/boston.tif'
          FileModDate: '13-May-2011 22:28:45'
             FileSize: 38729900
               Format: 'tif'
        FormatVersion: []
               Height: 2881
                Width: 4481
             BitDepth: 8
            ColorType: 'truecolor'
            ModelType: 'ModelTypeProjected'
                  PCS: 'NAD83 / Massachusetts Mainland'
           Projection: 'SPCS83 Massachusetts Mainland zone (meter)'
               MapSys: 'STATE_PLANE_83'
                 Zone: 2001
         CTProjection: 'CT_LambertConfConic_2SP'
             ProjParm: [7×1 double]
           ProjParmId: {7×1 cell}
                  GCS: 'NAD83'
                Datum: 'North American Datum 1983'
            Ellipsoid: 'GRS 1980'
            SemiMajor: 6378137
            SemiMinor: 6.3568e+06
                   PM: 'Greenwich'
    PMLongToGreenwich: 0
            UOMLength: 'US survey foot'
    UOMLengthInMeters: 0.3048
             UOMAngle: 'degree'
    UOMAngleInDegrees: 1
            TiePoints: [1×1 struct]
           PixelScale: [3×1 double]
           SpatialRef: [1×1 map.rasterref.MapCellsReference]
            RefMatrix: [3×2 double]
          BoundingBox: [2×2 double]
         CornerCoords: [1×1 struct]
         GeoTIFFCodes: [1×1 struct]
          GeoTIFFTags: [1×1 struct]
     ImageDescription: '"GeoEye"'

为 GeoTIFF 文件查找坐标参考系

打开实时脚本

查找 boston.tif 文件的投影坐标参考系 (CRS)。

将文件信息读取为结构体数组。然后，查询结构体数组中 SpatialRef 字段内的栅格参考对象的 ProjectedCRS 属性。

info = geotiffinfo("boston.tif");
crs = info.SpatialRef.ProjectedCRS

crs = 
  projcrs with properties:

                    Name: "NAD83 / Massachusetts Mainland"
        ProjectionMethod: "Lambert Conic Conformal (2SP)"
              LengthUnit: "U.S. survey foot"
    ProjectionParameters: [1×1 map.crs.ProjectionParameters]
           GeographicCRS: [1×1 geocrs]
             VerticalCRS: []

如果您的文件参考了地理坐标参考系 (CRS)，请查询 GeographicCRS 属性而非 ProjectedCRS 属性。

输入参数

全部折叠

`filename` — GeoTIFF 文件名称
字符串标量 | 字符向量

GeoTIFF 文件的名称，指定为字符串标量或字符向量。在文件名中包含文件夹名称 filename，或将文件放置在当前文件夹中，或放置在 MATLAB^® 路径下的文件夹中。

如果指定文件包含多个 GeoTIFF 图像，则 info 是一个结构体数组，该数组中的每个元素对应文件中的一个图像。例如，对于包含三张 GeoTIFF 图像的文件，info(3) 包含该文件中第三张图像的信息。如果文件中包含多张图像，该函数会假设每张图像的制图信息、图像宽度和图像高度均相同。

`url` — Internet URL
字符串标量 | 字符向量

Internet URL，指定为字符串标量或字符向量。URL 必须包含协议类型，例如 http://。

输出参量

全部折叠

`info` — GeoTIFF 文件的图像属性与制图信息
结构体

GeoTIFF 文件的图像属性与制图信息，以包含以下字段的结构体形式返回。

字段描述

Filename

文件名或 URL

FileModDate

文件修改日期

FileSize

表示文件大小（以字节为单位）的整数。

Format

文件格式（始终为 'tiff'）

FormatVersion

文件格式版本

Height

表示图像高度（以像素为单位）的整数

Width

表示图像宽度的整数（单位为像素）

BitDepth

表示每像素位数的整数

ColorType

图像类型：'truecolor' 表示真彩色 (RGB) 图像，'grayscale' 表示灰度图像，'indexed' 表示索引图像。

ModelType

用于对图像进行地理配准的坐标系类型：'ModelTypeProjected'、'ModelTypeGeographic'、'ModelTypeGeocentric' 或 ''。

PCS

投影坐标系

Projection

底层投影方法的 EPSG 标识符

MapSys

地图系统（如适用）：'STATE_PLANE_27、'STATE_PLANE_83'、'UTM_NORTH'、'UTM_SOUTH' 或 ''

Zone

double 表示 UTM 或州平面坐标系分区号，若不适用或未知则为空 ([])

CTProjection

底层投影方法的 GeoTIFF 标识符

ProjParm

N×1 double 向量，包含投影参数值。每个元素的身份由 ProjParmId 的对应元素指定。长度单位为米，角度单位为十进制度。

ProjParmId

N×1 元胞数组，列出 ProjParm 中每个对应数值元素的投影参数标识符：

'ProjNatOriginLatGeoKey'
'ProjNatOriginLongGeoKey'
'ProjFalseEastingGeoKey'
'ProjFalseNorthingGeoKey'
'ProjFalseOriginLatGeoKey'
'ProjFalseOriginLongGeoKey'
'ProjCenterLatGeoKey'
'ProjCenterLongGeoKey'
'ProjAzimuthAngleGeoKey'
'ProjRectifiedGridAngleGeoKey'
'ProjScaleAtNatOriginGeoKey'
'ProjStdParallel1GeoKey'
'ProjStdParallel2GeoKey'

GCS

地理坐标系

Datum

投影基准面类型，例如 'North American Datum 1927' 或 'North American Datum 1983'

Ellipsoid

椭球体的名称，以字符向量形式返回。

SemiMajor

double 表示椭球体长半轴的长度，单位为米

SemiMinor

double 表示椭球体短半轴的长度，单位为米

PM

本初子午线位置，例如 'Greenwich' 或 'Paris'

PmLongToGreenwich

double 表示该本初子午线与格林尼治经线之间的经度十进制度数。格林尼治以西的本初子午线为负值。

UOMLength

投影坐标系中使用的长度单位

UOMLengthInMeters

double 定义单位 UOMLength 为米。

UOMAngle

用于地理坐标的角单位

UOMAngleInDegrees

double 定义单位 UOMAngle 为度。

TiePoints

包含图像连接点的结构体。该结构包含以下字段：

字段名称描述

ImagePoints

包含每张图像连接点行和列坐标的结构体。ImagePoints 结构包含以下字段：

Row - double 1×N 大小的数组
Col - double 1×N 大小的数组

WorldPoints

包含连接点 x 和 y 世界坐标的结构体。WorldPoints 结构包含以下字段：

X - double 1×N 大小的数组
Y - double 1×N 大小的数组

PixelScale

3×1 double 数组，用于指定 X、Y、Z 方向的像素缩放系数。

SpatialRef

值取决于 ModelType 字段的值：

'ModelTypeProjected' - SpatialRef 是 MapCellsReference 或 MapPostingsReference 对象。
'ModelTypeGeographic' - SpatialRef 是 GeographicCellsReference 或 GeographicPostingsReference 对象，除非几何变换为仿射变换，此时其为空 ([])。
'ModelTypeGeocentric' - SpatialRef 为空 ([])。
空 ([])- geotiffinfo 发出警告，而 SpatialRef 是地图栅格参考对象。

如果 GeoTIFF 文件中对栅格参考的定义存在歧义，则 SpatialRef 为空 ([])。

RefMatrix

3×2 double 参考矩阵必须由 GeoTIFF 文件明确无误地定义。否则就是空的 ([])。

BoundingBox

2×2 double 数组，用于指定 GeoTIFF 文件中图像数据各维度的最小值（第 1 行）和最大值（第 2 行）。

CornerCoords

包含六个字段的结构体，用于存储 GeoTIFF 图像外角坐标。每个字段是一个 1×4 的 double 数组，若未知则为空 ([])。数组包含角像素外角的坐标，从 (1,1) 角开始并按顺时针方向排列：

字段	描述
`X`	投影坐标系中的东坐标。当 `ModelType` 等于 `'ModelTypeGeographic'` 时，`X` 等于 `Lon`（见下文）。
`Y`	投影坐标系中的北向坐标。当 `ModelType` 等于 `'ModelTypeGeographic'` 时，`Y` 等于 `Lat`（见下文）。
`Row`	角点的行坐标。
`Col`	角点的列坐标。
`Lat`	角点的纬度。
`Lon`	角点的经度。

GeoTIFFCodes

包含原始数值的结构，用于文件中以数字形式编码的 GeoTIFF 字段。这些原始值在 info 结构的其他位置转换为字符向量，此处仅供参考。

Model
PCS
GCS
UOMLength
UOMAngle
Datum
PM
Ellipsoid
ProjCode
Projection
CTProjection
ProjParmId
MapSys

每个都是标量，除了 ProjParmId，它是一个列向量。

GeoTIFFTags

包含与文件中 GeoTIFF 标签匹配的字段名的结构。文件中必须至少包含一个 GeoTIFF 标签，否则将触发错误。以下字段可包含：

字段	值
`ModelPixelScaleTag`	1×3 `double`
`ModelTiepointTag`	1×6 `double`
`ModelTransformationTag`	1×16 `double`
`GeoKeyDirectoryTag`	标量结构
`GeoAsciiParamsTag`	字符向量
`GeoDoubleParamsTag`	1×N `double`
`RPCCoefficientTag`	标量 `RPCCoefficientTag`

GeoKeyDirectoryTag 包含与 "GeoKeys" 名称匹配的字段名称。有关“GeoKeys”的更多信息，请参阅 GeoTIFF 规范。

RPCCoefficientTag 包含的属性名称与 RPCs in GeoTIFF 技术说明中列出的标签元素相对应，该说明位于：http://geotiff.maptools.org/rpc_prop.html

ImageDescription

图像说明。如果文件中未包含描述，则该字段将被省略。

版本历史记录

在 R2006a 之前推出

全部展开

R2022a: 读取 GeoTIFF 文件的坐标参考系

geotiffinfo 函数分别读取 GeoTIFF 文件的投影或地理坐标参考系 (CRS)，并将其作为 projcrs 或 geocrs 对象返回。

要查找 CRS，请使用 geotiffinfo 函数获取 GeoTIFF 文件的信息，该函数返回一个结构体数组。然后，查询结构体数组中 SpatialRef 字段内栅格参考对象的 CRS 属性。如果文件参考了投影 CRS，则查询 ProjectedCRS 属性。如果文件参考了地理坐标参考系，则查询 GeographicCRS 属性。此代码片段演示了如何获取 boston.tif 文件的坐标参考系 (CRS)，该文件采用投影坐标参考系进行参考。

info = geotiffinfo("boston.tif");
crs = info.SpatialRef.ProjectedCRS

crs = 

  projcrs with properties:

                    Name: "NAD83 / Massachusetts Mainland"
           GeographicCRS: [1×1 geocrs]
        ProjectionMethod: "Lambert Conic Conformal (2SP)"
              LengthUnit: "U.S. survey foot"
    ProjectionParameters: [1×1 map.crs.ProjectionParameters]

另请参阅

geotiffinfo

语法

描述

示例

返回关于 GeoTIFF 文件的信息

为 GeoTIFF 文件查找坐标参考系

输入参数

filename — GeoTIFF 文件名称 字符串标量 | 字符向量

url — Internet URL 字符串标量 | 字符向量

输出参量

info — GeoTIFF 文件的图像属性与制图信息 结构体

版本历史记录

R2022a: 读取 GeoTIFF 文件的坐标参考系

另请参阅

函数

对象

主题

`filename` — GeoTIFF 文件名称
字符串标量 | 字符向量

`url` — Internet URL
字符串标量 | 字符向量

`info` — GeoTIFF 文件的图像属性与制图信息
结构体