Clip data at +/-pi in longitude, +/-pi in latitude
[lat,long,splitpts] = clipdata(lat,long,'object')
[lat,long,splitpts] = clipdata(lat,long,'object') inserts NaNs at the appropriate locations in a map object so that a displayed map is clipped at the appropriate edges. It assumes that the clipping occurs at +/- pi/2 radians in the latitude (y) direction and +/- pi radians in the longitude (x) direction.
The input data must be in radians and properly transformed for the particular aspect and origin so that it fits in the specified clipping range.
The output data is in radians, with clips placed at the proper locations. The output variable splitpts returns the row and column indices of the clipped elements (columns 1 and 2 respectively). These indices are necessary to restore the original data if the map parameters or projection are ever changed.
Allowable object strings are:
surface for clipping graticules
light for clipping lights
line for clipping lines
patch for clipping patches
text for clipping text object location points
point for clipping point data
none to skip all clipping operations