Mapping Toolbox
  Go to function:
    Search    Help Desk 

Chapter 1
Mapping Reference

Function Tables

Map Definition And Display

Table 1-1 Projection Control

Function
 Description
axesm
 Map axes definition and property setting.
defaultm
 Initialize default map projection structure.
gcm
 Get current map data structure.
ismap
 Test if axes have a map definition.
ismapped
 Test if object is projected on map axes.
maps
 List available map projections and verify id strings.
project
 Project displayed graphics object.
usamap
 Create a map of the United States of America.
worldmap
 Maps a country or region using the worldlo atlas data.

Table 1-2 Projection Calculations

Function
 Description
distortcalc
 3-D contour plot of matrix map data.
mfwdtran
 Project geographic data without displaying.
minvtran
 Transform projected data back to geographic coordinates without displaying.
utmgeoid
 Recommended UTM geoids for zone.
utmzone
 Universal Transverse Mercator zone.
vfwdtran
 Transform vector azimuths to a projection space angle.
vinvtran
 Transform azimuths from a projection space angle.

Table 1-3 Projecting Line Data

Function
 Description
contor3m
 3-D contour plot of matrix map data.
contorm
 2-D contour plot of matrix map data.
linem
 Project line objects onto current map axes.
plot3m
 Project 3-D lines onto current map axes.
plotm
 Project 2-D lines onto current map axes.

Table 1-4 Projecting Patch Data

Function
 Description
contourfm
 Filled contour map.
fill3m
 Filled 3-D map polygons in 3-D space.
fillm
 Filled 2-D map polygons.
patchesm
 Project patch faces as objects onto current map axes.
patchm
 Project patch objects onto current map axes.

Table 1-5 Projecting 3-D Map Surface and Mesh Data

Function
 Description
imagem
 Regular matrix map displayed as image.
meshm
 Regular matrix map warped to projected graticule mesh.
pcolorm
 Projected matrix map in z = 0 plane.
surfacem
 Matrix map warped to projected graticule mesh.
surfm
 Matrix map projected on map axes.

Table 1-6 Projecting Light Objects and Lighted Surfaces

Function
 Description
lightm
 Project light source onto current map.
meshlsrm
 3-D lighted shaded relief of regular matrix map.
surflm
 3-D shaded surface with lighting projected on map axes.
surflsrm
 3-D lighted shaded relief of general matrix map.
shaderel
 Construct cdata and colormap for colored shaded relief.

Table 1-7 Thematic Maps

Function
 Description
comet3m
 3-D comet plot projected on map axes.
cometm
 2-D comet plot projected on map axes.
quiver3m
 3-D quiver plot projected on map axes.
quiverm
 2-D quiver plot projected on map axes.
stem3m
 Project stem map onto current map axes.
scatterm
 Construct thematic map with proportional symbols.

Map Appearance And Interaction

Table 1-8 Annotation

Function
 Description
clabelm
 Map contour labeling.
clegendm
 Add legend labels to map contour plot.
demcmap
 Generation of color maps.
framem
 Toggle display of map frame.
gridm
 Grid lines projected on map axes.
mdistort
 Displays contours of constant distortion on a map.
mlabel
 Meridian labels projected on map axes.
plabel
 Parallel labels projected on map axes.
polcmap
 Colormap for political maps.
scaleruler
 Add or modify graphic scale.
textm
 Text annotation projected onto map axes.

Table 1-9 Interaction

Function
 Description
gcpmap
 Get current mouse point from map.
gtextm
 Mouse placement of text on map.
inputm
 Latitude and longitude selected by mouse.

Table 1-10 Appearance Control

Function
 Description
axesscale
 Resize axes for equivalent scale.
camtargm
 Camera target from geographic coordinates.
camposm
 Camera position from geographic coordinates.
camupm
 Camera UpVector from geographic coordinates.
daspectm
 Figure DataAspectRatio property for a map.
paperscale
 Figure paper size for a given map scale.
previewmap
 View map at printed size.
rotatetext
 Rotate text to the projected graticule.
tightmap
 Remove whitespace around a map.
trimcart
 Trim graphic objects to the map frame.

Table 1-11 Object Display

Function
 Description
clma
 Clear current map axes.
clmo
 Clear specified map graphics object.
hidem
 Hide specified map graphic objects.
mobjects
 Manipulate object sets displayed on map axes.
showaxes
 Toggle display of Cartesian MATLAB axes.
showm
 Show specified graphic objects.

Table 1-12 Property Manipulation

Function
 Description
cart2grn
 Greenwich coordinates of displayed map object.
getm
 Get map object properties.
handlem
 Handle of displayed map objects.
makemapped
 Make an object a mapped object.
namem
 Names of displayed graphics objects.
restack
 Restacks objects within the axes.
setm
 Set and modify map properties.
tagm
 Assign names to graphics objects using tag property.
zdatam
 Adjust z plane of displayed map objects.

Table 1-13 Geographic Data Structures

Function
 Description
displaym
 Project entries of geographic data structure.
extractm
 Extract vector data from geographic data structure.
mlayers
 Manipulate map layers defined with structure data.

Geographic Computation

