grid2image

Display regular data grid as image

Syntax

grid2image(Z,R) grid2image(Z,R,PropertyName,PropertyValue,...) h = grid2image(...)

Description

grid2image(Z,R) displays a regular data grid Z as an image. The image is displayed in unprojected form, with longitude as x and latitude as y, producing considerable distortion away from the Equator. Z can be M-by-N or M-by-N-by-3, and can contain double, uint8, or uint16 data. The grid is georeferenced to latitude-longitude by R, which is a GeographicCellsReference object. The RasterSize property of R must be consistent with Z.

grid2image(Z,R,PropertyName,PropertyValue,...) uses the specified image properties to display the map. See the image function reference page for a list of properties that can be changed.

h = grid2image(...) returns the handle of the image object displayed.

Examples

Load elevation raster data and a geographic cells reference object. Then, display the data as an image.

load topo60c
figure
grid2image(topo60c,topo60cR)

World elevation data

Version History

Introduced before R2006a

expand all

R2024b: `grid2image` does not accept referencing vectors or referencing matrices as input

The grid2image function does not accept referencing vectors or referencing matrices as input. Use a geographic raster reference object, specified as a GeographicCellsReference object, as input instead. Reference objects have several advantages over referencing vectors and referencing matrices.

Unlike referencing vectors and referencing matrices, reference objects have properties that document the size of the associated raster, its geographic limits, and the direction of its rows and columns.
You can manipulate the limits of geographic rasters associated with reference objects using the geocrop function.
You can manipulate the size and resolution of geographic rasters associated with reference objects using the georesize function.

To update your code, create a geographic reference object.

Create a geographic reference object for a raster of cells by using the georefcells function.
Convert from a referencing vector to a geographic reference object by using the refvecToGeoRasterReference function.
Convert from a referencing matrix to a geographic reference object by using the refmatToGeoRasterReference function.

Once you have created a reference object, replace uses of the referencing vector or referencing matrix in your code with the reference object.

R2023b: `grid2image` will not accept referencing vectors or referencing matrices as input

When you specify a referencing vector or referencing matrix as input, the grid2image function issues a warning that it will not accept referencing vectors or referencing matrices as input in a future release.