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)

Version History

Introduced before R2006a

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.