Table 1-14 Points

Function
 Description
antipode
 Compute point on opposite side of globe.
azimuth
 Azimuth between two points.
distance
 Distance between two points.
reckon
 Reckoning with starting point, azimuth, and range.
departure
 Departure of longitudes at specific latitudes.

Table 1-15 Lines

Function
 Description
ellipse1
 Ellipse defined by its center, semimajor axes, eccentricity, and azimuth.
scircle1
 Small circle defined by starting point and arc limits.
scircle2
 Small circle defined by its center and perimeter.
scircleg
 Display of small circle defined via mouse input.
tissot
 Tissot indicatrices projected onto map axes.
track
 Connect navigational waypoints with track segments.
track1
 Great circle or rhumb line from point, azimuth, and range.
track2
 Great circle or rhumb line defined by two points.
trackg
 Display of great circle or rhumb line from mouse input.

Table 1-16 Surface Areas

Function
 Description
areaint
 Compute spherical surface area of polygon.
areamat
 Compute geographic area of matrix elements.
areaquad
 Compute spherical area of lat-long quadrangle.

Table 1-17 Geostatistics

Function
 Description
combntns
 Compute all combinations of given set of values.
eqa2grn
 Equal area coordinates to Greenwich coordinates.
filterm
 Geographic filter for data sets.
grn2eqa
 Greenwich coordinates to equal area coordinates.
hista
 Spatial equal area histogram.
histr
 Spatial equirectangular histogram.
meanm
 Mean of geographic points data.
stdm
 Standard deviation of geographic data.
stdist
 Standard distance of geographic data.

Table 1-18 Navigation

Function
 Description
dreckon
 Compute dead reckoning positions for track.
gcwaypts
 Compute equally spaced waypoints along great circle.
legs
 Compute courses and distances between track waypoints.
navfix
 Perform mercator-based navigational fixing.
timezone
 Set time zone description for longitudes.

Data Operations

Table 1-19 Interpolation

Function
 Description
interpm
 Linearly interpolate between latitude and longitude data.
intrplat
 Compute interpolated latitude for given longitude.
intrplon
 Compute interpolated longitude for given latitude.

Table 1-20 Intersections

Function
 Description
crossfix
 Compute cross fix positions for bearings and ranges.
gcxgc
 Compute intersection points of two great circles.
gcxsc
 Compute intersection points of great and small circles.
rhxrh
 Find intersection point between two rhumb lines.
scxsc
 Calculate intersection points for pairs of small circles.

Table 1-21 Trimming and Reducing Map Data

Function
 Description
maptriml
 Trim line vector map to specified region.
maptrimp
 Trim patch map data to specified region.
maptrims
 Trim surface matrix map data to specified region.
reducem
 Reduce number of points in vector data.

Table 1-22 Data Precision

Function
 Description
epsm
 Accuracy of map computations.
roundn
 Round data to specified power of 10.

Matrix Map Data Operations

Table 1-23 Manipulation

Function
 Description
changem
 Substitute codes throughout matrix map.
findm
 Lat/lon values of non-zero map entries.
ltln2val
 Map code value for latitude and longitude point.
maskm
 Mask out specified matrix entries.
resizem
 Resize matrix map.

Table 1-24 Regular Matrix Maps

Function
 Description
country2mtx
 Matrix map for a country in the worldlo database.
encodem
 Fill in indexed maps with specified seeds.
getseeds
 Get seed locations for indexing regular matrix map.
imbedm
 Encode vector data points into regular matrix map.
limitm
 Latitude and longitude limits for regular matrix map.
meshgrat
 Construct map graticule for surface object display.
neworig
 Transform matrix map to new coordinate system origin.
setltln
 Matrix coordinates to Greenwich frame.
setpostn
 Greenwich coordinates to matrix map coordinates.
sizem
 Row and column dimensions for regular matrix map.
vec2mtx
 Regular matrix map from vector data.

Table 1-25 Special Regular Matrix Maps

Function
 Description
nanm
 Full matrix map of NaNs.
spzerom
 Sparse regular matrix map of zeros.
onem
 Full matrix map of ones.
zerom
 Full matrix map of zeros.

Reference Data

Table 1-26 Data Almanac and Atlas Data

Function
 Description
almanac
 Planetary data for solar system, including Sun and Moon.
coast
 World coast lines.
loadcape
 Load Cape Cod digital elevation regular matrix map.
loadmoonalb
 Load moon albedo image into a regular matrix map.
oceanlo
 Ocean mask for worldlo.
usahi
 United States vector data.
usalo
 United States vector data.
usamtx
 United States matrix data.
worldlo
 World vector data for mlayers.
worldmtx
 World matrix map.

Table 1-27 Interface

Function
 Description
grepfields
 Identify matching fields in fixed record length files.
nanclip
 Clip vector data with NaNs at specified pen-down locations.
rc2yx
 Row and column indices to x- and y-coordinates.
readfields
 Reads fields or records from a fixed file format.
readmtx
 Reads a matrix stored in a file.
spcread
 Read ascii file of space delimited data columns.
yx2rc
 x- and y-coordinates to row and column indices.

Geoid Manipulation

