This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

geotiffread

Read GeoTIFF file

Syntax

[A,R] = geotiffread(filename)
[X,cmap,R] = geotiffread(filename)
[A,refmat,bbox] = geotiffread(filename)
[X,cmap,refmat,bbox] = geotiffread(filename)
[___] = geotiffread(filename,idx)
[___] = geotiffread(url,___)

Description

[A,R] = geotiffread(filename) reads a georeferenced grayscale, RGB, or multispectral image or data grid from the GeoTIFF file specified by filename into A and creates a spatial referencing object, R.

[X,cmap,R] = geotiffread(filename) reads an indexed image into X and the associated colormap into cmap, and creates a spatial referencing object, R.

[A,refmat,bbox] = geotiffread(filename) reads a georeferenced grayscale, RGB, or multispectral image or data grid into A, the corresponding referencing matrix into refmat, and the bounding box into bbox.

[X,cmap,refmat,bbox] = geotiffread(filename) reads an indexed image into X, the associated colormap into cmap, the referencing matrix into refmat, and the bounding box into bbox. The referencing matrix must be unambiguously defined by the GeoTIFF file, otherwise it and the bounding box are returned empty.

[___] = geotiffread(filename,idx) reads one image from a multi-image GeoTIFF file.

[___] = geotiffread(url,___) reads the GeoTIFF image from a URL.

Examples

Read and Display the Boston GeoTIFF Image

[boston,R] = geotiffread('boston.tif');
figure
mapshow(boston,R);
axis image off

boston.tif copyright © GeoEye™, all rights reserved.

Input Arguments

collapse all

Name of the GeoTIFF file, specified as a string scalar or character vector. Include the folder name in filename or place the file in the current folder or in a folder on the MATLAB® path. If the named file includes the extension .TIF or .TIFF (either upper- or lowercase), you can omit the extension from filename.

Index of image in GeoTIFF file, specified as a positive integer. For example, if idx is 3, geotiffread reads the third image in the file. By default, idx indexes to the first image in the file.

Internet URL, specified as a string scalar or character vector. The URL must include the protocol type (e.g., "http://").

Output Arguments

collapse all

Georeferenced image or data grid, returned as one of the following:

  • An M-by-N numeric matrix when the file contains a grayscale image or data grid

  • An M-by-N-by-P numeric array when the file contains a color image, multispectral image, hyperspectral image, or data grid

The class of A depends on the storage class of the pixel data in the file, which is related to the BitsPerSample property as returned by the imfinfo function.

Spatial referencing object, returned as one of the following.

Indexed image, returned as an M-by-N numeric matrix.

Color map associated with indexed image X, specified as an c-by-3 numeric matrix. There are c colors in the color map, each represented by a red, green, and blue pixel value. Colormap values are rescaled into the range [0,1].

Referencing matrix, returned as 3-by-2 numeric matrix that transforms raster row and column indices to or from geographic coordinates according to:

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

refmat defines a (non-rotational, non-skewed) relationship in which each column of the data grid falls along a meridian and each row falls along a parallel. refmat must be unambiguously defined by the GeoTIFF file, otherwise it and the bounding box, bbox, are returned empty.

Data Types: double

Bounding box, returned as a 2-by-2 numeric matrix that specifies the minimum (row 1) and maximum (row 2) values for each dimension of the image data in the GeoTIFF file. bbox is returned empty if refmat is ambiguously defined by the GeoTIFF file.

Data Types: double

Tips

  • geotiffread imports pixel data using the TIFF-reading capabilities of the MATLAB function imread and likewise shares any limitations of imread. Consult the imread documentation for information on TIFF image support.

Introduced before R2006a