geotiffread

(不推荐) 读取 GeoTIFF 文件

全页折叠

geotiffread 不建议使用，除非是从 URL 读取 GeoTIFF 文件，或从同一文件读取多张图像。在其他情况下，请改用 readgeoraster。有关详细信息，请参阅版本历史记录。

语法

[A,R] = geotiffread(filename)

[X,cmap,R] = geotiffread(filename)

[A,refmat,bbox] = geotiffread(filename)

[X,cmap,refmat,bbox] = geotiffread(filename)

[___] = geotiffread(url)

[___] = geotiffread(___,idx)

说明

[A,R] = geotiffread(filename) 从由 filename 指定的 GeoTIFF 文件中读取地理参考的灰度、RGB 或多光谱图像或数据网格，将其写入 A，并创建空间参考对象 R。

示例

[X,cmap,R] = geotiffread(filename) 将索引图像读入 X，并将关联的颜色图读入 cmap，并创建空间参考对象 R。

[A,refmat,bbox] = geotiffread(filename) 将地理参考的灰度、RGB 或多光谱图像或数据网格读入 A，将对应的参考矩阵读入 refmat，并将边界框读入 bbox。

[X,cmap,refmat,bbox] = geotiffread(filename) 将索引图像读入 X，将关联的颜色图读入 cmap，将参考矩阵读入 refmat，并将边界框读入 bbox。参考矩阵必须由 GeoTIFF 文件明确无误地定义，否则该矩阵及其边界框将返回空值。

[___] = geotiffread(url) 从 URL 读取 GeoTIFF 图像。

[___] = geotiffread(___,idx) 从多图像 GeoTIFF 文件或 URL 中读取一张图像。

示例

全部折叠

读取并显示 GeoTIFF 文件中的图像

打开实时脚本

将 GeoTIFF 文件读取到工作空间中，作为数组和地图单元参考对象。

[boston,R] = geotiffread("boston.tif");

使用 mapshow 函数显示图像。

figure
mapshow(boston,R)
axis image off

Figure contains an axes object. The hidden axes object contains an object of type image.

输入参数

全部折叠

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

GeoTIFF 文件的名称，指定为字符串标量或字符向量。在文件名中包含文件夹名称 filename，或将文件放置在当前文件夹中，或放置在 MATLAB^® 路径下的文件夹中。若指定文件包含扩展名 .TIF 或 .TIFF（不区分大小写），则可省略 filename 的扩展名。

`idx` — GeoTIFF 文件中的图像索引
`1` (默认) | 正整数

GeoTIFF 文件中图像的索引，指定为正整数。例如，如果 idx 是 3，则 geotiffread 读取文件中的第三张图像。默认情况下，idx 会索引到文件中的第一张图像。

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

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

输出参量

全部折叠

`A` — 地理参考图像或数据网格
M×N 数值矩阵 | M×N×P 数值数组

地理参考图像或数据网格，返回值为以下之一：

当文件包含灰度图像或数据网格时，生成一个由 M×N 组成的数字矩阵
当文件包含彩色图像、多光谱图像、高光谱图像或数据网格时，生成一个由 M×N×P 组成的数组

A 类的存储类取决于文件中像素数据的存储类，该存储类与 imfinfo 函数返回的 BitsPerSample 属性相关。

`R` — 空间参考对象
地理栅格参考对象 | 地图栅格参考对象

空间参考对象，返回值为以下之一：

类型为 GeographicCellsReference 或 GeographicPostingsReference 的地理栅格参考对象。当图像或数据网格被参考到地理坐标系时，将返回此对象。
类型为 MapCellsReference 或 MapPostingsReference 的地图栅格参考对象。当图像或数据网格被参考到投影坐标系时，将返回此对象。

`X` — 索引图像
M×N 数值矩阵

索引图像，以 M×N 数值矩阵形式返回。

`cmap` — 颜色图
c×3 数字矩阵

与索引图像 X 关联的颜色映射，指定为 c×3 数值矩阵。颜色映射中包含 c 种颜色，每种颜色由红、绿、蓝三原色像素值表示。颜色图值被重新缩放至 [0,1] 区间。

