imbedm

Encode data points into regular data grid

Syntax

Z = imbedm(lat, lon, value, Z, R)
Z = imbedm(lat, lon, value, Z, R, units)
[Z, indxPointOutsideGrid] = imbedm(...)


Description

Z = imbedm(lat, lon, value, Z, R) resets certain entries of a regular data grid, Z. Specify R as a GeographicCellsReference or GeographicPostingsReference object. The RasterSize property of R must be consistent with size(Z).

Z = imbedm(lat, lon, value, Z, R, units) specifies the units of the vectors lat and lon, where units is any valid angle units character vector ('degrees' by default).

[Z, indxPointOutsideGrid] = imbedm(...) returns the indices of lat and lon corresponding to points outside the grid in the variable indxPointOutsideGrid.

Examples

Create a simple grid map and embed new values in it:

Z = ones(3,6)

Z =
     1     1     1     1     1     1
     1     1     1     1     1     1
     1     1     1     1     1     1
refvec = [1/60 90 -180]

refvec =
    0.0167   90.0000 -180.0000

newgrid = imbedm([23 -23], [45 -45],[5 5],Z,refvec)

newgrid =
     1     1     1     1     1     1
     1     1     5     5     1     1
     1     1     1     1     1     1

Version History

Introduced before R2006a

R2024b: imbedm does not accept referencing vectors or referencing matrices as input

The imbedm function does not accept referencing vectors or referencing matrices as input. Use a geographic raster reference object, specified as a GeographicCellsReference or GeographicPostingsReference 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.

• Create a geographic reference object for a raster of regularly posted samples by using the georefpostings 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: imbedm will not accept referencing vectors or referencing matrices as input

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