Table 1-28 Geoid Parameters

Function
 Description
axes2ecc
 Eccentricity given semimajor and semiminor axes.
ecc2flat
 Flattening given eccentricity.
ecc2n
 Parameter n given eccentricity.
flat2ecc
 Eccentricity given flattening.
majaxis
 Semimajor axis given semiminor axis and eccentricity.
minaxis
 Semiminor axis given semimajor axis and eccentricity.
n2ecc
 Eccentricity given parameter n.
newpole
 Origin vector to place specific point at north pole.
org2pol
 Location of north pole in transformed coordinates.
putpole
 Origin vector given location of north pole.
rcurve
 Various radii of curvature for ellipsoid.
rsphere
 Radii for auxiliary spheres.

Table 1-29 Auxiliary Latitude Conversions

Function
 Description
aut2geod
 Authalic latitude to geodetic latitude.
cen2geod
 Geocentric latitude to geodetic latitude.
cnf2geod
 Conformal latitude to geodetic latitude.
geod2aut
 Geodetic latitude to authalic latitude.
geod2cen
 Geodetic latitude to geocentric latitude.
geod2cnf
 Geodetic latitude to conformal latitude.
geod2iso
 Geodetic latitude to isometric latitude.
geod2par
 Geodetic latitude to parametric latitude.
geod2rec
 Geodetic latitude to rectifying latitude.
iso2geod
 Isometric latitude to geodetic latitude.
par2geod
 Parametric latitude to geodetic latitude.
rec2geod
 Rectifying latitude to geodetic latitude.

Data Conversion

Table 1-30 Angles

Function
 Description
angledim
 Convert angles using recognized units strings.
deg2dm
 Convert angles from degrees to deg:min.
deg2dms
 Convert angles from degrees to deg:min:sec.
deg2rad
 Convert angles from degrees to radians.
dms2deg
 Convert angles from deg:min:sec to degrees.
dms2dm
 Convert angles from deg:min:sec to deg:min.
dms2mat
 Convert dms vector format to [d m s] matrix.
dms2rad
 Convert angles from deg:min:sec to radians.
eastof
 Wraps longitudes to values east of a meridian.
mat2dms
 Convert [d m s] matrix to dms vector format.
npi2pi
 Truncate angles into [-180 180] degrees range.
rad2deg
 Convert angles from radians to degrees.
rad2dm
 Convert angles from radians to deg:min.
rad2dms
 Convert angles from radians to deg:min:sec.
smoothlong
 Removes discontinuities in longitude data.
westof
 Wraps longitudes to values west of a meridian.
zero2pi
 Truncate angles into [0 360] range.

Table 1-31 Time

Function
 Description
hms2hm
 Convert times from hrs:min:sec to hrs:min.
hms2hr
 Convert times from hrs:min:sec to hours.
hms2mat
 Convert hms vector format to [h m s] matrix.
hms2sec
 Convert times from hrs:min:sec to seconds.
hr2hm
 Convert times from hours to hrs:min.
hr2hms
 Convert times from hours to hrs:min:sec.
hr2sec
 Convert times from hours to seconds.
mat2hms
 Convert [h m s] matrix to hms vector format.
sec2hm
 Convert times from seconds to hrs:min.
sec2hms
 Convert times from seconds to hrs:min:sec.
sec2hr
 Convert times from seconds to hours.
timedim
 Convert times using recognized units strings.

Table 1-32 Distance

Function
 Description
deg2km
 Convert distance from degrees to kilometers.
deg2nm
 Convert distance from degrees to nautical miles.
deg2sm
 Convert distance from degrees to statute miles.
distdim
 Convert distances using recognized units strings.
km2deg
 Convert distance from kilometers to degrees.
km2nm
 Convert distance from kilometers to nautical miles.
km2rad
 Convert distance from kilometers to radians.
km2sm
 Convert distance from kilometers to statute miles.
nm2deg
 Convert distance from nautical miles to degrees.
nm2km
 Convert distance from nautical miles to kilometers.
nm2rad
 Convert distance from nautical miles to radians.
nm2sm
 Convert distance from nautical miles to statute miles.
rad2km
 Convert distance from radians to kilometers.
rad2nm
 Convert distance from radians to nautical miles.
rad2sm
 Convert distance from radians to statute miles.
sm2deg
 Convert distance from statute miles to degrees.
sm2km
 Convert distance from statute miles to kilometers.
sm2nm
 Convert distance from statute miles to nautical miles.
sm2rad
 Convert distance from statute miles to radians.

Table 1-33 String Manipulation

Function
 Description
angl2str
 Angle conversion to string.
dist2str
 Distance conversion to string.
time2str
 Time conversion to string.
unitstr
 Test for valid unit strings or abbreviations.

Mapping Toolbox Demos

Function
 Description
orbits
 GUI demonstrating orbit calculations and map interaction.
qrydemo
 Demonstration of linked map queries.
viewmaps
 GUI demonstrating map projections.
vote92
 GUI-based analysis of 1992 presidential election results.
vote96
 GUI-based analysis of 1996 presidential election results.
wrlddemo
 World map display and associated query.


[ Previous | Help Desk | Next ]