nanm

(To be removed) Construct regular data grid of NaNs

nanm will be removed in a future release. Use the georefcells and NaN functions instead. For more information, see Compatibility Considerations.

Syntax

[Z,refvec] = nanm(latlim,lonlim,scale)


Description

[Z,refvec] = nanm(latlim,lonlim,scale) returns a regular data grid consisting entirely of NaNs and a three-element referencing vector for the returned Z. The two-element vectors latlim and lonlim define the latitude and longitude limits of the geographic region. They should be of the form [south north] and [west east], respectively. The scalar scale specifies the number of rows and columns per degree of latitude and longitude.

Examples

[Z,refvec] = nanm([46,51],[-79,-75],1)

Z =
   NaN   NaN   NaN   NaN
   NaN   NaN   NaN   NaN
   NaN   NaN   NaN   NaN
   NaN   NaN   NaN   NaN
   NaN   NaN   NaN   NaN
refvec =
     1    51   -79

Compatibility Considerations

nanm will be removed

Not recommended starting in R2015b

Some functions that return referencing vectors will be removed, including the nanm function. Instead, create a geographic raster reference object using the georefcells function and a matrix of NaN values using the NaN function. Reference objects have several advantages over referencing vectors.

• Unlike referencing vectors, reference objects have properties that document the size of the associated raster, its geographic limits, and the direction of its rows and columns. For examples of reference object properties, see the GeographicPostingsReference object.

• You can manipulate the limits of rasters associated with geographic reference objects using the geocrop function.

• You can manipulate the size and resolution of rasters associated with geographic reference objects using the georesize function.

• Most functions that accept referencing vectors as inputs also accept reference objects.

This table shows how to update your code to use the georefcells and NaN functions instead of the nanm function.

Will Be Removed	Recommended
[Z,refvec] = nanm(latlim,lonlim,scale);	R = georefcells(latlim,lonlim,1/scale,1/scale); Z = NaN(R.RasterSize);