`refmat` — 参考矩阵
3×2 数值矩阵 | `[]`

参考矩阵，以 3×2 数值矩阵形式返回，根据以下规则将栅格行和列索引转换为地理坐标或反向转换：

[lon lat] = [row col 1] * refmat

refmat 定义了一种（非旋转、非倾斜）关系，其中数据网格的每列沿经线分布，每行沿纬线分布。refmat 必须由 GeoTIFF 文件明确定义，否则该坐标系及其边界框 bbox 将返回空值。

数据类型: double

`bbox` — 边界框
2×2 数值矩阵 | `[]`

边界框，以 2×2 数值矩阵形式返回，该矩阵指定 GeoTIFF 文件中图像数据各维度的最小值（第 1 行）和最大值（第 2 行）。若 GeoTIFF 文件对 refmat 的定义存在歧义，则 bbox 返回空值。

数据类型: double

提示

geotiffread 通过调用 MATLAB 函数 imread 的 TIFF 读取功能导入像素数据，同时同样继承了 imread 的所有限制。有关 TIFF 图像支持的信息，请参阅 imread 文档。

版本历史记录

在 R2006a 之前推出

全部折叠

R2020a: 不建议使用 `geotiffread`

geotiffread 不建议使用，除非是从 URL 读取 GeoTIFF 文件，或从同一文件读取多张图像。在其他情况下，请改用 readgeoraster。目前没有计划移除 geotiffread。

与 geotiffread 函数不同，后者在某些情况下会返回参考矩阵，而 readgeoraster 函数则返回栅格参考对象。参考对象相较于参考矩阵具有若干优势。

与参考矩阵不同，参考对象具有记录关联栅格大小、边界以及行与列方向的属性。有关参考对象属性的示例，请参阅 GeographicCellsReference 和 MapPostingsReference。
您可以使用 geocrop 或 mapcrop 函数来操作与参考对象关联的栅格边界。
您可以使用 georesize 或 mapresize 函数来调整与参考对象关联的栅格的大小和分辨率。

此表展示了 geotiffread 的一些典型用法，以及如何更新代码以改用 readgeoraster。与 geotiffread 不同，readgeoraster 函数要求您指定文件扩展名。例如，使用 [Z,R] = readgeoraster('boston.tif')。

不推荐	推荐
[A,R] = geotiffread(filename);	[A,R] = readgeoraster(filename);
[X,cmap,R] = geotiffread(filename);	[X,R,cmap] = readgeoraster(filename);
[A,refmat,bbox] = geotiffread(filename);	[A,R] = readgeoraster(filename); xlimits = R.XWorldLimits; ylimits = R.YWorldLimits; bbox = [xlimits' ylimits'];

不推荐

另请参阅

主题

支持导入和导出的地理空间文件格式

geotiffread

语法

说明

示例

读取并显示 GeoTIFF 文件中的图像

输入参数

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

idx — GeoTIFF 文件中的图像索引 1 (默认) | 正整数

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

输出参量

A — 地理参考图像或数据网格 M×N 数值矩阵 | M×N×P 数值数组

R — 空间参考对象 地理栅格参考对象 | 地图栅格参考对象

X — 索引图像 M×N 数值矩阵

cmap — 颜色图 c×3 数字矩阵

refmat — 参考矩阵 3×2 数值矩阵 | []

bbox — 边界框 2×2 数值矩阵 | []

提示

版本历史记录

R2020a: 不建议使用 geotiffread

另请参阅

主题

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

`idx` — GeoTIFF 文件中的图像索引
`1` (默认) | 正整数

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

`A` — 地理参考图像或数据网格
M×N 数值矩阵 | M×N×P 数值数组

`R` — 空间参考对象
地理栅格参考对象 | 地图栅格参考对象

`X` — 索引图像
M×N 数值矩阵

`cmap` — 颜色图
c×3 数字矩阵

`refmat` — 参考矩阵
3×2 数值矩阵 | `[]`

`bbox` — 边界框
2×2 数值矩阵 | `[]`

R2020a: 不建议使用 `geotiffread`