function map_con

% MAP_CON Show the help for the functions in this toolbox.

% This file is automatically generated.  Matthew Simoneau, 09-04-98
% Copyright (c) 1984-98 by The MathWorks, Inc. All Rights Reserved
% $Revision: 1.5 $ $Date: 1998/10/16 23:19:20 $

helpwin('map_con/Contents');

function Contents
%MATLAB Tour Partial Function Help:  map_con
%
%Double click on any function for more information
%
%  Mapping Toolbox 
%  Version 1.1 (R11)  04-Sep-1998
% 
%  What's new.
%    map/Readme  - Up-to-date information.
% 
%  Points.
%    antipode    - Compute the point on the opposite side of the globe.
%    azimuth     - Azimuth between two points.
%    distance    - Distance between two points.
%    reckon      - Reckoning from a starting point, with an azimuth and range.
%    departure   - Departure of longitudes at specific latitudes.
% 
%  Lines.
%    ellipse1    - Small ellipse defined by center, orientation and dimensions.
%    scircle1    - Small circle defined by a starting point and range.
%    scircle2    - Small circle defined by center and perimeter points.
%    track       - Connect navigational waypoints with track segments.
%    track1      - Great circle or rhumb line defined by a point and azimuth.
%    track2      - Great circle or rhumb line defined by two points.
% 
%  Surface Areas.
%    areaint     - Calculate the spherical surface area of a polygon.
%    areamat     - Calculate the geographic area of matrix elements.
%    areaquad    - Calculate the area of a lat-long quadrangle.
% 
%  Geo-Statistics.
%    combntns    - Compute all combinations of a given set of values.
%    eqa2grn     - Equal area coordinates to Greenwich coordinates.
%    filterm     - Geographic filter for data sets.
%    grn2eqa     - Greenwich coordinates to equal area coordinates.
%    histr       - Spatial equirectangular histogram.
%    meanm       - Mean of geographic data.
%    stdm        - Standard deviation of geographic data.
%    stdist      - Standard distance of geographic data.
% 
%  Navigation.
%    dreckon     - Compute dead reckoning positions for a track.
%    gcwaypts    - Compute equally spaced waypoints along a great circle.
%    legs        - Provide courses and distances between track waypoints.
%    navfix      - Perform mercator-based navigational fixing.
%    timezone    - Set the time zone description for longitudes.
% 
% 
%  DATA OPERATIONS.
% 
%  Interpolation.
%    interpm     - Linearly interpolates between latitude and longitude data.
%    intrplat    - Compute an interpolated latitude for a given longitude.
%    intrplon    - Compute an interpolated longitude for a given latitude.
% 
%  Intersections.
%    crossfix    - Compute cross fix positions for bearings and ranges.
%    gcxgc       - Compute the intersections between two great circles.
%    gcxsc       - Compute the intersections between a great and small circle.
%    rhxrh       - Find the intersection between two rhumb lines.
%    scxsc       - Calculate intersections for pairs of small circles.
% 
%  Trimming Map Data.
%    maptriml    - Trim line map to a specified region.
%    maptrimp    - Trim patch map data to a specified region.
%    maptrims    - Trim matrix map data to a specified region.
% 
%  Reducing Vector Data.
%    reducem     - Reduce number of points in polygons.
% 
%  Data Precision.
%    epsm        - Accuracy of map computations.
%    roundn      - Round data to specified power of 1.
%  
%  Projecting map data.
%    distortcalc - Calculate distortion parameters for a map projection
%    mfwdtran    - Transform geographic to projected coordinates
%    minvtran    - Transform projected to geographic coordinates
%    vfwdtran    - Transform geographic to projected angles
%    vinvtran    - Transform projected to geographic angles
% 
% 
%  MATRIX MAP DATA OPERATIONS.
% 
%  Manipulation.
%    changem     - Substitute codes throughout a matrix map.
%    findm       - Lat/lon values of non-zero map entries.
%    maskm       - Mask out specified matrix entries.
%    resizem     - Resizes a matrix map.
% 
%  Regular Matrix Maps.
%    country2mtx - Matrix map for a country in the worldlo database
%    encodem     - Fill indexed maps with specified seeds.
%    getseeds    - Get seed locations for indexing a regular matrix map.
%    imbedm      - Encode vector data points into a regular matrix map.
%    limitm      - Latitude and longitude limits for a regular matrix map.
%    ltln2val    - Map code value for a latitude and longitude point.
%    meshgrat    - Construct a map graticule for a surface object display.
%    neworig     - Transformation of matrix map to new coordinate system origin.
%    setltln     - Matrix coordinates to Greenwich frame.
%    setpostn    - Greenwich coordinates to matrix map coordinates.
%    sizem       - Row and column dimension needed for a regular matrix map.
%    vec2mtx	    - Regular matrix map from vector data
% 
%  Special Regular Matrix Maps.
%    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.
% 
% 
%  GEOID MANIPULATION.
% 
%  Geoid Parameters.
%    axes2ecc    - Compute eccentricity given semimajor and semiminor axes.
%    ecc2flat    - Compute flattening given eccentricity.
%    ecc2n       - Compute the ellipse parameter n given eccentricity.
%    flat2ecc    - Compute eccentricity given flattening.
%    majaxis     - Compute semimajor axis given semiminor axis and eccentricity.
%    minaxis     - Compute semiminor axis given semimajor axis and eccentricity.
%    n2ecc       - Compute eccentricity given the ellipse parameter n.
%    newpole     - Compute the origin vector to place a point at the north pole.
%    org2pol     - Compute location of north pole in transformed coordinates.
%    putpole     - Compute the origin vector for a north pole location.
%    rcurve      - Compute various radii of curvature for an ellipsoid.
%    rsphere     - Compute radii for auxiliary spheres.
% 
%  Auxiliary Latitudes.
%    aut2geod     - Convert from authalic latitude to geodetic latitude.
%    cen2geod     - Convert from geocentric latitude to geodetic latitude.
%    cnf2geod     - Convert from conformal latitude to geodetic latitude.
%    geod2aut     - Convert from geodetic latitude to authalic latitude.
%    geod2cen     - Convert from geodetic latitude to geocentric latitude.
%    geod2cnf     - Convert from geodetic latitude to conformal latitude.
%    geod2iso     - Convert from geodetic latitude to isometric latitude.
%    geod2par     - Convert from geodetic latitude to parametric latitude.
%    geod2rec     - Convert from geodetic latitude to rectifying latitude.
%    iso2geod     - Convert from isometric latitude to geodetic latitude.
%    par2geod     - Convert from parametric latitude to geodetic latitude.
%    rec2geod     - Convert from rectifying latitude to geodetic latitude.
% 
% 
%  DATA CONVERSION.
% 
%  Angle Truncation
%    eastof       - Truncate angles to values east of a meridian
%    npi2pi       - Truncate angles into the -180 to 180 degrees range.
%    smoothlong   - Remove discontinuities in longitude data
%    westof       - Truncate angles to values west of a meridian
%    zero22pi     - Truncate angles into the 0 to 360 range.
% 
%  Angle Conversions.
%    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 a [d m s] matrix.
%    dms2rad      - Convert angles from deg:min:sec to radians.
%    mat2dms      - Convert a [d m s] matrix to dms vector format.
%    rad2deg      - Convert angles from radians to degrees.
%    rad2dm       - Convert angles from radians to deg:min.
%    rad2dms      - Convert angles from radians to deg:min:sec.
% 
%  Time.
%    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 a [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 a [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.
% 
%  Distance.
%    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.
% 
%  String Manipulation.
%    angl2str     - Angle conversion to a string.
%    dist2str     - Distance conversion to a string.
%    time2str     - Time conversion to a string.
%    unitstr      - Test for valid unit strings or abbreviations.
% 
%  -------------------------------------------
%
%  Mapping Toolbox Map Definition and Display.
% 
%  Map Creation
%  
%    usamap      - Create a map of the United States of America
%    worldmap    - Maps a country or region using the WORLDLO atlas data
%  
%  Projection Control.
%    axesm       - Map axes definition and property setting.
%    gcm         - Get current map data structure.
%    ismap       - Test if axes have a map definition.
%    ismapped    - Test if an object is projected on a map axes.
%    maps        - List available map projections and verifies id strings.
%    project     - Project a displayed graphics object.
% 
%  Projecting Line Data.
%    contorm     - Project a contour plot of map data.
%    contor3m    - Project a contour plot of map data in 3-D space.
%    contourfm   - Filled contour map. 
%    linem       - Project line objects onto the current map axes.
%    plot3m      - Project lines onto the current map axes in 3-D space.
%    plotm       - Project 2-D lines onto the current map axes.
% 
%  Projecting Patch Data.
%    fill3m      - Project filled 3-D map polygons in 3-D space.
%    fillm       - Project filled 2-D map polygons.
%    patchesm    - Project patches as individual objects.
%    patchm      - Project patch objects onto the current map axes.
% 
%  Projecting 3-D Map Surface and Mesh Data.
%    imagem      - Regular matrix map displayed as an image.
%    meshm       - Regular matrix map warped to a projected graticule mesh.
%    pcolorm     - Projected matrix map in the z = 0 plane.
%    surfacem    - Matrix map warped to a projected graticule mesh.
%    surfm       - Matrix map projected on a map axes.
% 
%  Projecting Light Objects and Lighted Surfaces.
%    lightm      - Project a light source onto the current map.
%    meshlsrm    - Project 3-D lighted shaded relief of regular matrix map.
%    surflm      - 3-D shaded surface with lighting projected on a map axes.
%    surflsrm    - Project 3-D lighted shaded relief of general matrix map.
%    shaderel    - Construct cdata and colormap for colored shaded relief.
% 
%  Thematic Maps.
%    cometm      - Two dimensional comet plot projected on a map axes.
%    comet3m     - Three dimensional comet plot projected on a map axes.
%    quiverm     - Two dimensional quiver plot projected on a map axes.
%    quiver3m    - Three dimensional quiver plot projected on a map axes.
%    stem3m      - Project a stem map onto the current map axes.
%    scatterm    - Construct a thematic map with proportional symbols
% 
%  Map Data Structures.
%    displaym    - Project the entries of a map structure.
%    extractm    - Extract vector data from a map structure.
% 
%  MAP APPLIQUES.
% 
%  Tracks and Circles.
%    scircleg    - Display of a small circle defined via mouse input.
%    trackg      - Display of a great circle or rhumb line by mouse input.
% 
%  General Symbology.
%    mdistort    - Displays contours of constant distortion on a map
%    tissot      - Tissot indicatrices projected onto a map axes.
% 
% 
%  MAP APPEARANCE AND INTERACTION.
% 
%  Annotation.
%    clabelm     - Map contour labeling.
%    clegendm    - Add a legend labels to a map contour plot..
%    framem      - Map frame projected on a map axes.
%    gridm       - Grid lines projected on a map axes.
%    mlabel      - Meridian labels projected on a map axes.
%    plabel      - Parallel labels projected on a map axes.
%    rotatetext  - Rotate text to the projected graticule
%    scaleruler  - Add graphic scale
%    textm       - Text annotation projected onto a map axes.
% 
%  Colormaps.
%    demcmap     - Colormaps for Digital Elevation Data.
%    polcmap     - Colormaps for political maps
% 
%  Interaction.
%    gcpmap      - Get current mouse point from the map.
%    gtextm      - Mouse placement of text on a map.
%    inputm      - Latitude and longitude selected by mouse.
% 
%  Object Display.
%    clma        - Clear current map axes.
%    clmo        - Clear specified graphics object.
%    hidem       - Hide specified graphic objects.
%    showaxes    - Toggle display of cartesian MATLAB axes.
%    showm       - Show specified graphic objects.
%    trimcart    - Trim graphic objects to the map frame
% 
%  Property Manipulation.
%    cart2grn    - Transform from projected cartesian to Greenwich frame.
%    getm        - Get map object properties.
%    handlem     - Handles of displayed map objects.
%    makemapped  - Make an object a mapped object
%    namem       - Determine the names for valid graphics objects.
%    restack     - Restacks objects within the axes
%    setm        - Set and modify properties of a map.
%    tagm        - Assign a name to a graphics object using the tag property.
%    zdatam      - Adjust the z plane of displayed map objects.
% 
%  Axes and Figure Properties
% 
%    axesscale   - Resize axes for equivalent scale 
%    camposm     - Axes camera position from geographic coordinates
%    camtargm    - Axes camera target from geographic coordinates
%    camupm      - Axes camera up vector from geographic coordinates
%    daspectm    - Figure DataAspectRatio for a map 
%    paperscale  - Figure paper size for a given map scale
%    previewmap  - View map at printed size
%    tightmap    - Remove white space around a map
% 
% 
%  GRAPHICAL USER INTERFACES.
% 
%  Task GUIs.
%    axesmui     - Interactive definition of map axes properties.
%    colorm      - Create index map colormaps.
%    maptrim     - Customize map data sets.
%    maptool     - Map window with menu activated tools.
%    originui    - Interactive modification of map origin.
%    panzoom     - Pan and zoom on a 2D plot.
%    parallelui  - Interactive modification of map parallels
%    qrydata     - Create queries associated with map axes.
%    uimaptbx    - Mapping Toolbox object callbacks.
%    trackui     - Interactive great circle and rhumb line tracks.
%    scirclui    - Interactive small circles.
%    seedm       - Seed regular matrix maps.
%    surfdist    - Interactive surface distance measurements.
% 
% 
%  Tool GUIs.
%    mlayers     - Manipulate map layers defined with structure data.
%    mobjects    - Manipulate object sets displayed on an axes.
%    rootlayr    - Construct mlayer cell array input for user workspace.
% 
% 
%  General Tools.
%    clrmenu     - Version of colormenu which works with userdata slots.
% 
% 
%  MAPPING TOOLBOX REFERENCE DATA.
% 
%  Atlas Data Mat-files.
%    coast       - World coastlines.
%    geoid       - World geoid matrix.
%    oceanlo     - Ocean mask patches.
%    topo        - World elevation/bathymettry matrix.
%    usahi       - United States Vector Data.
%    usalo       - United States Vector Data.
%    usamtx      - United States Matrix Data.
%    worldlo     - World vector data.
%    worldmtx    - World Matrix Map.
% 
%  Atlas Data Functions
%    coast       - World coast lines.
%    usahi       - United States vector data.
%    usalo       - United States vector data.
%    worldlo     - World vector data.
% 
%  Atlas Data Script.
%    loadcape    - load cape-cod elevation image as regular matrix map.
%    loadmoonalb - Load moon albedo image into a regular matrix map
% 
%  Interface.
%    grepfields  - Identify matching records 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 format file.
%    readmtx     - Read a matrix stored in a file.
%    spcread     - Read an ascii file of space delimited data columns.
%    yx2rc       - X and Y coordinates to row and column indices
% 
%  Public Data Interfaces.
%    avhrrgoode  - Read AVHRR data stored in the Goode Projection.
%    avhrrlambert- Read AVHRR data stored in the Lambert Projection.
%    dcwdata     - Extract selected data from the Digital Chart of the World.
%    dcwgaz      - Search names in the Digital Chart of the World Gazette.
%    dcwhread    - Read the Digital Chart of the World file headers.
%    dcwread     - Read a Digital Chart of the World file.
%    dted        - Read U.S. Department of Defense Digital Terrain Elevation 
%                    Data (DTED) data.
%    egm96geoid  - Read 15-minute gridded geoid heights from the 
%                    EGM96 geoid model.
%    etopo5      - Import a regular matrix map from the ETOPO5 DEM.
%    fipsname    - Import TIGER thinned boundary file FIPS names.
%    gshhs       - Read Global Self-consistent Hierarchical 
%                    High-resolution Shoreline data.
%    gtopo30     - Import GTOPO30 Global Digital Elevation Map.
%    readfk5     - Import Fifth Fundamental Catalog of Stars.
%    satbath     - Read Global 2-minute (4 km) topography from satellite 
%                    bathymetry.
%    tbase       - Import TerrainBase Global 5-Min digital terrain data
%    tgrline     - Import data from TIGER/Line files.
%    tigermif    - Import TIGER MIF thinned boundary file (MapInfo Interchange).
%    tigerp      - Import TIGER p and pa thinned boundary file (ArcInfo format).
%    usgs24kdem  - Read USGS 1:24,000 (30 m) digital elevation maps.
%    usgsdem     - Import elevation data from USGS 1:250,000 DEM files.
%    usgsdems    - Names of USGS 1:250,000 DEM files.
%    vmap0data   - Extract selected data from the Vector Map Level 0 CD-ROMs.
%    vmap0read   - Read a Vector Map Level 0 file.
%    vmap0rhead  - Read the Vector Map Level 0 file headers.
%    vmapphead   - Parse the Vector Map Level 0 header string.
% 
%  Data Almanac.
%    almanac     - Almanac data for the Solar System.
% 
% 
%  MAPPING TOOLBOX DEMOS.
% 
%    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    - Displays a world map and an associated query.
% 
%  -------------------------------------------
%
%  Mapping Toolbox Projections.
% 
%  Cylindrical Projections.
%    balthsrt    - Balthasart Projection.
%    behrmann    - Behrmann Projection.
%    bsam        - Bolshoi Sovietskii Atlas Mira Projection.
%    braun       - Braun Perspective Projection.
%    cassini     - Cassini Projection.
%    ccylin      - Central Cylindrical Projection.
%    eqacylin    - Equal Area Projection.
%    eqdcylin    - Equidistant Projection.
%    giso        - Gall Isographic Projection.
%    gortho      - Gall Orthographic Projection.
%    gstereo     - Gall Stereographic Projection.
%    lambcyln    - Lambert Projection.
%    mercator    - Mercator Projection.
%    miller      - Miller Projection.
%    pcarree     - Plate Carree Projection.
%    trystan     - Trystan Edwards Projection.
%    utm         - Universal Transverse Mercator Projection
%    wetch       - Wetch Projection.
% 
%  Pseudocylindrical Projections.
%    apianus     - Apianus II Projection.
%    collig      - Collignon Projection.
%    craster     - Craster Parabolic Projection.
%    eckert1     - Eckert I Projection.
%    eckert2     - Eckert II  Projection.
%    eckert3     - Eckert III Projection.
%    eckert4     - Eckert IV Projection.
%    eckert5     - Eckert V Projection.
%    eckert6     - Eckert VI Projection.
%    flatplrp    - Flat-Polar Parabolic Projection.
%    flatplrq    - Flat-Polar Quartic Projection.
%    flatplrs    - Flat-Polar Sinusoidal Projection.
%    fournier    - Fournier Projection.
%    goode       - Goode Homolosine Projection.
%    hatano      - Hatano Assymmetrical Equal Area Projection.
%    kavrsky5    - Kavraisky V Projection.
%    kavrsky6    - Kavraisky VI Projection.
%    loximuth    - Loximuthal Projection.
%    modsine     - Modified Sinusoidal Projection.
%    mollweid    - Mollweide Projection.
%    putnins5    - Putnins P5 Projection.
%    quartic     - Quartic Authalic Projection.
%    robinson    - Robinson Projection.
%    sinusoid    - Sinusoidal Projection.
%    wagner4     - Wagner IV Projection.
%    winkel      - Winkel I Projection.
% 
%  Conic Projections.
%    eqaconic    - Albers Equal Area Conic Projection.
%    eqdconic    - Equidistant Conic Projection.
%    lambert     - Lambert Conformal Conic Projection.
%    murdoch1    - Murdoch I Conic Projection.
%    murdoch3    - Murdoch III Minimum Error Conic Projection.
% .
%  Polyconic and Pseudoconic Projections.
%    bonne       - Bonne Projection.
%    polycon     - Polyconic Projection.
%    vgrint      - Van Der Grinten I Projection.
%    werner      - Werner Projection.
% 
%  Azimuthal, Pseudoazimuthal and Modified Azimuthal Projections.
%    aitoff      - Aitoff Projection
%    breusing    - Breusing Harmonic Mean Projection.
%    bries       - Briesemeister's Projection
%    eqaazim     - Lambert Equal Area Azimuthal Projection.
%    eqdazim     - Equidistant Azimuthal Projection.
%    globe       - Globe display.
%    gnomonic    - Gnomonic Azimuthal Projection.
%    hammer      - Hammer Projection
%    ortho       - Orthographic Azimuthal Projection.
%    stereo      - Stereographic Azimuthal Projection.
%    ups         - Universal Polar Stereographic Projection
%    vperspec    - Vertical Perspective Azimuthal Projection
%    wiechel     - Weichel Equal Area Projection.
% 
%  PROJECTION-SPECIFIC PROPERTIES.
%    utmgeoid    - Recommended geoids for UTM zone
%    utmzone     - Universal Transverse Mercator zone
% 
%  

function map_Readme
%MATLAB Tour Partial Function Help:  map_con
%
%  RELEASE NOTES FOR THE MAPPING TOOLBOX 1.1
% 
%  Version 1.1 of the Mapping Toolbox includes a number of important new 
%  features.  You can now create base maps using world or U.S. atlas data with 
%  a minimum of effort.  New projections include the Universal Transverse 
%  Mercator (UTM), the Universal Polar Stereographic, Hammer-Aitoff and 
%  vertical perspective.  Filled contour maps are now supported.  You can now 
%  annotate your maps with a graphic scale.  Data interfaces to many important 
%  sources of high resolution data have been added: VMAP0, DTED, GSHHS, the 
%  EGM96 geoid, 1:24,000 USGS DEMs, AVHRR data and Smith and Sandwell's 
%  satellite bathymetry.  See the lists of new functions below for more 
%  details.  Complete documentation on the new features is also provided in 
%  electronic form as PDF and HTML documents.  You can access them through the 
%  HELPDESK function.
%  
% 
%  --------------------------------------------------------------------------
%  
%  USING MATLAB PLOT EDITING WITH MAP DISPLAYS
%  
%  MATLAB now includes a set of plot editing tools which partially overlap the 
%  capabilities and function of Mapping Toolbox click and drag tools.  If you 
%  find that the plotedit tools interfere with the Mapping Toolbox Click and 
%  Drag tools, you can disable the former with
%  
%    PLOTEDIT OFF
%  
%  When both sets of tools are available, the Matlab plot editing tools may 
%  mask the Mapping Toolbox tools.  This occurs when the selection arrow 
%  button is depressed in the plotedit toolbar.  To use the Mapping Toolbox 
%  tools, deselect the left arrow button.
%  
%  Annotation added using the plotedit tools may sometimes shift noticeably 
%  upon printing.  To prevent such shifts, complete the following steps before 
%  adding any plotedit annotation: Any changes to the printed size of the 
%  display using ORIENT, the PAPERPOSITION property or PAPERSCALE. Any changes 
%  to the size of the axes using ZOOM, PANZOOM, AXESSCALE or the POSITION 
%  property. Then use PREVIEWMAP to resize the figure to the printed size.  
%  Plotedit elements added after this point should print and display correctly.
%  
%  -----------------------------------------------------------------------
%  CHANGES SINCE VERSION 1.0.1
%  
%  HANDLEM now allows several kinds of substring searches to match displayed 
%  objects.  This is useful when changing objects as a group based on a 
%  substring.  For example, when the tags of displayed objects are 'Primary 
%  Road','Secondary Road' and 'Railroad', you can color all roads red with the 
%  command
%  
%    set(handlem('Road',gca,'findstr'),'color','r')
% 
%  
%  EXTRACTM and DISPLAYM also provide search methods.  These allows more 
%  control over the selective extraction or display of geographic data 
%  structures.
%  
%  CONTORM and CONTOR3 now accept regular matrix maps as inputs.
%  
%  CLABELM now creates inline labels.
%  
%  MAPTOOL no longer automatically creates a new figure.  You can now decide 
%  to add the maptool menus and buttons to a map figure at any time.
%  
%  USGSDEM also returns the file header information as a structure.
%  
%  ------------------------------------------------------------------------
%  
%  NEW MAP PROPERTIES WITH THE MAPPING TOOLBOX 1.1
%  
%  Version 1.1 introduces a number of new map properties that support the UTM 
%  and UPS projections, add some common parameters in projection 
%  transformations, and enhance the appearance of non-cylindrical projections.
%  
%    FalseEasting  A translation of projected coordinates
%    FalseNorthing A translation of projected coordinates
%    LabelRotation Aligns meridian and parallel labels to parallels
%    ScaleFactor   A scaling of projected coordinates
%    Zone          Defines a part of a UTM or UPS projection
%  
%  --------------------------------------------------------------------------
%  
%  NEW FUNCTIONS FOR THE MAPPING TOOLBOX 1.1
%  
%  Map Definition And Display
%  
%    usamap    Create a map of the United States of America
%    worldmap  Maps a country or region using the WORLDLO atlas data
%  
%  
%  Projection Calculations
%  
%    distortcalc Calculates distortion parameters for a map projection
%    utmgeoid    Recommended geoids for UTM zone
%    utmzone     Universal Transverse Mercator zone
%  
%  
%  Projecting Patch Data
%  
%    contourfm   Filled contour map. 
%  
%  
%  Map Annotation
%  
%    polcmap    Colormap for political maps
%    mdistort   Displays contours of constant distortion on a map
%    scaleruler Add graphic scale
%  
%  
%  Appearance Control
%  
%    axesscale   Resize axes for equivalent scale 
%    previewmap  View map at printed size
%    rotatetext  Rotate text to the projected graticule
%    tightmap    Remove white space around a map
%    trimcart    Trim graphic objects to the map frame
%  
%  
%  Graphical User Interfaces
%  
%    parallelui  Tool for interactively modifying map parallels
%  
%  
%  
%  Property Manipulation
%  
%    makemapped  Make an object a mapped object
%    restack     Restacks objects within the axes
%  
%  
%  Regular Matrix Maps
%  
%    country2mtx Matrix map for a country in the worldlo database
%    vec2mtx     Regular matrix map from vector data
%  
%  
%  Atlas Data
%  
%    coast       World coast lines(function and Mat-file).
%    loadmoonalb Load moon albedo image into a regular matrix map
%    usahi       United States vector data (function and Mat-file).
%    usalo       United States vector data (function and Mat-file).
%    worldlo     World vector data for mlayers (function and Mat-file).
%  
%  
%  Interface
%  
%    grepfields  Identify matching fields in fixed record length files
%    rc2yx       Row and column indices to x and y coordinates
%    readfields  Reads fields or records from a fixed format file.
%    readmtx     Read a matrix stored in a file.
%    yx2rc       X and Y coordinates to row and column indices
%  
%  
%  Angle Conversions
%  
%    eastof      Wraps longitudes to values east of a meridian
%    smoothlong  Remove discontinuities in longitude data
%    westof      Wraps longitudes to values west of a meridian
%  
%  
%  External Data Interface
%  
%    avhrrgoode   Read AVHRR data stored in the Goode Projection.
%    avhrrlambert Read AVHRR data stored in the LAMBERT Projection.
%    dted         Read U.S. Department of Defense Digital 
%                   Terrain Elevation Data (DTED) data.
%    egm96geoid   Read 15-minute gridded geoid heights from 
%                   the EGM96 geoid model.
%    gshhs        Read Global Self-consistent Hierarchical 
%                   High-resolution Shoreline data.
%    satbath      Read Global 2-minute (4 km) topography from 
%                   satellite bathymetry.
%    usgs24kdem   Read USGS 1:24,000 (30 m) digital elevation maps.
%    vmap0data    Extract selected data from the Vector Map Level 0 CD-ROMs.
%    vmapphead    Parse the Vector Map Level 0 header string.
%    vmap0read    Read a Vector Map Level 0 file.
%    vmap0rhead   Read the Vector Map Level 0 file headers.
%  
%  
%  Projections
%  
%    aitoff       Aitoff Projection
%    bries        Briesemeister's Projection
%    hammer       Hammer Projection
%    ups          Universal Polar Stereographic Projection
%    vperspec     Vertical Perspective Azimuthal Projection
%    utm          Universal Transverse Mercator Cylindrical Projection
%  
%  
% 
%  **************************************************************************
%  New functions for The Mapping Toolbox 1.0.1
%  
%  Lines.
%    ellipse1     Small ellipse defined by center, orientation and dimensions.
%  
%  
%  Axes and Figure Properties
%  
%    camposm      Axes camera position from geographic coordinates
%    camtargm     Axes camera target from geographic coordinates
%    camupm       Axes camera up vector from geographic coordinates
%    daspectm     Figure DataAspectRatio for a map 
%    paperscale   Figure paper size for a given map scale
%    
%  Projecting map data.
%    vfwdtran     Transform geographic to projected angles
%    vinvtran     Transform projected to geographic angles
%  
%  Atlas Data Mat-files.
%    oceanlo      Ocean mask patches.
%  
%  ******************************************************************************* 
%   Release Notes for The Mapping Toolbox Version 1.0.1
%  
%  
%  NEW FEATURES FOR VERSION 1.0.1
%  
%   PRINTING AT A PARTICULAR SCALE
%  
%   You can now control the scale at which maps are printed using the new
%   PAPERSCALE function. The scale is specified as a ratio of paper and 
%   geographic lengths such as 1:1,000,000, or by the relative lengths 
%   themselves (1 inch = 1 mile). This function sets the figure PaperPosition
%   property to values that are correct for the current projection and data, 
%   so you should use it just before printing. If you modify your map in a 
%   way that changes mapped region or change the projection, you should execute
%   PAPERSCALE again.
%  
%   You may want to minimize the amount of memory required by zbuffer to render
%   the map by making the map fill the figure. Use the command 
%  
%       set(gca,'Position',[0 0 1 1])
%  
%   to make the axes fill the figure.  To make the map fill the axes, use
%  
%       axis tight. 
%  
%   You can undo the axis command with "axis auto". The panzoom tool will also 
%   allow you to tighten up the display.
%  
%       panzoom; panzoom setlimits  % to set and lock a 2-d view
%       panzoom fullview            % to undo
%  
%  
%   DATA ASPECT RATIO
%  
%   You can now control the amount of vertical exaggeration in elevation data.
%   The DASPECTM function will allow you show the vertical dimension at the 
%   same scale as the horizontal ones, or to show elevations at a specified 
%   vertical exaggeration factor, such as 30 times actual. DASPECTM sets
%   the axes DataAspectRatio property based on numerical estimates of the
%   scale of the projection at a point. If you change the projection, you 
%   should execute DASPECTM again. DASPECTM is a geographic analog to the
%   new Matlab DASPECT function.
%  
%   GEOGRAPHIC CAMERA CONTROL
%  
%   CAMTARGM, CAMPOSM and CAMUPM allow you to set your viewpoint, position and 
%   local vertical within the figure based on geographic coordinates. You can, 
%   for example, look at a point at ground level in the city of Jerusalem from a
%   point 500 miles above Malta. These functions are most useful when working 
%   with the three-dimensional globe projection.They are geographic analogs of
%   the new Matlab CAMTARGET, CAMPOS and CAMUP functions. You may need to 
%   control the camera view angle with the CAMVA function to get the results you
%   expect.
%  
%   ELLIPSES
%  
%   There is now an ellipse function ELLIPSE1 similar to the circle function
%   SCIRCLE1. It computes points of an ellipse on the spheroid, which is defined
%   by its center, semimajor axes, eccentricity and azimuth. 
%  
%   ANGLE PROJECTION
%  
%   The transformation between directions on the spheroid and directions in
%   the projected coordinates can now be computed with VFWDTRAN AND VINVTRAN
%   functions. These are analogous the low-level MFWDTRAN and MINVTRAN 
%   functions, but instead of transforming positions, they transform vector 
%   directions. The transformations are computed numerically by taking small 
%   steps away from the starting positions and measuring the angles of the 
%   vector.
%   
%  
%   OCEAN MASK
%  
%   There is now a set of ocean patches complement the coast and worldlo atlas
%   data in the oceanlo mat-file.  It contains a geographic data structure with 
%   patches for ocean areas, and nothing for land. Islands within ocean areas 
%   are connected to the edges of the patches by means of cuts in the patch. 
%   This allows the patches to be used to mask out ocean areas, while still 
%   allowing underlying island areas to show through. The coastlines are the 
%   same as those used in the worldlo database. The worldlo land patches and the
%   oceanlo sea patches should meet with no gaps.
%  
%   
%  
%  CHANGES SINCE VERSION 1.0
%  
%  
%    DISTDIM and UNITSTR - Now recognize meters and feet as valid distance units
%  
%    DCWDEM - The external data described as the DCW-DEM has been completed and
%    repackaged under the name "gtopo30". The DCWDEM function has therefore
%    been replaced by the otherwise similar GTOPO30 function.
%    
%    The characteristics, data quality and sources  of the data are described at
%  
%          http://edcwww.cr.usgs.gov/landdaac/gtopo30/README.html .
%  
%    The data is available over the internet from
%    
%          ftp://edcftp.cr.usgs.gov/pub/data/gtopo30/global.
%  
%  
%   DISPLAYM - Now allows data to be selectively displayed. Previously this
%   would have required use of EXTRACTM to find the indices of the desired 
%   data.
%  
%  
%  
%  TIPS 
%  
%   WORKING WITH THE GLOBE PROJECTION
%  
%    Unlike all other projections in the Mapping Toolbox, the globe is
%    three-dimensional. Unless you are displaying global matrix maps, you
%    may need to add a surface to hide the side of the earth facing away
%    from the figure's camera. The following example show how to do that, and
%    also introduces some useful techniques in working with the globe.
%  
%       axesm('MapProjection','globe','galt',0,'grid','on')
%  
%       load worldlo                        % display lines; 
%       displaym(POline)
%  
%       set(gcf,'renderer','z')             % generally faster
%  
%       sphere(100)                         % to hide the back of the earth
%       h = handlem('surface');
%       set(h,'edgecolor','none','facecolor','w','tag','sphere')
%       set(gca,'color',[.9 .9 .9])
%  
%  
%       [lat,lon] = extractm(gazette,'jerusalem');   % use camera functions
%       camtargm(lat,lon,0)                          % to look at surface
%       camupm(lat,lon)                              % local vertical is up
%       [lat,lon] = extractm(gazette,'cyprus');
%       camposm(lat,lon,200/6371)                    % altitude is in radians
%       camva(10)                                    % focus in on target
%  
%  
%    MAKING A MAP THAT CROSSES THE DATELINE
%  
%    The origin property of the map axes is used to specify the center of the  
%    map. To put the dateline in the center of the map, set the origin to 
%    [0 180].
%    
%       axesm('miller','origin',[0 -180])
%       framem
%    
%       load coast
%       plotm(lat,long)
%    
%       setm(gca,'flonlim',[-90 90]) % use the frame limits to trim off data  
%                                    % relative to the center of the map
%  
%    CONVERTING BETWEEN LAT-LONG AND EARTH-CENTERED CARTESIAN COORDINATES  
%  
%    You can use mfwdtran and minvtran with the globe projection to go back 
%    and forth between (latitude,longitude,altitude) and earth-centered  
%    (x,y,z).  Altitude should be normalized by the earth's radius, i.e.  
%    the altitude should be in radians.
%  
%  **********************************************************************
%  
%  Release Notes for The Mapping Toolbox Version 1.0
%  
%  COMPLEX DATA - The Mapping Toolbox has been designed to work with REAL data.
%  There are some numerical operations when working with Map projections which
%  on certain platforms can generate COMPLEX data.  The Mapping Toolbox performs
%  an internal COMPLEX data check in (angledim and reckon) and converts data 
%  back to REAL automatically for the user.  Note, no warnings are generated.
%  
%  FRAMELIMITS and MAPLIMITS Interaction - When working with lower level 
%  map graphics commands (setm), and the maptool and axesmui, to position
%  and project a particular region it might be useful to keep the following
%  in mind.  
%  
%  The origin is a part of the projection and based on the latitude
%  setting of the origin the following interaction exists.
%  
%  (a) Normal Aspect (origin latitude = 0) - FRAME and MAP limits interact
%      and are coupled together.  It is recommended that whichever set of
%      limits are not explicitly set, should be cleared (GUIs) or left empty
%      if specified from the command line ('maplatlimit',[],'maplonlimit',[]).  
%  
%  (b) Oblique Aspect (origin latitude ~= 0) - If the origin rotates the globe 
%      about a second axis, the map is oblique.  In this case the MAP and FRAME 
%      limits are no longer coupled, and the extent of the map display is 
%      controlled by the FRAME limits. The MAP limits then control just the 
%      extent of the grid. Oblique projections are sometimes difficult to 
%      interpret because the meridian and parallel grid lines follow complex 
%      curves. 
%  
%  DIRECTORY STRUCTURE - The Mapping Toolbox functions are divided into 3 
%  directories within the toolbox/map directory: map, mapdisp, and mapproj. 
%  These directories contain the following:
%  
%    map     - Contains functions for unit conversion, and other map calculation
%              utilities.
%  
%    mapdisp - Contains functions for map display options.
%  
%    mapproj - Contains map projection functions.
%  
%  KNOWN PROBLEMS
%  
%  Zoom - The inability of MATLAB to distinguish a double mouse click from a
%  single mouse click could create problems when trying to exit a zoom function
%  (panzoom or zoom button inside of maptool).  To return to the full map 
%  display from maptool use the menu selection [tool:full view], and from 
%  panzoom, issue the commands:                                
%   >> panzoom out   
%  or 
%   >> panzoom fullview               
%  
%  Originui - On the PC platform, originui can cause a segmentation fault or
%  stack overflow, when the origin is shifted numerous times using keyboard
%  inputs.  Please use caution when using originui on the PC platform.

function antipode
%MATLAB Tour Partial Function Help:  map_con
%
% ANTIPODE  Computes the point on the opposite side of the globe
% 
%   [lat,long] = ANTIPODE(lat0,long0) returns the antipodal point
%   for the input lat0, long0.  The antipodal point is the point
%   exactly opposite the input point on the other side of the sphere.
% 
%   [lat,long] = ANTIPODE(lat0,long0,'units') uses the input string
%   'units' to define the angle units of the input and output points.
%   If omitted, 'degrees' are assumed.

function azimuth
%MATLAB Tour Partial Function Help:  map_con
%
% AZIMUTH  Calculates azimuth between points on a geoid
% 
%   az = AZIMUTH(lat1,lon1,lat2,lon2) computes the great circle
%   bearing between the two points on the globe.  The inputs
%   can be matrices of equal size.  The azimuth is reported from
%   0 to 360 degrees, clockwise from north, by convention.
% 
%   az = AZIMUTH(lat1,lon1,lat2,lon2,geoid) computes the great circle
%   bearing assuming that the points lie on the ellipsoid defined by
%   the input geoid.  The geoid vector is of the form
%   [semimajor axes, eccentricity].  If omitted, the unit sphere,
%   geoid = [1 0], is assumed.
% 
%   az = AZIMUTH(lat1,lon1,lat2,lon2,'units') uses the input string 'units'
%   to define the angle units of the input and output data.  If
%   'units' is omitted, 'degrees' are assumed.
% 
%   az = AZIMUTH(lat1,lon1,lat2,lon2,geoid,'units') is a valid calling form.
% 
%   az = AZIMUTH('track',...) uses the input string 'track' to define
%   either a great circle bearing or rhumb line heading.  If 'track' = 'gc',
%   then the great circle bearings are computed.  If 'track' = 'rh', then
%   the rhumb line headings are computed.  If omitted, 'gc' is assumed.
% 
%   az = AZIMUTH(pt1,pt2) uses the input form pt1 = [lat1 lon1] and
%   pt2 = [lat2 lon2], where lat1, lon1, lat2 and lon2 are column vectors.
% 
%   az = AZIMUTH(pt1,pt2,geoid), az = AZIMUTH(pt1,pt2,'units'),
%   az = AZIMUTH(pt1,pt2,geoid,'units') and az = AZIMUTH('track',pt1,...)
%   are all valid calling forms.
% 
%   

function distance
%MATLAB Tour Partial Function Help:  map_con
%
% DISTANCE  Calculates distances between points on a geoid
% 
%   rng = DISTANCE(lat1,lon1,lat2,lon2) computes the great circle
%   distance between the two points on the globe.  The inputs
%   can be matrices of equal size.  The distance is reported as
%   degrees of arc length on a sphere.
% 
%   rng = DISTANCE(lat1,lon1,lat2,lon2,geoid) computes the great circle
%   distance assuming that the points lie on the ellipsoid defined by
%   the input geoid.  The geoid vector is of the form
%   [semimajor axes, eccentricity].  The output range is reported in
%   the same distance units as the semimajor axes of the geoid vector.
% 
%   rng = DISTANCE(lat1,lon1,lat2,lon2,'units') uses the input string 'units'
%   to define the angle units of the input and output data.  If
%   'units' is omitted, 'degrees' are assumed.
% 
%   rng = DISTANCE(lat1,lon1,lat2,lon2,geoid,'units') is a valid calling
%   form.  In this case, the output range is in the same units as
%   the semimajor axes of the geoid vector.
% 
%   rng = DISTANCE('track',...) uses the input string 'track' to define
%   either a great circle or rhumb line distance calculation.  If
%   'track' = 'gc', then the great circle distances are computed.
%   If 'track' = 'rh', then the rhumb line distances are computed.
%   If omitted, 'gc' is assumed.
% 
%   rng = DISTANCE(pt1,pt2) uses the input form pt1 = [lat1 lon1] and
%   pt2 = [lat2 lon2], where lat1, lon1, lat2 and lon2 are column vectors.
% 
%   rng = DISTANCE(pt1,pt2,geoid), rng = DISTANCE(pt1,pt2,'units'),
%   rng = DISTANCE(pt1,pt2,geoid,'units') and rng = DISTANCE('track',pt1,...)
%   are all valid calling forms.
% 
%   

function reckon
%MATLAB Tour Partial Function Help:  map_con
%
% RECKON  Computes points at a specified azimuth and range
% 
%   [lat,lon] = RECKON(lat0,lon0,rng,az) computes the latitude and
%   longitude positions for selected ranges and azimuths from a
%   starting point along a great circle path on a globe.  The range
%   is input as degrees of arc length on a sphere.  The input
%   azimuth is measured clockwise from due north.
% 
%   [lat,lon] = RECKON(lat0,lon0,rng,az,geoid) computes the new point
%   assuming that the great circle points lie on the ellipsoid defined by
%   the input geoid.  The geoid vector is of the form
%   [semimajor axes, eccentricity].
% 
%   [lat,lon] = RECKON(lat0,lon0,rng,az,'units') uses the input string 'units'
%   to define the angle units of the input and output data.  In this
%   form, the input range is measured as an arc length in the units
%   specified by 'units'.  If 'units' is omitted, 'degrees' are assumed.
% 
%   [lat,lon] = RECKON(lat0,lon0,rng,az,geoid,'units') is a valid calling
%   form.  In this case, the input range is in the same units as
%   the semimajor axes of the geoid vector.
% 
%   [lat,lon] = RECKON('track',...) uses the input string 'track' to define
%   either a great circle or rhumb line reckon calculation.  If
%   'track' = 'gc', then the new point is computed to along a great
%   circle track.  If 'track' = 'rh', then the new point is computed
%   along a rhumb line track.  If omitted, 'gc' is assumed.
% 
%   

function departure
%MATLAB Tour Partial Function Help:  map_con
%
% DEPARTURE  Departure of longitudes at specific latitudes
% 
%   d = DEPARTURE(long1,long2,lat) computes the departure distance from
%   long1 to long2 at the input latitude lat.  Departure is the
%   distance along a specific parallel between two meridians.  The
%   output d is returned in degrees of arc length on a sphere.
% 
%   d = DEPARTURE(long1,long2,lat,geoid) computes the departure
%   assuming that the input points lie on the ellipsoid defined by
%   the input geoid.  The geoid vector is of the form
%   [semimajor axes, eccentricity].
% 
%   d = DEPARTURE(long1,long2,lat,'units') uses the input string 'units'
%   to define the angle units of the input and output data.  In this
%   form, the departure is returned as an arc length in the units
%   specified by 'units'.  If 'units' is omitted, 'degrees' are assumed.
% 
%   d = DEPARTURE(long1,long2,lat,geoid,'units') is a valid calling
%   form.  In this case, the departure is computed in the same units as
%   the semimajor axes of the geoid vector.
% 
%   

function ellipse1
%MATLAB Tour Partial Function Help:  map_con
%
% ELLIPSE1  Ellipse defined by its center, semimajor axes, eccentricity and azimuth
% 
%   [lat,lon] = ELLIPSE1(lat0,lon0,ellipse) computes ellipses with a
%   center at the point lat0, lon0.  The ellipse is defined by the
%   third input which of the form [semimajor axis, eccentricity].  
%   The lat, lon inputs can be scalar or column vectors.  The eccentricity
%   input can be a 2 element row vector or a 2 column matrix.  The
%   ellipse input must have the same number of rows as the input lat and lon.
%   The input semimajor axes is in degrees of arc length on a sphere.  All
%   ellipses are oriented so that their semimajor axes lies due north.
% 
%   [lat,lon] = ELLIPSE1(lat0,lon0,ellipse,offset) computes the ellipses
%   where the semimajor axis is rotated from due north by an azimuth offset.
%   The offset angle is measure clockwise from due north.  If offset =[],
%   then no offset is assumed.
% 
%   [lat,lon] = ELLIPSE1(lat0,lon0,ellipse,offset,az) uses the input az 
%   to define the ellipse arcs computed.  The arc azimuths are measured
%   clockwise from due north.  If az is a column vector, then the
%   arc length is computed from due north.  If az is a two column
%   matrix, then the ellipse arcs are computed starting at the
%   azimuth in the first column and ending at the azimuth in the
%   second column.  If az = [], then a complete ellipse is computed.
% 
%   [lat,lon] = ELLIPSE1(lat0,lon0,ellipse,offset,az,geoid) computes
%   the ellipse on the ellipsoid defined by the input geoid. The geoid vector
%   is of the form [semimajor axes, eccentricity].  If omitted, the
%   unit sphere, geoid = [1 0], is assumed.  When a geoid is supplied
%   the input semimajor axis must be in the same units as the geoid
%   semimajor axes. In this calling form, the units of the ellipse 
%   semi-major axis are not assumed to be in degrees.
% 
%   [lat,lon] = ELLIPSE1(lat0,lon0,ellipse,offset,'units'),
%   [lat,lon] = ELLIPSE1(lat0,lon0,ellipse,offset,az,'units'), and
%   [lat,lon] = ELLIPSE1(lat0,lon0,ellipse,offset,az,geoid,'units') are
%   all valid calling forms, which use the inputs 'units' to define 
%   the angle units of the inputs and outputs.  If omitted, 
%   'degrees' are assumed.
% 
%   [lat,lon] = ELLIPSE1(lat0,lon0,ellipse,offset,az,geoid,'units',npts)
%   uses the input npts to determine the number of points per ellipse
%   computed.  The input npts is a scalar, and if omitted, npts = 100.
% 
%   [lat,lon] = ELLIPSE1('track',...) uses the 'track' string to define
%   either a great circle or rhumb line distances from the ellipse center.
%   If 'track' = 'gc',  then great circle distances are computed.  
%   If 'track' = 'rh', then rhumb line distances are computed.
%   If omitted, 'gc' is assumed.
% 
%   mat = ELLIPSE1(...) returns a single output argument where
%   mat = [lat lon].  This is useful if only an ellipse is computed.
% 
%   Multiple circles can be defined from a single starting point by
%   providing scalar lat0, lon0 inputs and a 2 column matrix for
%   the ellipse definitions.
% 
%   

function scircle1
%MATLAB Tour Partial Function Help:  map_con
%
% SCIRCLE1  Small circle defined by its center, range and azimuth
% 
%   [lat,lon] = SCIRCLE1(lat0,lon0,rad) computes small circles with a
%   center at the point lat0, lon0 and radius rad.  The inputs can be
%   scalar or column vectors.  The input radius is in degrees of arc
%   length on a sphere.
% 
%   [lat,lon] = SCIRCLE1(lat0,lon0,rad,az) uses the input az to define
%   the small circle arcs computed.  The arc azimuths are measured
%   clockwise from due north.  If az is a column vector, then the
%   arc length is computed from due north.  If az is a two column
%   matrix, then the small circle arcs are computed starting at the
%   azimuth in the first column and ending at the azimuth in the
%   second column.  If az = [], then a complete small circle is computed.
% 
%   [lat,lon] = SCIRCLE1(lat0,lon0,rad,az,geoid) computes the small circle
%   on the ellipsoid defined by the input geoid. The geoid vector
%   is of the form [semimajor axes, eccentricity].  If omitted, the
%   unit sphere, geoid = [1 0], is assumed.
% 
%   [lat,lon] = SCIRCLE1(lat0,lon0,rad,'units'),
%   [lat,lon] = SCIRCLE1(lat0,lon0,rad,az,'units'), and
%   [lat,lon] = SCIRCLE1(lat0,lon0,rad,az,geoid,'units') are all valid
%   calling forms, which use the inputs 'units' to define the angle
%   units of the inputs and outputs.  If omitted, 'degrees' are assumed.
% 
%   [lat,lon] = SCIRCLE1(lat0,lon0,rad,az,geoid,'units',npts) uses the
%   input npts to determine the number of points per small circle
%   computed.  The input npts is a scalar, and if omitted, npts = 100.
% 
%   [lat,lon] = SCIRCLE1('track',...) uses the 'track' string to define
%   either a great circle or rhumb line radius.  If 'track' = 'gc',
%   then small circles are computed.  If 'track' = 'rh', then
%   the circles with radii of constant rhumb line distance are computed.
%   If omitted, 'gc' is assumed.
% 
%   mat = SCIRCLE1(...) returns a single output argument where
%   mat = [lat lon].  This is useful if only a single circle is computed.
% 
%   Multiple circles can be defined from a single starting point by
%   providing scalar lat0, lon0 inputs and column vectors for rad and
%   az if desired.
% 
%   

function scircle2
%MATLAB Tour Partial Function Help:  map_con
%
% SCIRCLE2  Small circle defined by its center and perimeter
% 
%   [lat,lon] = SCIRCLE2(lat1,lon1,lat2,lon2) computes small circles
%   with centers at the point lat1, lon1 and points on the circles
%   at lat2, lon2.  The inputs can be scalar or column vectors.
% 
%   [lat,lon] = SCIRCLE2(lat1,lon1,lat2,lon2,geoid) computes the small
%   circle on the ellipsoid defined by the input geoid. The geoid
%   vector is of the form [semimajor axes, eccentricity].  If omitted,
%   the unit sphere, geoid = [1 0], is assumed.
% 
%   [lat,lon] = SCIRCLE2(lat1,lon1,lat2,lon2,'units') and
%   [lat,lon] = SCIRCLE2(lat1,lon1,lat2,lon2,geoid,'units') are all valid
%   calling forms, which use the inputs 'units' to define the angle
%   units of the inputs and outputs.  If omitted, 'degrees' are assumed.
% 
%   [lat,lon] = SCIRCLE2(lat1,lon1,lat2,lon2,geoid,'units',npts) uses
%   the input npts to determine the number of points per track
%   computed.  The input npts is a scalar, and if omitted, npts = 100.
% 
%   [lat,lon] = SCIRCLE2('track',...) uses the 'track' string to define
%   either a great circle or rhumb line radius.  If 'track' = 'gc',
%   then small circles are computed.  If 'track' = 'rh', then
%   the circles with radii of constant rhumb line distance are computed.
%   If omitted, 'gc' is assumed.
% 
%   mat = SCIRCLE2(...) returns a single output argument where
%   mat = [lat lon].  This is useful if only a single circle is computed.
% 
%   Multiple circles can be defined from a single center point by
%   providing scalar lat1, lon1 inputs and column vectors for the points
%   on the circumference, lat2, lon2.
% 
%   

function track
%MATLAB Tour Partial Function Help:  map_con
%
% TRACK  Connects navigational waypoints with track segments
% 
%   [lat,lon] = TRACK(lat0,lon0) connects waypoints given in navigation
%   track format with track segments.  The track segements are rhumb
%   lines, which is the navigationally common method.
% 
%   [lat,lon] = TRACK(lat0,lon0,geoid) computes the rhumb line tracks
%   on the ellipsoid defined by the input geoid. The geoid vector
%   is of the form [semimajor axes, eccentricity].  If omitted,
%   the unit sphere, geoid = [1 0], is assumed.
% 
%   [lat,lon] = TRACK(lat0,lon0,'units') and
%   [lat,lon] = TRACK(lat0,lon0,geoid,'units') are all valid
%   calling forms, which use the inputs 'units' to define the angle
%   units of the inputs and outputs.  If omitted, 'degrees' are assumed.
% 
%   [lat,lon] = TRACK(lat0,lon0,geoid,'units',npts) uses the
%   input npts to determine the number of points per track computed.
%   The input npts is a scalar, and if omitted, npts = 100.
% 
%   [lat,lon] = TRACK(mat) and [lat,lon] = TRACK(mat,'units') are
%   valid calling forms, where mat = [lat0 lon0].
% 
%   [lat,lon] = TRACK('track',...) uses the 'track' string to define
%   either a great circle or rhumb line tracks.  If 'track' = 'gc',
%   then the great circle tracks are computed.  If 'track' = 'rh', then
%   the rhumb line tracks are computed.  If omitted, 'rh' is assumed.
% 
%   mat = TRACK(...) returns a single output argument where mat = [lat lon].
% 
%   

function track1
%MATLAB Tour Partial Function Help:  map_con
%
% TRACK1  Track lines defined by starting point, azimuth and range
% 
%   [lat,lon] = TRACK1(lat0,lon0,az) computes complete great circle
%   tracks starting at the point lat0, lon0 and bearing along the
%   input azimuth, az.  The inputs can be scalar or column vectors.
% 
%   [lat,lon] = TRACK1(lat0,lon0,az,rng) uses the input rng to define
%   the range of the great circle computed.  The range input is in
%   degrees of arc length along a sphere.  If range is a column vector,
%   then the track is computed from the starting point, with positive
%   distance measured easterly.  If range is a two column matrix, then
%   the track is computed starting at the range in the first column and
%   ending at the range in the second column.  If rng = [], then the
%   complete track is computed.
% 
%   [lat,lon] = TRACK1(lat0,lon0,az,rng,geoid) computes the great circle
%   track on the ellipsoid defined by the input geoid. The geoid vector
%   is of the form [semimajor axes, eccentricity].  If omitted, the
%   unit sphere, geoid = [1 0], is assumed. If provided, rng must
%   be in the units of geoid(1), regardless of the default or specified 
%   angle units.
% 
%   [lat,lon] = TRACK1(lat0,lon0,az,'units'),
%   [lat,lon] = TRACK1(lat0,lon0,az,rng,'units'), and
%   [lat,lon] = TRACK1(lat0,lon0,az,rng,geoid,'units') are all valid
%   calling forms, which use the inputs 'units' to define the angle
%   units of the inputs and outputs.  If omitted, 'degrees' are assumed.
% 
%   [lat,lon] = TRACK1(lat0,lon0,az,rng,geoid,'units',npts) uses the
%   input npts to determine the number of points per track computed.
%   The input npts is a scalar, and if omitted, npts = 100.
% 
%   [lat,lon] = TRACK1('track',...) uses the 'track' string to define
%   either a great circle or rhumb line track.  If 'track' = 'gc',
%   then the great circle tracks are computed.  If 'track' = 'rh', then
%   the rhumb line tracks are computed.  If omitted, 'gc' is assumed.
% 
%   mat = TRACK1(...) returns a single output argument where
%   mat = [lat lon].  This is useful if only a single track is computed.
% 
%   Multiple tracks can be defined from a single starting point by
%   providing scalar lat0, lon0 inputs and column vectors for az and
%   rng if desired.
% 
%   

function track2
%MATLAB Tour Partial Function Help:  map_con
%
% TRACK2  Track lines defined by a starting and ending point
% 
%   [lat,lon] = TRACK2(lat1,lon1,lat2,lon2) computes great circle
%   tracks starting at the point lat1, lon1 and ending at lat2, lon2.
%   The inputs can be scalar or column vectors.
% 
%   [lat,lon] = TRACK2(lat1,lon1,lat2,lon2,geoid) computes the great circle
%   track on the ellipsoid defined by the input geoid. The geoid vector
%   is of the form [semimajor axes, eccentricity].  If omitted, the
%   unit sphere, geoid = [1 0], is assumed.
% 
%   [lat,lon] = TRACK2(lat1,lon1,lat2,lon2,'units') and
%   [lat,lon] = TRACK2(lat1,lon1,lat2,lon2,geoid,'units') are all valid
%   calling forms, which use the inputs 'units' to define the angle
%   units of the inputs and outputs.  If omitted, 'degrees' are assumed.
% 
%   [lat,lon] = TRACK2(lat1,lon1,lat2,lon2,geoid,'units',npts) uses the
%   input npts to determine the number of points per track computed.
%   The input npts is a scalar, and if omitted, npts = 100.
% 
%   [lat,lon] = TRACK2('track',...) uses the 'track' string to define
%   either a great circle or rhumb line track.  If 'track' = 'gc',
%   then the great circle tracks are computed.  If 'track' = 'rh', then
%   the rhumb line tracks are computed.  If omitted, 'gc' is assumed.
% 
%   mat = TRACK2(...) returns a single output argument where
%   mat = [lat lon].  This is useful if only a single track is computed.
% 
%   Multiple tracks can be defined from a single starting point by
%   providing scalar lat1, lon1 inputs and column vectors for lat2, lon2.
% 
%   

function areaint
%MATLAB Tour Partial Function Help:  map_con
%
% AREAINT  Calculates the spherical surface area of a polygon
% 
%   a = AREAINT(lat,long) calculates the spherical surface area
%   of the polygon specified by the input vectors lat, long.  The
%   calculation uses a line integral approach.  The output, a,
%   is the surface area fraction covered by the polygon on a
%   unit sphere.  Multiple polygons can be supplied provided that
%   each polygon is separated by a NaN in the input vectors.
%   Accuracy of the integration method is inversely proportional
%   to the distance between lat/long points.
% 
%   a = AREAINT(lat,long,geoid) uses the input geoid to describe
%   the sphere or ellipsoid.  The output, a, is in square units
%   corresponding to the units of geoid(1).  If omitted, geoid = [1 0]
%   is assumed and the output is in the fractional form described above.
% 
%   a = AREAINT(lat,long,'units') uses the units defined by the
%   input string 'units'.  If omitted, default units of degrees
%   is assumed.
% 
%   a = AREAINT(lat,long,geoid,'units') uses both the inputs geoid
%   and 'units' in the calculation.
% 
%   

function areamat
%MATLAB Tour Partial Function Help:  map_con
%
% AREAMAT  Calculates the geographic area of matrix elements
% 
%   a = AREAMAT(map,maplegend) calculates the spherical surface
%   area of the input binary matrix map.  Any entry of 1 contributes
%   to the surface area total.  The output, a, is the surface area
%   fraction covered by the nonzero entries in the input map.  A
%   binary matrix map might be one generated by a logical statement,
%   such as map = topo > 0.
% 
%   a = AREAMAT(map,maplegend,geoid) uses the input geoid to describe
%   the sphere or ellipsoid.  The output, a, is in square units
%   corresponding to the units of geoid(1).  If omitted, geoid = [1 0]
%   is assumed and the output is in the fractional form described above.
% 
%   [a,areavec] = AREAMAT(...) returns the vector areavec containing
%   the cellular area per row of the map.  The surface area of any
%   cell is constant across a row of the input matrix map.
% 
%   

function areaquad
%MATLAB Tour Partial Function Help:  map_con
%
% AREAQUAD  Calculates the area of a lat-long quadrangle using spherical geometry
% 
%   a = AREAQUAD(lat1,lon1,lat2,lon2) calculates the spherical surface
%   area of the quadrangle specified by the input vectors.  The points
%   specified by lat1/lon1 are assumed to be the corner of the quadrangle
%   opposite the points specified by lat2/lon2.  A spherical quadrangle
%   is defined by the intersection of a lune and a zone. The output, a,
%   is the surface area fraction of the unit sphere.
% 
%   a = AREAQUAD(lat1,lon1,lat2,lon2,geoid) uses the input geoid to describe
%   the sphere or ellipsoid.  The output, a, is in square units
%   corresponding to the units of geoid(1).  If omitted, geoid = [1 0]
%   is assumed and the output is in the fractional form described above.
% 
%   a = AREAQUAD(lat1,lon1,lat2,lon2,'units') uses the units defined by the
%   input string 'units'.  If omitted, default units of degrees
%   is assumed.
% 
%   a = AREAQUAD(lat1,lon1,lat2,lon2,geoid,'units') uses both the
%   inputs geoid and 'units' in the calculation.
% 
%   

function combntns
%MATLAB Tour Partial Function Help:  map_con
%
% COMBNTNS  Computes all combinations of a given set of values
% 
%   c = COMBNTNS(choicevec,choose) returns all combinations of the
%   values of the input choice vector.  The size of the combinations
%   are given by the second input.  For example, if choicevec
%   is [1 2 3 4 5], and choose is 2, the output is a matrix
%   containing all distinct pairs of the choicevec set.
%   The output matrix has "choose" columns and the combinatorial
%   "length(choicevec)-choose-'choose'" rows.  The function does not
%   account for repeated values, treating each entry as distinct.
%   As in all combinatorial counting, an entry is not paired with
%   itself, and changed order does not consititute a new pairing.
%   This function is recursive.

function eqa2grn
%MATLAB Tour Partial Function Help:  map_con
%
% EQA2GRN  Equal area coordinates to Greenwich coordinates
% 
%   [lat,lon] = EQA2GRN(x,y) transforms from equal area cylindrical
%   coordinates to Greenwich latitude and longitude coordinates.
%   The transformation assumes that the origin of the cylindrical
%   coordinate plane is at (lat,lon) = (0,0).  The outputs
%   are returned in degrees.
% 
%   [lat,lon] = EQA2GRN(x,y,origin) assumes that the origin of the
%   cylindrical coordinate plate is given by the input origin.
%   This input is of the form [lat0,lon0] where the 2 elements are
%   in degrees.
% 
%   [lat,lon] = EQA2GRN(x,y,origin,geoid) assumes that the data
%   is distributed on the ellipsoid defined by the input geoid.
%   The geoid vector is of the form [semimajor axes, eccentricity].
%   If omitted, the unit sphere, geoid = [1 0], is assumed.
% 
%   [lat,lon] = EQA2GRN(x,y,origin,'units') and
%   [lat,lon] = EQA2GRN(x,y,origin,geoid,'units') assumes that the
%   origin input and output vectors are in the angle units specified
%   by 'units'.  If omitted, 'degrees' are assumed.
% 
%   mat = EQA2GRN(...) returns a single output matrix,
%   where mat = [lat lon].
% 
%   

function filterm
%MATLAB Tour Partial Function Help:  map_con
%
% FILTERM  Geographically filters data points
% 
%   [latout,lonout] = FILTERM(lat,long,map,maplegend,allowed) filters
%   a set of latitudes and longitudes to include only those data points 
%   which have a corresponding value in map equal to allowed.
% 
%   [latout,lonout,indx] = FILTERM(lat,long,map,maplegend,allowed) also 
%   returns the indices of the included points.
% 
%   

function grn2eqa
%MATLAB Tour Partial Function Help:  map_con
%
% GRN2EQA  Greenwich coordinates to equal area cartesian coordinates
% 
%   [x,y] = GRN2EQA(lat,lon) transforms from Greenwich latitude and
%   longitude coordinates to equal area cylindrical coordinates.
%   The transformation assumes that the origin of the cylindrical
%   coordinate plane is at (lat,lon) = (0,0).  The inputs are in degrees.
% 
%   [x,y] = GRN2EQA(lat,lon,origin) assumes that the origin of the
%   cylindrical coordinate plate is given by the input origin.
%   This input is of the form [lat0,lon0] where the 2 elements are
%   in degrees.
% 
%   [x,y] = GRN2EQA(lat,lon,origin,geoid) assumes that the data
%   is distributed on the ellipsoid defined by the input geoid.
%   The geoid vector is of the form [semimajor axes, eccentricity].
%   If omitted, the unit sphere, geoid = [1 0], is assumed.
% 
%   [x,y] = GRN2EQA(lat,lon,origin,'units') and
%   [x,y] = GRN2EQA(lat,lon,origin,geoid,'units') assumes that the
%   input data lat, lon and origin are in the angle units specified
%   by 'units'.  If omitted, 'degrees' are assumed.
% 
%   mat = GRN2EQA(...) returns a single output matrix,
%   where mat = [x y].
% 
%   

function histr
%MATLAB Tour Partial Function Help:  map_con
%
% HISTR  Spatial equirectangular histogram
% 
%   [lat,lon,ct] = HISTR(lat0,lon0) computes a spatial histogram of
%   geographic data using equirectangular binning of one degree.  In
%   other words, one degree increments of latitude and longitude to
%   define the bins throughout the globe.  As a result, these bins are
%   not equal area.  The outputs are the location of bins in which the
%   data was accumulated, as well as the number of occurances in these bins.
% 
%   [lat,lon,ct] = HISTR(lat0,lon0,binsize) uses the bin size specified
%   by the input.  This input must be in the same units as the lat and
%   lon input.
% 
%   [lat,lon,ct] = HISTR(lat0,lon0,'units') and
%   [lat,lon,ct] = HISTR(lat0,lon0,binsize,'units') use the input
%   'units' to define the angle units of the inputs and outputs.
%   If omitted, 'degrees' are assumed.
% 
%   [lat,lon,ct,wt] = HISTR(...) returns the number of occurances,
%   weighted by the area of each bin.  The weighting factors assume that
%   bins along the equator are given an area of 1.0.
% 
%   

function meanm
%MATLAB Tour Partial Function Help:  map_con
%
% MEANM  Mean for geographic data
% 
%   [latbar,lonbar] = MEANM(lat,lon) computes means for geographic
%   data.  This corresponds to the geographic centroid of a data set,
%   assuming that the data are distributed on a sphere.  In contrast,
%   MEAN assumes that the data are distributed on a cartesian plan.
%   When lat and lon are vectors, a single mean location is returned.
%   When lat and long are matrices, latmean and lonmean are row vectors
%   providing the mean locations for each column of lat and lon.
%   N-dimensional arrays are not allowed.
% 
%   [latbar,lonbar] = MEANM(lat,lon,geoid) computes the geographic mean
%   on the ellipsoid defined by the input geoid. The geoid vector
%   is of the form [semimajor axes, eccentricity].  If omitted, the
%   unit sphere, geoid = [1 0], is assumed.
% 
%   [latbar,lonbar] = MEANM(lat,lon,'units') use the input 'units'
%   to define the angle units of the inputs and outputs.  If
%   omitted, 'degrees' are assumed.
% 
%   [latbar,lonbar] = MEANM(lat,lon,geoid,'units') is a valid form.
% 
%   mat = MEANM(...) returns a single output, where mat = [latbar,lonbar].
%   This is particularly useful if the lat and lon inputs are vectors.
% 
%   

function stdm
%MATLAB Tour Partial Function Help:  map_con
%
% STDM  Standard deviation for geographic data
% 
%   [latstd,lonstd] = STDM(lat,lon) computes standard deviation for
%   geographic data.  This function assumes that the data is distributed
%   on a sphere.  In contrast, STD assumes that the data is distributed
%   on a cartesian plane.  Deviations are "sample" standard deviations,
%   normalized by (n-1), where n is the sample size. The square of the
%   sample standard deviation is an unbiased estimator of the variance.
%   When lat and lon are vectors, a single deviation location is returned.
%   When lat and long are matrices, latstd and lonstd are row vectors
%   providing the deviations for each column of lat and lon.  N-dimensional
%   arrays are not allowed.  Deviations are taken from the mean position
%   as returned by MEANM.  Deviations in longitude consider departure.
%   The deviations are degrees of distance.
% 
%   [latstd,lonstd] = STDM(lat,lon,geoid) computes the standard deviation
%   on the ellipsoid defined by the input geoid. The geoid vector
%   is of the form [semimajor axes, eccentricity].  If omitted, the
%   unit sphere, geoid = [1 0], is assumed.  The output deviations are
%   returned in the same distance units as geoid(1).
% 
%   [latstd,lonstd] = STDM(lat,lon,'units') use the input 'units'
%   to define the angle units of the inputs and outputs.  If
%   omitted, 'degrees' are assumed.
% 
%   [latstd,lonstd] = STDM(lat,lon,geoid,'units') is a valid form.
% 
%   mat = STDM(...) returns a single output, where mat = [latbar,lonbar].
%   This is particularly useful if the lat and lon inputs are vectors.
% 
%   

function stdist
%MATLAB Tour Partial Function Help:  map_con
%
% STDIST  Standard distance for geographic data
% 
%   d = STDIST(lat,lon) computes the average standard distance for
%   geographic data.  This function assumes that the data is distributed
%   on a sphere.  In contrast, STD assumes that the data is distributed on
%   a cartesian plane.  The result is a single value based on the
%   great-circle distance of the data points from their geographic
%   mean point.  When lat and lon are vectors, a single distance
%   is returned.  When lat and long are matrices, a row vector of
%   distances is given, providing the distances for each column of
%   lat and lon.  N-dimensional arrays are not allowed.  Distances are
%   returned in degrees of angle units.
% 
%   d = STDIST(lat,lon,geoid) computes the average standard distance
%   on the ellipsoid defined by the input geoid. The geoid vector
%   is of the form [semimajor axes, eccentricity].  If omitted, the
%   unit sphere, geoid = [1 0], is assumed.  The output deviations are
%   returned in the same distance units as geoid(1).
% 
%   d = STDIST(lat,lon,'units') and d = STDIST(lat,lon,geoid,'units')
%   use the input 'units' to define the angle units of the inputs and
%   outputs.  If omitted, 'degrees' are assumed.
% 
%   d = STDIST(lat,lon,geoid,'units','method') uses the 'method' string
%   to define the calculation of standard distance.  'linear' computes
%   the average distance; 'quadratic' computes the square root of the
%   average squared distance; 'cubic' computes the cube root of the
%   average cubed distance.
% 
%   

function dreckon
%MATLAB Tour Partial Function Help:  map_con
%
%  DRECKON  Computes dead reckoning (DR) positions for a track
% 
%   [drlat,drlong,drtime] = DRECKON(waypoints,time,speed) takes
%   the latitudes and waypoints in navigational track format,
%   the first point of which is presumably a navigational fix, and
%   the time of that fix, as well as ordered speeds in knots
%   (nautical miles per hour), returns the positions and times
%   associated with required dead reckoning (DR) in accordance with
%   standard navigational practice.  Speed is a scalar, in which case
%   it applies throughout, or is provided for each leg (a vector of same
%   length as lat, minus 1), in which case speed changes coincide with
%   course changes.
% 
%   [drlat,drlong,drtime] = DRECKON(waypoints,time,speed,spdtimes)
%   associates the vector spdtimes with a vector input speed.
%   Spdtimes are elapsed times after the fix time at which a given
%   speed order ends (i.e., speed(1) would start at time and end at
%   time + spdtimes(1).  No DR will be given for positions past the
%   last waypoint in the track, nor, if given, past the last time
%   in spdtimes.
% 
%   Note:  This is a navigational function -- all lats/longs are in
%          degrees, all distances in nautical miles, all times
%          in hours, and all speeds in knots (nautical miles per hour).
% 
%   

function gcwaypts
%MATLAB Tour Partial Function Help:  map_con
%
% GCWAYPTS   Computes equally spaced waypoint coordinates along a great circle
% 
%   [lat,lon] = GCWAYPTS(lat1,lon1,lat2,lon2) returns ten ordered
%   waypoints for the purpose of approximating great circle sailing.
%   All inputs must be scalars.
% 
%   [lat,lon] = GCWAYPTS(lat1,lon1,lat2,lon2,nlegs) computes "nlegs"
%   waypoints.
% 
%   mat = GCWAYPTS(...) returns a single output, where mat = [lat lon].
% 
%   Note:  This is a navigational function -- all lats/longs are in
%          degrees, all distances in nautical miles, all times
%          in hours, and all speeds in knots (nautical miles per hour).
% 
%   

function legs
%MATLAB Tour Partial Function Help:  map_con
%
% LEGS  Provides courses and distances between track waypoints
% 
%   [course,dist] = LEGS(lat,lon) takes a series of waypoints in
%   navigation track format, calculates the new course and distance
%   for each point.  The default method is rhumb line ('rh'), the common
%   navigational method.
% 
%   [course,dist] = LEGS(lat,lon,'method') uses the method string
%   to specify the navigation track.  Allowable method strings are
%   'gc' for great circle tracks, and 'rh' for rhumb line tracks.
% 
%   [course,dist] = LEGS(mat) and [course,dist] = LEGS(mat,'method')
%   uses a single input matrix mat, where mat = [lat lon].
% 
%   mat = LEGS(...) returns a single output, where mat = [course,dist].
% 
%   Note:  This is a navigational function -- all lats/longs are in
%          degrees, all distances in nautical miles, all times
%          in hours, and all speeds in knots (nautical miles per hour).
% 
%   

function navfix
%MATLAB Tour Partial Function Help:  map_con
%
% NAVFIX  Performs mercator-based navigational fixing
% 
%   [latfix,lonfix] = NAVFIX(lat,long,az) exactly parallels the manual
%   navigation plotting method to establish rhumb-line and range-arc cross
%   fixes.  Manual navigation employs a mercator projection chart, on which
%   azimuthal sightings are plotted as straight (rhumb) lines.  Range arcs
%   are of constant radius on the projection, i.e., they appear as
%   perfect circles on a displayed mercator chart, as one might draw
%   with a compass.  Any number (at least two) of sighting object positions
%   and azimuths or ranges can be input; one output row will be provided for
%   each combination of pairs of the input objects. The output is a two-column
%   vector;  both entries in a row are NaN's when no intersection exists for
%   that pair.  Two lines of position will return an intersection point (if any)
%   and a NaN, as two lines can intersect once at most. Where arcs
%   are involved, there may be two points of intersection (navigational
%   ambiguity).
% 
%   [latfix,lonfix] = NAVFIX(lat,long,az,casetype) uses input object
%   types are designated by the input "casetype" vector elements, which are
%   ones corresponding to lines of position, (and for which the input
%   azimuth is in degrees), and zeros corresponding to arcs of position, (for
%   which "az" is really a range in nautical miles).
% 
%   [latfix,lonfix] = NAVFIX(lat,long,range,casetype) determines the range
%   scale used for each arc from the mercator scale at the arc center.
% 
%   [latfix,lonfix] = NAVFIX(lat,long,az,casetype,drlat,drlong) provides
%   a dead-reckoning (DR) latitude and longitude to resolve ambiguity by
%   returning for each pair of objects only the intersection closest to
%   the DR position.  Under this situation, when any pair of objects fails
%   to intersect, the output is empty and a warning is displayed.
% 
%   mat = NAVFIX(...) returns a single output, where mat = [latfix lonfix].
% 
%   Note:  This is a navigational function -- all lats/longs are in
%          degrees, all distances in nautical miles, all times
%          in hours, and all speeds in knots (nautical miles per hour).
% 
%   

function timezone
%MATLAB Tour Partial Function Help:  map_con
%
% TIMEZONE  Sets the time zone description for longitudes
% 
%   [zd, zltr, zone] = TIMEZONE(lon) calculates the navigational
%   time zone (based on longitude, ignoring local statutory deviations).
%   It returns numerical zone description (add as hours to zone time
%   to get Greenwich Mean Time,(GMT=+0Z), alphabetical zone indicator,
%   and string zone description plus alphabetical zone indicator.
%   For example, GMT is equivilent to '+0Z'.
% 
%   [zd, zltr, zone] = timezone(lon,'units') uses the input string
%   'units' to define the input angle units.  If omitted,
%   'degrees' are assumed.
% 
%   

function interpm
%MATLAB Tour Partial Function Help:  map_con
%
% INTERPM  Interpolates vector data to a specified data separation
% 
%   [lat,lon] = INTERPM(lat,long,maxdiff) linearly interpolates between
%   vector data coordinate points where necessary to return data with no
%   two connected points separated by an angular distance greater than
%   maxdiff. Maxdiff must be in the same units as the input lat and lon
%   data.
% 
%   [lat,lon] = INTERPM(lat,long,maxdiff,'method') interpolates between
%   vector data coordinate points using a specified interpolation method.
%   Valid interpolation methods strings are 'gc' for great circle, 'rh'
%   for rhumb lines, and 'lin' for linear interpolation. With no units
%   specified, lat,long and maxdiff are assumed to be in units of degrees.
% 
%   [lat,lon] = INTERPM(lat,long,maxdiff,'method','units') interpolates
%   between vector data coordinate points using a specified interpolation
%   method. Inputs and outputs are in the specified units.
% 
%   

function intrplat
%MATLAB Tour Partial Function Help:  map_con
%
% INTRPLAT  Computes an interpolated latitude for a given longitude
% 
%   lat = INTRPLAT(lon0,lat0,long) linearly interpolates the input
%   data to determine the latitude value corresponding to long.  The
%   input lon0 vector must be monotonic.
% 
%   lat = INTRPLAT(lon0,lat0,long,'method') uses the method string to
%   determine the interpolation calculation.  Valid 'method' strings
%   are 'linear' for linear interpolation between coordinates;
%   'rh' for interpolation along a rhumb line between coordinates;
%   'gc' for interpolation along a great circle between coordinates;
%   'spline' for cubic spline interpolation between coordinates; and
%   'cubic' for cubic interpolation between coordinates.  If omitted,
%   'linear' is assumed.
% 
%   lat = INTRPLAT(lon0,lat0,long,'method','units') uses the input 'units'
%   to specify the angle units for the input and output data.  If omitted,
%   'degrees' are assumed.
% 
%   

function intrplon
%MATLAB Tour Partial Function Help:  map_con
%
% INTRPLON  Computes an interpolated longitude for a given latitude
% 
%   long = INTRPLON(lat0,lon0,lat) linearly interpolates the input
%   data to determine the longitude value corresponding to lat.  The
%   input lat0 vector must be monotonic.
% 
%   lat = INTRPLON(lat0,lon0,lat,'method') uses the method string to
%   determine the interpolation calculation.  Valid 'method' strings
%   are 'linear' for linear interpolation between coordinates;
%   'rh' for interpolation along a rhumb line between coordinates;
%   'gc' for interpolation along a great circle between coordinates;
%   'spline' for cubic spline interpolation between coordinates; and
%   'cubic' for cubic interpolation between coordinates.  If omitted,
%   'linear' is assumed.
% 
%   lat = INTRPLON(lat0,lon0,lat,'method','units') uses the input 'units'
%   to specify the angle units for the input and output data.  If omitted,
%   'degrees' are assumed.
% 
%   

function crossfix
%MATLAB Tour Partial Function Help:  map_con
%
% CROSSFIX  Computes cross fix positions for bearings and ranges
% 
%   [newlat,newlon] = CROSSFIX(lat,long,az) computes cross fixes
%   (intersections) to locate a point when its great circle azimuths
%   or ranges from fixed points are known.  Takes each input case
%   and pairs it with all other input cases.  Since circles
%   intersect twice, in general, two intersection points
%   are returned for each such pairing.  NaN's are returned
%   for pairings which do not intersect.
% 
%   [newlat,newlon] = CROSSFIX(lat,long,az,case) uses the vector, case,
%   with a 1 (default) for each point designated by azimuth; a zero
%   indicates that "az" for that point is a range in angle units.
% 
%   [newlat,newlon] = CROSSFIX(lat,long,az,case,drlat,drlong) uses
%   the dead reckoned latitude and longitude inputs to resolve
%   each intersection pair ambiguity.  The point closest to the
%   dead reckoned position is returned.  When this option is used,
%   any non-intersecting pair results in a "no fix" warning and
%   in empty output matrices.
% 
%   [newlat,newlon] = CROSSFIX(lat,long,az,'units'),
%   [newlat,newlon] = CROSSFIX(lat,long,az,case,'units'),
%   [newlat,newlon] = CROSSFIX(lat,long,az,drlat,drlong,'units') and
%   [newlat,newlon] = CROSSFIX(lat,long,az,case,drlat,drlong,'units')
%   uses the input units to define the angle units of the inputs and
%   outputs.
% 
%   mat = CROSSFIX(...) returns a single output, where mat = [newlat newlon].
% 
%   

function gcxgc
%MATLAB Tour Partial Function Help:  map_con
%
% GCXGC  Computes the intersection points between two great circles
% 
%   [lat,lon] = GCXGC(lat1,long1,az1,lat2,long2,az2) finds the two
%   intersection points for every input pair of great circles.  Inputs
%   are in in great circle notation, each circle defined by the latitude
%   and longitude of a point on that circle and an azimuth at that point.
%   When two circles are identical (which is not generally obvious from
%   the input notation), NaN's are returned.  Only spherical geoids are
%   supported.
% 
%   [lat,lon] = GCXGC(lat1,long1,az1,lat2,long2,az2,'units') uses the
%   input string units to define the angle units for the inputs and
%   outputs.
% 
%   mat = GCXGC(...) returns a single output, where mat = [lat lon].
% 
%   

function gcxsc
%MATLAB Tour Partial Function Help:  map_con
%
% GCXSC  Computes the intersection points between a great and a small circle
% 
%   [lat,lon] = GCXSC(gclat,gclong,gcaz,sclat,sclong,scrange) finds the
%   intersection points, if any, between a great circle given in great
%   circle notation (lat,long,azimuth, lat/long on the circle) and a
%   small circle given in small circle notation (lat,long,range,
%   lat/long the center of the circle). GCXSC returns NaNs if the
%   circles do not intersect or are identical.  The great circle(s)
%   must be input first.  Only spherical geoids are supported.
% 
%   [lat,lon] = GCXSC(gclat,gclong,gcaz,sclat,sclong,scrange,'units')
%   uses the input string units to define the angle units for the
%   inputs and outputs.
% 
%   mat = GCXSC(...) returns a single output, where mat = [lat lon].
% 
%   

function rhxrh
%MATLAB Tour Partial Function Help:  map_con
%
% RHXRH  Finds the intersection point between two rhumb lines
% 
%   [lat,lon] = RHXRH(lat1,long1,az1,lat2,long2,az2) finds the
%   intersection point, if any, for every input pair of rhumb lines.
%   Inputs are in rhumb line notation, each line defined by the latitude
%   and longitude of a point on that line and the line's constant heading.
%   When two lines are identical (which is not generally obvious from the
%   input notation), or the lines do not intersect, NaN's are returned.
%   Since all rhumb lines with headings other than +/-90 degrees terminate
%   at both poles, the poles are not considered points of intersection.
%   Only spherical geoids are supported.
% 
%   [lat,lon] = RHXRH(lat1,long1,az1,lat2,long2,az2,'units') uses the
%   input string units to define the angle units for the inputs and
%   outputs.
% 
%   mat = RHXRH(...) returns a single output, where mat = [lat lon].
% 
%   

function scxsc
%MATLAB Tour Partial Function Help:  map_con
%
% SCXSC  Calculates intersection points for pairs of small circles
% 
%   [lat,lon] = SCXSC(lat1,long1,range1,lat2,long2,range2) finds the two
%   intersection points for every input pair of small circles.  SCXSC returns
%   NaNs where no intersection exists, or when both circles are identical.
%   Assumes spherical geoid and ranges in same angular unit.  Note that a
%   great circle is a small circle with radius of 90 degrees.  Only
%   spherical geoids are supported.
% 
%   [lat,lon] = SCXSC(lat1,long1,range1,lat2,long2,range2,'units') uses the
%   input string units to define the angle units for the inputs and
%   outputs.
% 
%   mat = SCXSC(...) returns a single output, where mat = [lat lon].
% 
%   

function maptriml
%MATLAB Tour Partial Function Help:  map_con
%
% MAPTRIML  Trims a line map to a specified region
% 
%   [lat,lon] = MAPTRIML(lat0,lon0,latlim,lonlim) trims a line map
%   to a region specified by latlim and lonlim.  Latlim and lonlim
%   are two element vectors, defining the latitude and longitude limits
%   respectively.  The inputs lat0 and lon0 must be vectors.
% 
%   

function maptrimp
%MATLAB Tour Partial Function Help:  map_con
%
% MAPTRIMP  Trims a patch map to a specified region
% 
%   [lat,lon] = MAPTRIMP(lat0,lon0,latlim,lonlim) trims a patch map
%   to a region specified by latlim and lonlim.  Latlim and lonlim
%   are two element vectors, defining the latitude and longitude limits
%   respectively.  The inputs lat0 and lon0 must be vectors representing
%   patch map vector data.
% 
%   

function maptrims
%MATLAB Tour Partial Function Help:  map_con
%
% MAPTRIMS  Trims surface map to a specified region
% 
%   map = MAPTRIMS(map0,maplegend0,latlim,lonlim) trims a regular surface
%   map to the region specified by latlim and lonlim.  Latlim and lonlim
%   are two element vectors, defining the latitude and longitude limits
%   respectively.  The output map is of the same scale as the input map.
% 
%   map = MAPTRIMS(map0,maplegend0,latlim,lonlim,scale) uses scale
%   to reduce the size of the output map.  MAPLEGEND0 must be evenly
%   divisible by scale.
% 
%   [map,maplegend] = MAPTRIMS(...) returns the maplegend for the trimmed
%   map.
% 
%   

function reducem
%MATLAB Tour Partial Function Help:  map_con
%
% REDUCEM  Reduce the number of points in vector data
% 
%   [latout,lonout] = REDUCEM(latin,lonin) reduces the number of points
%   in vector map data using the Douglas-Peucker line simplification
%   algorithm.  This method recursively subdivides a polygon until a
%   run of points can be replaced by a straight line segment, with no
%   point in that run deviating from the straight line by more than the
%   tolerance.  In this case the tolerance is computed automatically.
% 
%   [latout,lonout] = REDUCEM(latin,lonin,tol) uses the provided
%   tolerance. The units of the tolerance are degrees of arc on the surface
%   of a sphere.
% 
%   [latout,lonout,cerr] = REDUCEM(...)  also returns a measure of the
%   error introduced by the simplification.  Cerr is the difference in
%   the arc length of the original and reduced data, normalized by the
%   original length.
% 
%   [latout,lonout,cerr,tol] = REDUCEM(...)  also returns the tolerance
%   used in the reduction. Useful when the tolerance is computed
%   automatically.
% 
%   

function epsm
%MATLAB Tour Partial Function Help:  map_con
%
% EPSM  Calculate the accuracy of the map computations
% 
%   e = EPSM returns the accuracy of computations performed in
%   the Mapping Toolbox.  The accuracy returned is in degrees.
% 
%   e = EPSM('units') returns the accuracy in the units specified
%   by the string 'units'.  If omitted, 'degrees' are assumed.
% 
%   

function roundn
%MATLAB Tour Partial Function Help:  map_con
%
% ROUNDN  Rounds input data at specified power of 10
% 
%   y = ROUNDN(x) rounds the input data x to the nearest hundredth.
% 
%   y = ROUNDN(x,n) rounds the input data x at the specified power
%   of tens position.  For example, n = -2 rounds the input data to
%   the 10E-2 (hundredths) position.
% 
%   [y,msg] = ROUNDN(...) returns the text of any error condition
%   encountered in the output variable msg.
% 
%   

function distortcalc
%MATLAB Tour Partial Function Help:  map_con
%
%  DISTORTCALC calculates distortion parameters for a map projection
% 
%   areascale = DISTORTCALC(lat,long) computes the area distortion for the 
%   current map projection at the specified geographic location. An area 
%   scale of 1 indicates no scale distortion. Latitude and longitude may 
%   be scalars, vectors or matrices in the angle units of the defined map 
%   projection.  
% 
%   areascale = DISTORTCALC(mstruct,lat,long) uses the projection defined in 
%   the map structure mstruct.
% 
%   [areascale,angdef,maxscale,minscale,merscale,parscale] = DISTORTCALC(...)
%   computes the area scale, maximum angular deformation (in the angle units of
%   the defined projection), the particular maximum and minimum scale 
%   distortions in any direction, and the particular scale along the 
%   meridian and parallel. DISTORTCALC may also be called with fewer output 
%   arguments, in the order shown.
% 
%   

function mfwdtran
%MATLAB Tour Partial Function Help:  map_con
%
% MFWDTRAN  Process the map forward transformations
% 
%   [x,y] = MFWDTRAN(lat,lon) processes the map forward
%   transformations using the map projection defined in the
%   current axes.  Using this function, Greenwich data is transformed 
%   to the cartesian coordinate frame.  No clipping or trimming of
%   the data is performed in this form.
% 
%   [x,y,z] = MFWDTRAN(lat,lon,alt) transforms the 3 dimensional
%   data to the projected coordinate system.  If alt = [] is 
%   supplied or alt is omitted, then alt = 0.
% 
%   [x,y,z,strct] = MFWDTRAN(lat,lon,alt,'object') clips and trims
%   the object data during this projection process.  The output strct
%   is a structure which is associated with each object displayed. 
%   It contains information regarding the clips and trims associated 
%   with the object.  This information is computed in each projection 
%   m-file.  In addition, this structure is associated with each 
%   displayed object in the object's user data.  This association is 
%   performed as part of the display process.
% 
%    Allowable object strings are 'surface' for map graticules; 
%   'line' for line objects; 'patch' for patch objects; 'light' for
%   light objects; 'text' for text objects; 'none' for no clipping 
%   and trimming of input data.
% 
%   [...] = MFWDTRAN(mstruct,...) assumes that a valid map 
%   structure is supplied as the first argument.  This structure is
%   used to define the map projection calculation performed.  No
%   map axes need be displayed when using this form.
% 
%   

function minvtran
%MATLAB Tour Partial Function Help:  map_con
%
% MINVTRAN  Process the map inverse transformations
% 
%   [lat,lon] = MINVTRAN(x,y) processes the map inverse 
%   transformations using the map projection defined in the
%   current axes.  Cartesian data is transformed to the 
%   Greenwich coordinate frame.  No clipping or trimming of the
%   data are removed in this form.
% 
%   [lat,lon,alt] = MINVTRAN(x,y,z) transforms the 3 dimensional
%   data from the projected space to the Greenwich coordinate system.
%   If z = [] is supplied or is omitted, then z = 0 is assumed.
% 
%   [lat,lon,alt] = MINVTRAN(x,y,z,'object',strct) removes all clips
%   and trims from the input data. The input strct is a structure 
%   which is associated with each object displayed.  It contains 
%   information regarding the clips and trims associated with the 
%   object.  This is returned from the function MFWDTRAN.
% 
%   Allowable object strings are 'surface' for map graticules; 
%   'line' for line objects; 'patch' for patch objects; 'light' for
%   light objects; 'text' for text objects; 'none' for no clipping
%   and trimming of input data.
% 
%   [...] = MINVTRAN(mstruct,...) assumes that a valid map 
%   structure is supplied as the first argument.  This structure is
%   used to define the map projection calculation performed.  No
%   map axes need be displayed when using this form.
% 
%   

function vfwdtran
%MATLAB Tour Partial Function Help:  map_con
%
% VFWDTRAN  Transforms vector azimuths to a projection space angle
% 
%   th = VFWDTRAN(lat,lon,az) transforms the azimuth angle at specified 
%   latitude and longitude points on the sphere into the projection space.
%   The map projection currently displayed is used to define the projection
%   space.  The input angles must be in the same units as specified by
%   the current map projection.  The inputs can be scalars or matrices
%   of the equal size. The angle in the projection space is defined 
%   positive counter-clockwise from the x axis.
% 
%   th = VFWDTRAN(mstruct,lat,lon,az) uses the map projection defined by the
%   input mstruct to compute the map projection.
% 
%   [th,len] = VFWDTRAN(...) also returns the vector length in the projected 
%   coordinate system. A value of 1 indicates no scale distortion.
% 
%   This transformation is limited to the region specified by
%   the frame limits in the current map definition.
% 
%   

function vinvtran
%MATLAB Tour Partial Function Help:  map_con
%
% VINVTRAN  Transforms azimuths from a projection space angle
% 
%   az = VINVTRAN(x,y,th) transforms an angle in the projection space at
%   the point specified by x and y  into an azimuth angle in Greenwich
%   coordinates. The map projection currently displayed is used to 
%   define the projection space.  The input angles must be in the same 
%   units as specified by the current map projection.  The inputs can be 
%   scalars or matrices of the equal size. The angle in the projection space
%   angle th is defined positive counter-clockwise from the x axis.
% 
%   az = VINVTRAN(struct,x,y,th) uses the map projection defined by the
%   input struct to compute the map projection.
%  
%   [az,len] = VINVTRAN(...) also returns the vector length in the 
%   Greenwich coordinate system. A value of 1 indicates no scale distortion
%   for that angle.
% 
%   This transformation is limited to the region specified by
%   the frame limits in the current map definition.
% 
%   

function changem
%MATLAB Tour Partial Function Help:  map_con
%
% CHANGEM  Substitutes codes throughout a regular matrix map
% 
%   mapout = CHANGEM(map,newcode) replaces all zero entries
%   in a matrix map with the input newcode.
% 
%   mapout = CHANGEM(map,newcode,oldcode) replaces all occurances
%   of oldcode with newcode.  Both newcode and oldcode inputs may be
%   vectors of equal dimension.
% 
%   

function findm
%MATLAB Tour Partial Function Help:  map_con
%
% FINDM  Lat/lon values of non-zero map entries
% 
%   [lat,lon] = FINDM(map,maplegend) computes the latitude and
%   longitude values of non-zero regular matrix map entries.
% 
%   [lat,lon,val] = FINDM(map,maplegend) also returns the
%   value at the non-zero regular matrix map entries.
% 
%   [...] = FINDM(lat,lon,map) finds the non-zero entries
%   of the general matrix map.  The input lat and lon are
%   vectors corresponding to the rows and columns respectively
%   of the map.
% 
%   mat = FINDM(...) returns a single output, where mat = [lat lon].
% 
%   

function maskm
%MATLAB Tour Partial Function Help:  map_con
%
% MASKM  Substitutes codes based on a specified map mask
% 
%   mapout = MASKM(map,mask) replaces all occurrences of identified
%   by the binary input mask with a NaN.  Both map and mask must be
%   the same dimension.  The input mask must be a binary matrix where
%   the 1's represent the elements to be changed.  Mask can be the
%   result of any logical operation.
% 
%   mapout = MASKM(map,mask,newcode) replaces the identified entries
%   with the supplied newcode.
% 
%   

function resizem
%MATLAB Tour Partial Function Help:  map_con
%
% RESIZEM  Resizes a matrix map
% 
%   map = RESIZEM(map0,m)  resizes the input map by a factor m.
%   map = RESIZEM(map0,[r c]) resizes map0 to a r by c matrix.
% 
%   map = RESIZEM(map0,m,'method') and  map = RESIZEM(map0,[r c],'method')
%   uses 'method' to define the interpolation scheme.  Allowable
%   'method' strings are:  'bilinear' for linear interpolation;
%   'bicubic' for cubic interpolation; and 'nearest' for nearest
%   neighbor interpolation.  For sparse matrices only nearest
%   neighbor interpolation is performed.  For full maps, linear
%   interpolation is the default option.
% 
%   [map,maplegend] = RESIZEM(map0,m,maplegend0) and
%   [map,maplegend] = RESIZEM(map0,m,maplegend0,'method') resizes
%   regular matrix maps and returns the new map and associated
%   map legend.  Only scalar resize factors are allowed for regular
%   matrix maps.
% 
%   When the map size is being reduced, RESIZEM lowpass filters
%   the map before interpolating to avoid aliasing. By default,
%   this filter is designed using FIR1, but can be specified using:
% 
%   RESIZEM(...,'method',h). The default filter is 11-by-11.
%   RESIZEM(...,'method',n) uses an n-by-n filter.
%   RESIZEM(...,'method',0) turns off the filtering.
% 
%   Unless a filter h is specified, RESIZEM will not filter when
%   'nearest' is used.
% 
%   

function country2mtx
%MATLAB Tour Partial Function Help:  map_con
%
% COUNTRY2MTX matrix map for a country in the worldlo database
% 
%  
%    [map,maplegend] = COUNTRY2MTX('countryname',scale) constructs a regular 
%    matrix map of a country in the worldlo POpatch database.  The scale 
%    factor represents the number of matrix entries per degree of latitude and 
%    longitude (eg: 10 entries per degree, 100 entries per degree).  The scale 
%    input must be scalar.  The returned matrix has values of 0 in the 
%    interior of the country, 1 on the border and 2 in the exterior.
%   
%  
%    [map,maplegend] = COUNTRY2MTX('countryname',scale,latlim,lonlim) uses the 
%    two element vector latitude and longitude limits to define the extent of 
%    the map.  If omitted, the limits are computed automatically.  
%    COUNTRY2MTX may not fill properly if the vector data extends beyond a 
%    pole.
%  
%    [map,maplegend] = COUNTRY2MTX('countryname',map1,maplegend1) uses the  
%    limits of the provided map.
%     
%    

function encodem
%MATLAB Tour Partial Function Help:  map_con
%
% ENCODEM  Fills in indexed maps with specified seeds
% 
%   map = ENCODEM(map,seedmat) will flood fill seeds in a
%   matrix map up to specified boundaries.  This process allows
%   indexed maps to be quickly created.  The seed location and value are
%   specified by the input seedmat, which is [row, col, value]
%   output from GETSEEDS.  The flood fill process continues until
%   stop values of 1 are encountered.
% 
%   map = ENCODEM(map,seedmat,stopvals) continues the flood fill
%   process until any value in the input vector stopvals are 
%   encountered.
% 
%   

function getseeds
%MATLAB Tour Partial Function Help:  map_con
%
% GETSEEDS:  Get seed locations and values for encoding maps
% 
%   [row,col,val] = GETSEEDS(map,maplegend,nseeds) allows
%   user to identify geographical objects while customizing a
%   map. It prompts the user for mouse click positions of objects and
%   assigns them a code value.  The user is prompted for the value
%   to seed at each location.  The outputs are the row and column of
%   the seed location and the value assigned at that location.
% 
%   [row,col,val] = GETSEEDS(map,maplegend,nseeds,seedval) assigns
%   the value seedval to each location supplied.  If seedval is a
%   scalar then the same value is assigned at each location.  Otherwise,
%   if seedval is a vector it must be length(nseeds) and each entry
%   is assigned to the corresponding location.  GETSEEDS operates
%   on the current axes (gca).
% 
%   mat = GETSEEDS(...) returns a single output matrix
%   where mat = [row col val].
% 
%   

function imbedm
%MATLAB Tour Partial Function Help:  map_con
%
% IMBEDM  Encodes data points into a regular matrix map
% 
%   map = IMBEDM(lat,long,value,map,maplegend) encodes data
%   points into a regular matrix map.  The input value can
%   be either a scalar which is then used for all lat, long points,
%   or a matrix of the same size as the lat, long points
% 
%   

function limitm
%MATLAB Tour Partial Function Help:  map_con
%
% LIMITM  Latitude and longitude limits for a regular matrix map
% 
%   [lat,lon] = LIMITM(map,maplegend) returns the Greenwich frame
%   latitude  and longitude limits of a regular matrix map.
% 
%   mat = LIMITM(...) returns a single output, where mat = [lat lon].
% 
%   LIMITM activates a Graphical User Interface for the computation
%   of the map limits.
% 
%   

function ltln2val
%MATLAB Tour Partial Function Help:  map_con
%
% LTLN2VAL  Returns map code value associated with positions
% 
%   code = LTLN2VAL(map,maplegend,lat,long) returns a column
%   vector of a map's encoded values corresponding to the points
%   specified by column vectors of latitude and longitude.  The
%   map codes are determined using nearest neighbor interpolation
%   with the input latitude and longitude.
% 
%   code = LTLN2VAL(map,maplegend,lat,long,'method') uses 'method'
%   to specify the interpolation scheme.  Allowable 'method'
%   strings are:  'bilinear' for linear interpolation;
%   'bicubic' for cubic interpolation; and 'nearest' for nearest
%   neighbor interpolation.
% 
%   

function meshgrat
%MATLAB Tour Partial Function Help:  map_con
%
% MESHGRAT  Construct a graticule for a surface map object
% 
%   [lat,lon] = MESHGRAT(map,maplegend) constructs a graticule for
%   a regular surface map object.  A map graticule is the actual points
%   projected, and then the matrix map is warped to the graticule grid.
%   A finer graticule (larger matrices) produces a higher fidelity map.
%   In this form, the default graticule size is equal to the size of
%   the map.
% 
%   [lat,lon] = MESHGRAT(map,maplegend,npts) produces a graticule of
%   size npts.  The npts is a two element vector of the form
%   npts = [# lat grid points, # lon grid points].  If npts = [],
%   then the graticule returned is the Mapping Toolbox default
%   graticule size 50 by 100. If omitted, a graticule of the same 
%   size as map is returned.
% 
%   [lat,lon] = MESHGRAT(lat0,lon0) takes the vectors lat0 and lon0
%   and returns graticule matrices.  In this form, MESHGRAT is similar
%   to MESHGRID.
% 
%   [lat,lon] = MESHGRAT(lat0,lon0,'units') uses the input 'units' to
%   specify the angle units of the input vectors and output matrices.
%   If omitted, 'degrees' are assumed.
% 
%   [lat,lon] = MESHGRAT(latlim,lonlim,npts) returns a graticule
%   mesh dimensioned npts.  The input vectors are two element vectors 
%   specifying the graticule latitude and longitude limits in 
%   degrees. The npts is a two element vector where
%   npts = [# lat grid points, # lon grid points].  If npts = [],
%   then the graticule returned is the Mapping Toolbox default
%   graticule size 50 by 100.
% 
%   [lat,lon] = MESHGRAT(latlim,lonlim,'units') and
%   [lat,lon] = MESHGRAT(latlim,lonlim,npts,'units') uses the input
%   'units' to specify the angle units of the input and output matrices.
%   If omitted, 'degrees' are assumed.
% 
%   

function neworig
%MATLAB Tour Partial Function Help:  map_con
%
% NEWORIG  Transformation of a regular matrix map to a new coordinate system origin
% 
%   [map,lat,lon] = NEWORIG(map0,maplegend,origin) and
%   [map,lat,lon] = neworig(map0,maplegend,origin,'forward') will
%   transform a regular matrix map into an oblique aspect, while
%   preserving the matrix storage format.  In other words, the oblique map
%   origin is not necessarily at (0,0) in the Greenwich coordinate frame.
%   This allows operations to be performed on the matrix representing the
%   oblique map.  For example, azimuthal calculations for a point in a matrix
%   map become row and column operations if the matrix map is
%   transformed so that the north pole of the oblique map represents
%   the desired point on the globe.
% 
%   [map,lat,lon] = neworig(map0,maplegend,origin,'inverse') transforms
%   the regular matrix map from the oblique frame to the Greenwich
%   coordinate frame.
% 
%   

function setltln
%MATLAB Tour Partial Function Help:  map_con
%
% SETLTLN  Computes the lat/lon coordinates given regular matrix row/col
% 
%   [lat,lon] = SETLTLN(map,maplegend,row,col) converts row and column
%   matrix index vectors to the corresponding latitude and longitude
%   positions for the supplied regular matrix map.
% 
%   [lat,lon,badindx] = SETLTLN(...) returns the vector badindx containing
%   the indices of points falling outside the map.
% 
%   mat = SETLTLN(...) returns a single output, where mat = [lat lon].
% 
%    

function setpostn
%MATLAB Tour Partial Function Help:  map_con
%
% SETPOSTN  Converts Greenwich to regular matrix coordinate frame
% 
%   indx = SETPOSTN(map,maplegend,lat,long) converts Greenwich frame
%   lat/long data to the indices of the regular matrix coordinate frame.
%   The input angle data must be in degrees.
% 
%   [row,col] = SETPOSTN(...) returns the indices in row/column format.
% 
%   [row,col,badindx] = SETPOSTN(...) returns the vector badindx containing
%   the indices of points falling outside the map.
% 
%   

function sizem
%MATLAB Tour Partial Function Help:  map_con
%
% SIZEM  Row and column dimension needed for a regular matrix map
% 
%   [r,c] = SIZEM(latlim,lonlim,scale) computes the row and column
%   dimension needed for a regular matrix map.  The inputs are the
%   latitude and longitude limits as 2 element vectors in degrees,
%   and a scale factor.  The scale factor represents the number of
%   matrix entries per single unit of latitude and longitude
%   (eg:  10 entries per degree, 100 entries per radian).  The scale
%   input must be scalar.
% 
%   mat = SIZEM(...) returns a single output, where mat = [r c].
% 
%   [r,c,maplegend] = SIZEM(...) returns the map legend for the
%   sized matrix map.
% 
%   

function vec2mtx	
%MATLAB Tour Partial Function Help:  map_con
%
% VEC2MTX regular matrix map from vector data
%  
%   [map,maplegend] = VEC2MTX(lat,lon,scale) creates a regular matrix map from 
%   vector data.  The returned map has values of one corresponding to the 
%   vector data, and zeros otherwise.  Lat and lon are vectors of equal length 
%   containing geographic locations in units of degrees.  The scale factor 
%   represents the number of matrix entries per single unit of latitude and 
%   longitude (eg: 10 entries per degree, 100 entries per degree).  The scale 
%   input must be scalar.
%  
%   [map,maplegend] = VEC2MTX(lat,lon,scale,latlim,lonlim) uses the two 
%   element vector latitude and longitude limits to define the extent of the 
%   map.  If omitted, the limits are computed automatically.
%  
%   [map,maplegend] = VEC2MTX(lat,lon,map1,maplegend1) uses the provided map 
%   and maplegend to define the extent of the map.  If omitted, the limits 
%   are computed automatically.
%  
%   [...] = VEC2MTX(...,'filled') also fills the area outside the border. The 
%   interior then has values of 0, the border 1 and the exterior 2. Lat and 
%   lon should contain data that closes on itself. VEC2MTX may not fill 
%   properly if the vector data extends beyond a pole.
%   
%   

function nanm
%MATLAB Tour Partial Function Help:  map_con
%
% NANM  Constructs a regular matrix map of all NaNs.
% 
%   map = NANM(latlim,lonlim,scale) constructs a regular matrix
%   map of all NaNs.  The inputs are the latitude and longitude limits
%   as 2 element vectors, and a scale factor.  The latitude and longitude
%   limits are in degrees.  The scale factor represents the number of
%   matrix entries per single unit of latitude and longitude (eg:  10
%   entries per degree, 100 entries per degree).  The scale input must
%   be scalar.
% 
%   [map,maplegend] = NANM(...) returns the maplegend vector for the
%   constructed regular matrix map.
% 
%   

function spzerom
%MATLAB Tour Partial Function Help:  map_con
%
% SPZEROM  Constructs a sparse regular matrix map of all zeros.
% 
%   map = SPZEROM(latlim,lonlim,scale) constructs a sparse regular matrix
%   map of all 0's.  The inputs are the latitude and longitude limits
%   as 2 element vectors, and a scale factor.  The latitude and longitude
%   limits are in degrees.  The scale factor represents the number of
%   matrix entries per single unit of latitude and longitude (eg:  10
%   entries per degree, 100 entries per degree).  The scale input must
%   be scalar.
% 
%   [map,maplegend] = SPZEROM(...) returns the maplegend vector for the
%   constructed regular matrix map.
% 
%   

function onem
%MATLAB Tour Partial Function Help:  map_con
%
% ONEM  Constructs a regular matrix map of all ones.
% 
%   map = ONEM(latlim,lonlim,scale) constructs a regular matrix
%   map of all 1's.  The inputs are the latitude and longitude limits
%   as 2 element vectors, and a scale factor.  The latitude and longitude
%   limits are in degrees.  The scale factor represents the number of
%   matrix entries per single unit of latitude and longitude (eg:  10
%   entries per degree, 100 entries per degree).  The scale input must
%   be scalar.
% 
%   [map,maplegend] = ONEM(...) returns the maplegend vector for the
%   constructed regular matrix map.
% 
%   

function zerom
%MATLAB Tour Partial Function Help:  map_con
%
% ZEROM  Constructs a regular matrix map of all zeros.
% 
%   map = ZEROM(latlim,lonlim,scale) constructs a regular matrix
%   map of all 0's.  The inputs are the latitude and longitude limits
%   as 2 element vectors, and a scale factor.  The latitude and longitude
%   limits are in degrees.  The scale factor represents the number of
%   matrix entries per single unit of latitude and longitude (eg:  10
%   entries per degree, 100 entries per degree).  The scale input must
%   be scalar.
% 
%   [map,maplegend] = ZEROM(...) returns the maplegend vector for the
%   constructed regular matrix map.
% 
%   

function axes2ecc
%MATLAB Tour Partial Function Help:  map_con
%
% AXES2ECC  Computes eccentricity given semimajor and semiminor axes
% 
%   e = AXES2ECC(semimajor,semiminor) computes the eccentricity
%   of an ellipse (or ellipsoid of revolution) given the semimajor
%   and semiminor axes.  The input data can be scalar or matrices
%   of equal dimensions.
% 
%   e = AXES2ECC(vec) assumes a 2 element vector (vec) is supplied,
%   where vec = [semimajor semiminor].
% 
%   

function ecc2flat
%MATLAB Tour Partial Function Help:  map_con
%
% ECC2FLAT  Computes the flattening of an ellipse given an eccentricity
% 
%   f = ECC2FLAT(mat) computes the flattening of an ellipse (or
%   ellipsoid of revolution) given the eccentricity.  If the
%   input is a column vector, then each input is assumed to be an
%   eccentricity.  If the input has two columns, then the second
%   column is assumed to be the eccentricity.  This allows geoid
%   vectors from ALMANAC to be used as inputs.  If the input
%   is an n x m matrix, where m,n > 1, then each element is assumed
%   to be an eccentricity.
% 
%   

function ecc2n
%MATLAB Tour Partial Function Help:  map_con
%
% ECC2N  Computes the parameter n of an ellipse given an eccentricity
% 
%   n = ECC2N(mat) computes the parameter n of an ellipse (or
%   ellipsoid of revolution) given the eccentricity.  n is defined
%   as (a-b)/(a+b), where a = semimajor axis, b = semiminor axis.
%   If the input is a column vector, then each column element is assumed
%   to be an eccentricity.  If the input has two columns, then the
%   second column is assumed to be the eccentricity.  This allows
%   geoid vectors from ALMANAC to be used as inputs.  If the
%   input is a n x m matrix, where m ~= 2, then each element is assumed
%   to be an eccentricity and the corresponding n is calculated.
% 
%   

function flat2ecc
%MATLAB Tour Partial Function Help:  map_con
%
% FLAT2ECC  Computes the eccentricity of an ellipse given a flattening
% 
%   e = FLAT2ECC(mat) computes the eccentricity of an ellipse (or
%   ellipsoid of revolution) given the flattening.  If the
%   input is a column vector, then each input is assumed to be a
%   flattening.  If the input has two columns, then the second
%   column is assumed to be the flattening.  If the input is a
%   n x m matrix, where m ~= 2, then each element is assumed to be a
%   flattening and the corresponding eccentricity is calculated.
% 
%   

function majaxis
%MATLAB Tour Partial Function Help:  map_con
%
% MAJAXIS  Computes semimajor axis given a semiminor axis and an eccentricity
% 
%   a = MAJAXIS(semiminor,e) computes the semimajor axis of an ellipse
%   (or ellipsoid of revolution) given the semiminor axis and eccentricity.
%   The input data can be scalar or matrices of equal dimensions.
% 
%   a = MAJAXIS(vec) assumes a 2 element vector (vec) is supplied,
%   where vec = [semiminor, e].
% 
%   

function minaxis
%MATLAB Tour Partial Function Help:  map_con
%
% MINAXIS  Computes semiminor axis given a semimajor axis and an eccentricity
% 
%   b = MINAXIS(semimajor,e) computes the semiminor axis of an ellipse
%   (or ellipsoid of revolution) given the semimajor axis and eccentricity.
%   The input data can be scalar or matrices of equal dimensions.
% 
%   b = MINAXIS(vec) assumes a 2 element vector (vec) is supplied,
%   where vec = [semimajor, e].
% 
%   

function n2ecc
%MATLAB Tour Partial Function Help:  map_con
%
% N2ECC  Computes the eccentricity of an ellipse given the parameter n
% 
%   e = N2ECC(mat) computes the eccentricity of an ellipse (or
%   ellipsoid of revolution) given the parameter n.  n is defined
%   as (a-b)/(a+b), where a = semimajor axis, b = semiminor axis.
%   If the input is a column vector, then each column element is assumed to be
%   the parameter n.  If the input has two columns, then the second column
%   is assumed to be the parameter n.  If the input is a n x m matrix,
%   where m ~= 2, then each element is assumed to be the parameter n
%   and the corresponding eccentricity is calculated.
% 
%   

function newpole
%MATLAB Tour Partial Function Help:  map_con
%
% NEWPOLE  Computes the origin vector to place a point at the pole
% 
%   origin = NEWPOLE(lat,lon) computes the origin of a map,
%   given the point (lat,lon) which is to become the north pole (90 0)
%   in the transformed map.  The output matrix origin is a valid
%   origin vector and can be used in any function requiring an origin
%   input (such as AXESM or NEWORIG).
% 
%   origin = NEWPOLE(lat,lon,'units') defines the 'units' of the input
%   and output data.  If omitted, 'degrees' are assumed.
% 
%        

function org2pol
%MATLAB Tour Partial Function Help:  map_con
%
% ORG2POL  Computes the location of the north pole in a transformed map
% 
%   pole = ORG2POL(origin) computes the location of the north pole (0,90)
%   in a transformed map.  This determines the location of (0,90) in
%   the coordinate system, which is centered on the origin of the map.
% 
%   The input matrix is of the form origin = [lat, lon] or
%   origin = [lat, lon, orient], where [lat, lon] = the center
%   point of the map and orient = the north pole azimuth measured
%   from the center point.  If orient is omitted, then
%   orient = 0 is assumed.  Lat, lon and orient may be column vectors.
%   The output matrix is of the form pole = [lat, lon, meridian],
%   where [lat,lon] is the location of the north pole in the
%   transformed coordinate system, and meridian is the central meridian
%   from the original map on which the transformed system is centered.
% 
%   pole = ORG2POL(origin,'units') defines the 'units' of the input
%   and output data.  If omitted, 'degrees' are assumed.
% 
%        

function putpole
%MATLAB Tour Partial Function Help:  map_con
%
% PUTPOLE  Computes the origin given where the north pole is to be placed
% 
%   origin = PUTPOLE(polemat) computes the origin of a map, given the
%   location of the north pole (90,0).  This determines the proper
%   orientation vector which will locate the north pole at the specified
%   point in the base coordinate system.
% 
%   The input matrix is of the form pole = [lat, lon, meridian],
%   where [lat,lon] is the location of the north pole in the
%   transformed coordinate system, and meridian is the central meridian
%   from the original map on which the transformed system is centered.
%   If meridian is omitted, then meridian = lon is assumed.  Lat, lon
%   and meridian may be column vectors.  The output matrix is of
%   the form origin = [lat, lon, orient], where [lat, lon] = the center
%   point of the map and orient = the north pole azimuth measured
%   from from the center point.
% 
%   origin = PUTPOLE(polemat,'units') defines the 'units' of the input
%   and output data.  If omitted, 'degrees' are assumed.
% 
%        

function rcurve
%MATLAB Tour Partial Function Help:  map_con
%
% RCURVE  Computes various radii of curvature for an ellispoid
% 
%   r = RCURVE(geoid,lat) computes the parallel radius of curvature
%   for an ellipsoid.  The parallel radius of curvature is the radius
%   of the small circle encompassing the globe at the specified latitude.
%   The input geoid is a standard 2 element geoid vector.  The returned
%   radius r is in the units of the first element of a standard geoid vector.
% 
%   r = RCURVE(geoid,lat,'units')  defines the 'units' of the input
%   latitude data.  If omitted, 'degrees' are assumed.
% 
%   r = RCURVE('parallel',...) also computes the parallel radius of
%   curvature for the ellipsoid.
% 
%   r = RCURVE('meridian',...) computes the meridional radius of
%   curvature for the ellipsoid.  The meridional radius is the
%   radius of curvature at the specified latitude for the ellipse
%   defined a meridian.
% 
%   r = RCURVE('transverse',...) computes the transverse radius of
%   curvature for the ellipsoid.  The transverse radius is the radius
%   of the curve formed by a plane intersecting the ellipsoid at the
%   latitude which is normal to the surface of the ellipsoid.
% 
%   

function rsphere
%MATLAB Tour Partial Function Help:  map_con
%
% RSPHERE  Computes radii for a auxiliary spheres
% 
%   r = RSPHERE('axes',geoid,'method') computes either the biaxial
%   or triaxial average of the semimajor and semiminor axes of
%   the ellipsoid.  If the method string is 'biaxial', then the
%   biaxial average, (a+b)/2, is returned.  If the method string is
%   'triaxial', then the average (2a+b)/3 is returned.  If the method
%   string is omitted, then the biaxial average is computed.
% 
%   r = RSPHERE('eqavol',geoid) computes the radius of the sphere with
%   equal volume as the ellipsoid specified by geoid.
% 
%   r = RSPHERE('authalic',geoid) computes the radius of the sphere with
%   equal surface area as the ellipsoid specified by geoid.
% 
%   r = RSPHERE('rectifying',geoid) computes the radius of the sphere
%   with equal meridional distances as the ellipsoid specified by geoid.
% 
%   r = RSPHERE('curve',geoid) and r = RSPHERE('curve',geoid,lat)
%   computes the arimethic average of the transverse and meridional
%   radii of curvature at the specified latitude point.  If the input
%   lat is omitted, then lat = 45 degrees is assumed.
% 
%   r = RSPHERE('curve',geoid,'method') and r = RSPHERE('curve',...
%   geoid,lat,'method) uses the averaging method specified by the
%   input string 'method' at a the specified latitude.  If lat is omitted,
%   then lat = 45 degrees is assumed.  If method = 'mean', then
%   arimethic averaging is used.  If method = 'norm', then geometric
%   averaging is used.  r = RSPHERE('curve',geoid,lat,'method','units')
%   uses the units specified by 'units' for the input latitude.  If
%   omitted, 'degrees' are assumed.
% 
%   r = RSPHERE('euler',lat1,lon1,lat2,lon2,geoid) computes the Euler
%   radii of curvature at the midpoint of the great circle arc defined
%   by the endpoints (lat1,lon1) and (lat2,lon2).
%   r = RSPHERE('euler',....,'units') uses the units specified by 'units'
%   for the input latitudes and longitudes.  If omitted, 'degrees' are
%   assumed.
% 
%   

function aut2geod
%MATLAB Tour Partial Function Help:  map_con
%
% AUT2GEOD  Converts from authalic latitude to geodetic latitude
% 
%   lat = AUT2GEOD(lat0) converts from the authlic latitude to the
%   geodetic latitude.  The authalic latitude is used to map an
%   ellipsoid to a sphere in such a way that the sphere has equal surface
%   area as the ellipsoid.  Authalic latitudes are used in place of the
%   geodetic latitudes when projecting the ellipsoid using an equal
%   area projection.  The geodetic latitude is the angle that a line
%   perpendicular to the surface of the ellipsoid at the given point makes
%   with the equatorial plane.
% 
%   lat = AUT2GEOD(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = AUT2GEOD(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = AUT2GEOD(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function cen2geod
%MATLAB Tour Partial Function Help:  map_con
%
% CEN2GEOD  Converts from geocentric latitude to geodetic latitude
% 
%   lat = CEN2GEOD(lat0) converts from the geocentric latitude to the
%   geodetic latitude.  The geocentric latitude is the angle made by a
%   line from a point on the surface of the ellipsoid to the center of
%   the ellipsoid and the equatorial plane.  The geodetic latitude is the
%   angle that a line perpendicular to the surface of the ellipsoid at
%   the given point makes with the equatorial plane.
% 
%   lat = CEN2GEOD(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = CEN2GEOD(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = CEN2GEOD(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function cnf2geod
%MATLAB Tour Partial Function Help:  map_con
%
% CNF2GEOD  Converts from conformal latitude to geodetic latitude
% 
%   lat = CNF2GEOD(lat0) converts from the conformal latitude to the
%   geodetic latitude.  The conformal latitude is used to map an
%   ellipsoid conformally onto a sphere. Conformal latitudes are used in
%   place of the geodetic latitudes when projecting the ellipsoid using
%   a conformal projection.  The geodetic latitude is the angle which a
%   line perpendicular to the surface of the ellipsoid at the given point
%   makes with the equatorial plane.
% 
%   lat = CNF2GEOD(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = CNF2GEOD(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = CNF2GEOD(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function geod2aut
%MATLAB Tour Partial Function Help:  map_con
%
% GEOD2AUT  Converts from geodetic latitude to authalic latitude
% 
%   lat = GEOD2AUT(lat0) converts from the geodetic latitude to the
%   authalic latitude.  The authalic latitude is used to map an
%   ellipsoid to a sphere in such a way that the sphere has equal surface
%   area as the ellipsoid.  Authalic latitudes are used in place of the
%   geodetic latitudes when projecting the ellipsoid using an equal
%   area projection.  The geodetic latitude is the angle that a line
%   perpendicular to the surface of the ellipsoid at the given point makes
%   with the equatorial plane.
% 
%   lat = GEOD2AUT(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = GEOD2AUT(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = GEOD2AUT(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function geod2cen
%MATLAB Tour Partial Function Help:  map_con
%
% GEOD2CEN  Converts from geodetic latitude to geocentric latitude
% 
%   lat = GEOD2CEN(lat0) converts from the geodetic latitude to the
%   geocentric latitude.  The geocentric latitude is the angle made by
%   a line from a point on the surface of the ellipsoid to the center
%   of the ellipsoid, and the equatorial plane.  The geodetic latitude
%   is the angle that a line perpendicular to the surface of the
%   ellipsoid at the given point makes with the equatorial plane.
% 
%   lat = GEOD2CEN(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = GEOD2CEN(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = GEOD2CEN(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function geod2cnf
%MATLAB Tour Partial Function Help:  map_con
%
% GEOD2CNF  Converts from geodetic latitude to conformal latitude
% 
%   lat = GEOD2CNF(lat0) converts from the geodetic latitude to the
%   conformal latitude.  The conformal latitude is used to map an
%   ellipsoid conformally onto a sphere. Conformal latitudes are used
%   in place of the geodetic latitudes when projecting the ellipsoid
%   using a conformal projection.  The geodetic latitude is the angle
%   which a line perpendicular to the surface of the ellipsoid at the
%   given point makes with the equatorial plane.
% 
%   lat = GEOD2CNF(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = GEOD2CNF(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = GEOD2CNF(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function geod2iso
%MATLAB Tour Partial Function Help:  map_con
%
% GEOD2ISO  Comutes the isometric latitude given the geodetic latitude
% 
%   lat = GEOD2ISO(lat0) computes the isometric latitude given the
%   geodetic latitude.  The isometric latitude is a nonlinear function
%   of the geodetic latitude.  It is directly proportional to the
%   spacing of parallels of geodetic latitude from the Equator on the
%   ellipsoidal Mercator projection.  The geodetic latitude is the angle
%   which a line perpendicular to the surface of the ellipsoid at the
%   given point makes with the equatorial plane.
% 
%   lat = GEOD2ISO(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = GEOD2ISO(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = GEOD2ISO(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function geod2par
%MATLAB Tour Partial Function Help:  map_con
%
% GEOD2PAR  Converts from geodetic latitude to parametric latitude
% 
%   lat = GEOD2PAR(lat0) converts from the geodetic latitude to the
%   parametric latitude.  The parametric latitude of a point on the
%   ellipsoid is the latitude on a sphere (of radius r = semimajor axis
%   of ellipsoid) for which the parallel has the same radius as the
%   parallel of geodetic latitude.  The geodetic latitude is the angle
%   which a line perpendicular to the surface of the ellipsoid at the
%   given point makes with the equatorial plane.
% 
%   lat = GEOD2PAR(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = GEOD2PAR(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = GEOD2PAR(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function geod2rec
%MATLAB Tour Partial Function Help:  map_con
%
% GEOD2REC  Converts from rectifying latitude to geodetic latitude
% 
%   lat = GEOD2REC(lat0) converts from the geodetic latitude to the
%   rectifying latitude.  The rectifying latitude is used to map an
%   ellipsoid to a sphere in such a way that correct distances along
%   meridians are preserved.  Rectifying latitudes are used in place
%   of the geodetic latitudes when projecting the ellispoid using an
%   equal distant projection.  The geodetic latitude is the angle which
%   a line perpendicular to the surface of the ellipsoid at the given
%   point makes with the equatorial plane.
% 
%   lat = GEOD2REC(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = GEOD2REC(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = GEOD2REC(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   To properly project rectified latitudes, the radius must also
%   be scaled to assure the equal meridional distance property.
%   This is accomplished by RSPHERE.
% 
%   

function iso2geod
%MATLAB Tour Partial Function Help:  map_con
%
% ISO2GEOD  Computes the geodetic latitude given the isometric latitude
% 
%   lat = ISO2GEOD(lat0) computes the geodetic latitude given the
%   isometric latitude.  The isometric latitude is a nonlinear function of
%   the geodetic latitude.  It is directly proportional to the spacing of
%   parallels of geodetic latitude from the Equator on the ellipsoidal Mercator
%   projection.  The geodetic latitude is the angle that a line perpendicular
%   to the surface of the ellipsoid at the given point makes with the equatorial
%   plane.
% 
%   lat = ISO2GEOD(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = ISO2GEOD(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = ISO2GEOD(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function par2geod
%MATLAB Tour Partial Function Help:  map_con
%
% PAR2GEOD  Converts from parametric latitude to geodetic latitude
% 
%   lat = PAR2GEOD(lat0) converts from the parametric latitude to the
%   geodetic latitude.  The parametric latitude of a point on the
%   ellipsoid is the latitude on a sphere (of radius r = semimajor axis
%   of ellipsoid) for which the parallel has the same radius as the
%   parallel of geodetic latitude.  The geodetic latitude is the angle
%   which a line perpendicular to the surface of the ellipsoid at the
%   given point makes with equatorial plane.
% 
%   lat = PAR2GEOD(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from the ALMANAC
%   function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = PAR2GEOD(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = PAR2GEOD(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function rec2geod
%MATLAB Tour Partial Function Help:  map_con
%
% REC2GEOD  Converts from rectifying latitude to geodetic latitude
% 
%   lat = REC2GEOD(lat0) converts from the rectifying latitude to the
%   geodetic latitude.  The rectifying latitude is used to map an
%   ellipsoid to a sphere in such a way that correct distances along
%   meridians are preserved.  Rectifying latitudes are used in place
%   of the geodetic latitudes when projecting the ellipsoid using an
%   equal distant projection.  The geodetic latitude is the angle that
%   a line perpendicular to the surface of the ellipsoid at the given
%   point makes with the equatorial plane.
% 
%   lat = REC2GEOD(lat0,geoid) uses the ellipsoid definition given in
%   the input vector geoid.  Geoid can be determined from an appropriate
%   data almanac function.  If omitted, the default Earth geoid is assumed.
% 
%   lat = REC2GEOD(lat0,'units') uses the units defined by the input string
%   'units'.  If omitted, default units of degrees are assumed.
% 
%   lat = REC2GEOD(lat0,geoid,'units') uses the geoid and 'units'
%   definitions provided by the corresponding inputs.
% 
%   

function eastof
%MATLAB Tour Partial Function Help:  map_con
%
% EASTOF wraps longitudes to values east of a meridian
%  
%    ang = EASTOF(angin,meridian) transforms input angles into equivalent 
%    angles east of the specified meridian.
%    
%    ang = EASTOF(angin,meridian,'units') uses the units defined by the input 
%    string 'units'.  If omitted, default units of 'degrees' are assumed.
%    
%    

function npi2pi
%MATLAB Tour Partial Function Help:  map_con
%
% NPI2PI Truncates angles into the -180 deg to 180 deg range
% 
% 
%   ang = NPI2PI(angin) transforms input angles into the
%   -180 to 180 degree range.
% 
%   ang = NPI2PI(angin,'units') uses the units defined by the
%   input string 'units'.  If omitted, default units of 'degrees'
%   are assumed.
% 
%   ang = NPI2PI(angin,'units','method') uses the method
%   defined by the corresponding input string.  Valid methods are:
%   'exact' for the exact transformation; 'inward' where all angles
%   are shifted epsilon towards the origin before the -180 to 180 degree
%   transformation; 'outward' where all angles are shifted epsilon
%   away from the origin before the -180 to 180 degree transformation.
%   If omitted, default method of 'exact' is assumed.
% 
%   

function smoothlong
%MATLAB Tour Partial Function Help:  map_con
%
% SMOOTHLONG remove discontinuities in longitude data
% 
%   ang = SMOOTHLONG(angin) removes discontinuities in longitude data.  The 
%   resulting angles may cover more than one revolution.
%  
%   ang = SMOOTHLONG(angin,'units') uses the units defined by the input string 
%   'units'.  If omitted, default units of 'degrees' are assumed.
% 
%  

function westof
%MATLAB Tour Partial Function Help:  map_con
%
% WESTOF wraps longitudes to values west of a meridian
%  
%    ang = WESTOF(angin,meridian) transforms input angles into equivalent 
%    angles west of the specified meridian.
%    
%    ang = WESTOF(angin,meridian,'units') uses the units defined by the input 
%    string 'units'.  If omitted, default units of 'degrees' are assumed.
%    
%    

function zero22pi
%MATLAB Tour Partial Function Help:  map_con
%
% ZERO22PI Truncates angles into the 0 deg to 360 deg range
% 
%   ang = ZERO22PI(angin) transforms input angles into the
%   0 to 360 degree range.
% 
%   ang = ZERO22PI(angin,'units') uses the units defined by the
%   input string 'units'.  If omitted, default units of 'degrees'
%   are assumed.
% 
%   ang = ZERO22PI(angin,'units','method') uses the method
%   defined by the corresponding input string.  Valid methods are:
%   'exact' for the exact transformation; 'inward' where all angles
%   are shifted epsilon towards the origin before the 0 to 360 degree
%   transformation; 'outward' where all angles are shifted epsilon
%   away from the origin before the 0 to 360 degree transformation.
%   If omitted, default method of 'exact' is assumed.
% 
%   

function angledim
%MATLAB Tour Partial Function Help:  map_con
%
% ANGLEDIM  Converts angles from one unit system to another
% 
%   ang = ANGLEDIM(angin,'from','to') converts angles between
%   recognized units.  Input and output units are entered as strings.
%   This function allows access to all angle conversions based upon input
%   unit strings.  Allowable units string are:  'degrees' or 'deg' for
%   degrees; 'dm' for deg:min; 'dms' for deg:min:sec;  'radians' or
%   'rad' for radians.
% 
%   

function deg2dm
%MATLAB Tour Partial Function Help:  map_con
%
% DEG2DM  Converts angles from degrees to deg:min vector format
% 
%   dm = DEG2DM(deg) converts angles from degrees to deg:min vector
%   format.  The angle is rounded to the nearest minute.
% 
%   

function deg2dms
%MATLAB Tour Partial Function Help:  map_con
%
% DEG2DMS Converts angles from degrees to deg:min:sec vector format
% 
%   dms = DEG2DM(deg) converts angles from degrees to deg:min:sec vector
%   format.
% 
%   

function deg2rad
%MATLAB Tour Partial Function Help:  map_con
%
% DEG2RAD Converts angles from degrees to radians
% 
%   rad = DEG2RAD(deg) converts angles from degrees to radians.
% 
%   

function dms2deg
%MATLAB Tour Partial Function Help:  map_con
%
% DMS2DEG Converts angles from deg:min:sec to degrees
% 
%   deg = DMS2DEG(dms) converts from the deg:min:sec vector format
%   to degrees.
% 
%   deg = DMS2DEG(d,m,s) converts from degree (d), minute (m) and
%   second (s) format to degrees.  The input matrices d, m and s must
%   be of equal size.  Minutes and seconds must be between 0 and 60.
% 
%   

function dms2dm
%MATLAB Tour Partial Function Help:  map_con
%
% DMS2DM Converts angles from deg:min:sec to deg:min vector format
% 
%   dm = DMS2DM(dms) converts from the deg:min:sec vector format
%   to deg:min vector format.  Seconds are rounded to the nearest
%   minute.
% 
%   

function dms2mat
%MATLAB Tour Partial Function Help:  map_con
%
% DMS2MAT Converts a dms vector format to a [deg min sec] matrix
% 
%   [d,m,s] = DMS2MAT(dms) converts a dms vector format to a
%   deg:min:sec matrix.  The vector format is dms = 100*deg + min + sec/100.
%   This allows compressed dms data to be expanded to a d,m,s triple,
%   for easier reporting and viewing of the data.
% 
%   [d,m,s] = DMS2MAT(dms,n) uses n digits in the accuracy of the
%   seconds calculation.  n = -2 uses accuracy in the hundredths position,
%   n = 0 uses accuracy in the units position.  Default is n = -5.
%   For further discussion of the input n, see ROUNDN.
% 
%   mat = DMS2MAT(...) returns a single output argument of mat = [d m s].
%   This is useful only if the input dms is a single column vector.
% 
%   

function dms2rad
%MATLAB Tour Partial Function Help:  map_con
%
% DMS2RAD Converts angles from deg:min:sec to radians
% 
%   rad = DMS2RAD(dms) converts from the deg:min:sec vector format
%   to radians.
% 
%   rad = DMS2RAD(d,m,s) converts from degree (d), minute (m) and
%   second (s) format to radians.  The input matrices d, m and s must
%   be of equal size.  Minutes and seconds must be between 0 and 60.
% 
%   

function mat2dms
%MATLAB Tour Partial Function Help:  map_con
%
% MAT2DMS Converts a [deg min sec] matrix to vector format
% 
%   dms = MAT2DMS(d,m,s) converts a deg:min:sec matrix into a vector
%   format.  The vector format is dms = 100*deg + min + sec/100.
%   This allows d,m,s triple to be compressed into a single value,
%   which can then be employed similar to a degree or radian vector.
%   The inputs d, m and s must be of equal size.  Minutes and
%   second must be between 0 and 60.
% 
%   dms = MAT2DMS(mat) assumes and input matrix of [d m s].  This is
%   useful only for single column vectors for d, m and s.
% 
%   dms = MAT2DMS(d,m) and dms = MAT2DMS([d m]) assume that seconds
%   are zero, s = 0.
% 
%   dms = MAT2DMS(d,m,s,n) uses n as the accuracy of the seconds
%   calculation.  n = -2 uses accuracy in the hundredths position,
%   n = 0 uses accuracy in the units position.  Default is n = -5.
%   For further discussion of the input n, see ROUNDN.
% 
%   

function rad2deg
%MATLAB Tour Partial Function Help:  map_con
%
% RAD2DEG Converts angles from radians to degrees
% 
%   deg = RAD2DEG(rad) converts angles from radians to degrees.
% 
%   

function rad2dm
%MATLAB Tour Partial Function Help:  map_con
%
% RAD2DM Converts angles from radians to deg:min vector format
% 
%   dm = RAD2DM(rad) converts angles from radians to deg:min vector
%   format.  The angle is rounded to the nearest minute.
% 
%   

function rad2dms
%MATLAB Tour Partial Function Help:  map_con
%
% RAD2DMS Converts angles from radians to deg:min:sec vector format
% 
%   dms = RAD2DMS(rad) converts angles from radians to deg:min:sec vector
%   format.
% 
%   

function hms2hm
%MATLAB Tour Partial Function Help:  map_con
%
% HMS2HM Converts time from hrs:min:sec to hr:min vector format
% 
%   hm = HMS2HM(hms) converts time from the hrs:min:sec vector format
%   to hrs:min vector format.  Seconds are rounded to the nearest
%   minute.
% 
%   

function hms2hr
%MATLAB Tour Partial Function Help:  map_con
%
% HMS2HR Converts time from hrs:min:sec to hours
% 
%   hr = HMS2HR(hms) converts time from the hrs:min:sec vector format
%   to hours.
% 
%   hr = HMS2HR(h,m,s) converts time from hours (h), minute (m) and
%   second (s) format to degrees.  The input matrices h, m and s must
%   be of equal size.  Minutes and seconds must be between 0 and 60.
% 
%   

function hms2mat
%MATLAB Tour Partial Function Help:  map_con
%
% HMS2MAT Converts a hms vector format to a [hrs min sec] matrix
% 
%   [h,m,s] = HMS2MAT(hms) converts a hms vector format to a
%   hrs:min:sec matrix.  The vector format is hms = 100*hrs + min + sec/100.
%   This allows compressed hms data to be expanded to a h,m,s triple,
%   for easier reporting and viewing of the data.
% 
%   [h,m,s] = HMS2MAT(hms,n) uses n digits in the accuracy of the
%   seconds calculation.  n = -2 uses accuracy in the hundredths position,
%   n = 0 uses accuracy in the units position.  Default is n = -5.
%   For further discussion of the input n, see ROUNDN.
% 
%   mat = HMS2MAT(...) returns a single output argument of mat = [h m s].
%   This is useful only if the input hms is a single column vector.
% 
%        

function hms2sec
%MATLAB Tour Partial Function Help:  map_con
%
% HMS2SEC Converts time from hrs:min:sec to seconds
% 
%   sec = HMS2SEC(hms) converts time from the hrs:min:sec vector format
%   to seconds.
% 
%   sec = HMS2SEC(h,m,s) converts time from hours (h), minute (m) and
%   second (s) format to degrees.  The input matrices h, m and s must
%   be of equal size.  Minutes and seconds must be between 0 and 60.
% 
%   

function hr2hm
%MATLAB Tour Partial Function Help:  map_con
%
% HR2HM Converts time from hours to hrs:min format
% 
%   hm = HR2HM(hr) converts times from hours to hrs:min vector format.
% 
%   

function hr2hms
%MATLAB Tour Partial Function Help:  map_con
%
% HR2HMS Converts time from hours to hrs:min:sec vector format
% 
%   hms = HR2HMS(hr) converts time from hours to hrs:min:sec
%   vector format.
% 
%   

function hr2sec
%MATLAB Tour Partial Function Help:  map_con
%
% HR2SEC Converts time from hours to seconds
% 
%   sec = HR2SEC(hr) converts time from hours to seconds.
% 
%   

function mat2hms
%MATLAB Tour Partial Function Help:  map_con
%
% MAT2HMS Converts a [hrs min sec] matrix to vector format
% 
%   hms = MAT2HMS(h,m,s) converts a hrs:min:sec matrix into a vector
%   format.  The vector format is hms = 100*hrs + min + sec/100.
%   This allows h,m,s triple to be compressed into a single value,
%   which can then be employed similar to a second or hour vector.
%   The inputs h, m and s must be of equal size.  Minutes and
%   second must be between 0 and 60.
% 
%   hms = MAT2HMS(mat) assumes and input matrix of [h m s].  This is
%   useful only for single column vector for h, m and s.
% 
%   hms = MAT2HMS(h,m) and hms = MAT2HMS([h m]) assume that seconds
%   are zero, s = 0.
% 
%   hms = MAT2HMS(h,m,s,n) uses n as the accuracy of the seconds
%   calculation.  n = -2 uses accuracy in the hundredths position,
%   n = 0 uses accuracy in the units position.  Default is n = -5.
%   For further discussion of the input n, see ROUNDN.
% 
%   

function sec2hm
%MATLAB Tour Partial Function Help:  map_con
%
% SEC2HM Converts time from seconds to hrs:min vector format
% 
%   hm = SEC2HMS(sec) converts time from seconds to hrs:min vector format.
% 
%   

function sec2hms
%MATLAB Tour Partial Function Help:  map_con
%
% SEC2HMS Converts time from seconds to hrs:min:sec vector format
% 
%   hms = SEC2HMS(sec) converts time from seconds to hrs:min:sec
%   vector format.
% 
%   

function sec2hr
%MATLAB Tour Partial Function Help:  map_con
%
% SEC2HR Converts time from seconds to hours
% 
%   hr = SEC2HR(sec) converts time from seconds to hours.
% 
%   

function timedim
%MATLAB Tour Partial Function Help:  map_con
%
% TIMEDIM  Converts times from one unit system to another
% 
%   t = TIMEDIM(tin,'from','to') converts times between
%   recognized units.  Input and output units are entered as strings.
%   This function allows access to all time conversions based upon input
%   unit strings.  Allowable units strings are:  'hm' for hms:min;
%   'hms' for hms:min:sec; 'hours' or 'hr' for hours;
%   'seconds' or 'sec' for seconds.
% 
%   

function deg2km
%MATLAB Tour Partial Function Help:  map_con
%
% DEG2KM Converts distances from degrees to kilometers
% 
%   km = DEG2KM(deg) converts distances from degrees to kilometers.
%   A degree of distance is measured along a great circle of a sphere.
% 
%   km = DEG2KM(deg,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in kilometers.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function deg2nm
%MATLAB Tour Partial Function Help:  map_con
%
% DEG2NM Converts distances from degrees to nautical miles
% 
%   nm = DEG2NM(deg) converts distances from degrees to nautical miles.
%   A degree of distance is measured along a great circle of a sphere.
% 
%   nm = DEG2NM(deg,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in nautical miles.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function deg2sm
%MATLAB Tour Partial Function Help:  map_con
%
% DEG2SM Converts distances from degrees to statute miles
% 
%   sm = DEG2SM(deg) converts distances from degrees to statute miles.
%   A degree of distance is measured along a great circle of a sphere.
% 
%   sm = DEG2SM(deg,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in statute miles.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function distdim
%MATLAB Tour Partial Function Help:  map_con
%
% DISTDIM  Converts distances from one unit system to another
% 
%   d = DISTDIM(din,'from','to') converts distances between
%   recognized units.  Input and output units are entered as strings.
%   This function allows access to all angle conversions based upon input
%   unit strings.  Allowable units string are:  'degrees' or 'deg' for
%   degrees; 'kilometers' or 'km' for kilometers; 'nauticalmiles' or
%   'nm'  for nautical miles; 'radians' or 'rad' for radians;
%   'statutemiles', 'sm', 'miles'  or 'mi'  for statute miles;
%   'meters' or 'm' for meters; 'feet' or 'ft' for feet.
% 
%   d = DISTDIM(din,'from','to',radius) uses the third input to determine
%   the radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in appropriate units.
%   If omitted, the default radius of the Earth is used.
% 
%   

function km2deg
%MATLAB Tour Partial Function Help:  map_con
%
% KM2DEG Converts distances from kilometers to degrees
% 
%   deg = KM2DEG(km) converts distances from kilometers to degrees.
%   A degree of distance is measured along a great circle of a sphere.
% 
%   deg = KM2DEG(km,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in kilometers.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function km2nm
%MATLAB Tour Partial Function Help:  map_con
%
% KM2NM Converts distances from kilometers to nautical miles
% 
%   nm = KM2NM(km) converts distances from kilometers to nautical miles.
% 
%   

function km2rad
%MATLAB Tour Partial Function Help:  map_con
%
% KM2RAD Converts distances from kilometers to radians
% 
%   rad = KM2RAD(km) converts distances from kilometers to radians.
%   A radian of distance is measured along a great circle of a sphere.
% 
%   rad = KM2RAD(km,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in kilometers.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function km2sm
%MATLAB Tour Partial Function Help:  map_con
%
% KM2SM Converts distances from kilometers to statute miles
% 
%   sm = KM2SM(km) converts distances from kilometers to statute miles.
% 
%   

function nm2deg
%MATLAB Tour Partial Function Help:  map_con
%
% NM2DEG Converts distances from nautical miles to degrees
% 
%   deg = NM2DEG(nm) converts distances from nautical miles to degrees.
%   A degree of distance is measured along a great circle of a sphere.
% 
%   deg = NM2DEG(nm,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in nautical miles.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function nm2km
%MATLAB Tour Partial Function Help:  map_con
%
% NM2KM Converts distances from nautical miles to kilometers
% 
%   km = NM2KM(nm) converts distances from nautical miles to kilometers.
% 
%   

function nm2rad
%MATLAB Tour Partial Function Help:  map_con
%
% NM2RAD Converts distances from nautical miles to radians
% 
%   rad = NM2RAD(nm) converts distances from nautical miles to radians.
%   A radian of distance is measured along a great circle of a sphere.
% 
%   rad = NM2RAD(nm,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in nautical miles.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function nm2sm
%MATLAB Tour Partial Function Help:  map_con
%
% NM2SM Converts distances from nautical miles to statute miles
% 
%   sm = NM2SM(nm) converts distances from nautical miles to statute miles.
% 
%   

function rad2km
%MATLAB Tour Partial Function Help:  map_con
%
% RAD2KM Converts distances from radians to kilometers
% 
%   km = RAD2KM(rad) converts distances from radians to kilometers.
%   A radian of distance is measured along a great circle of a sphere.
% 
%   km = RAD2KM(rad,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in kilometers.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function rad2nm
%MATLAB Tour Partial Function Help:  map_con
%
% RAD2NM Converts distances from radians to nautical miles
% 
%   nm = RAD2NM(rad) converts distances from radians to nautical miles.
%   A radian of distance is measured along a great circle of a sphere.
% 
%   nm = RAD2NM(rad,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in nautical miles.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function rad2sm
%MATLAB Tour Partial Function Help:  map_con
%
% RAD2SM Converts distances from radians to statute miles
% 
%   sm = RAD2SM(rad) converts distances from radians to statute miles.
%   A radian of distance is measured along a great circle of a sphere.
% 
%   sm = RAD2SM(rad,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in statute miles.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function sm2deg
%MATLAB Tour Partial Function Help:  map_con
%
% SM2DEG Converts distances from statute miles to degrees
% 
%   deg = SM2DEG(sm) converts distances from statute miles to degrees.
%   A degree of distance is measured along a great circle of a sphere.
% 
%   deg = SM2DEG(sm,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in statute miles.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function sm2km
%MATLAB Tour Partial Function Help:  map_con
%
% SM2KM Converts distances from statute miles to kilometers
% 
%   km = SM2KM(sm) converts distances from statute miles to kilometers.
% 
%   

function sm2nm
%MATLAB Tour Partial Function Help:  map_con
%
% SM2NM Converts distances from statute miles to nautical miles
% 
%   nm = SM2NM(sm) converts distances from statute miles to nautical miles.
% 
%   

function sm2rad
%MATLAB Tour Partial Function Help:  map_con
%
% SM2RAD Converts distances from statute miles to radians
% 
%   rad = SM2RAD(sm) converts distances from statute miles to radians.
%   A radian of distance is measured along a great circle of a sphere.
% 
%   rad = SM2RAD(sm,radius) uses the second input to determine the
%   radius of the sphere.  If radius is a string, then it is evaluated
%   as an ALMANAC body to determine the spherical radius.  If numerical,
%   it is the radius of the desired sphere in statute miles.  If omitted,
%   the default radius of the Earth is used.
% 
%   

function angl2str
%MATLAB Tour Partial Function Help:  map_con
%
% ANGL2STR  Angle conversion to a string
% 
%   str = ANGL2STR(ang) converts a numerical vector of angles to
%   a string matrix.  The output string matrix is useful for the
%   display of angles.
% 
%   str = ANGL2STR(ang,'format') uses the specified format input
%   to construct the string matrix.  Allowable format strings are
%   'ew' for east/west notation; 'ns' for north/south notation;
%   'pm' for plus/minus notation; and 'none' for blank/minus notation.
%   If omitted or blank, 'none' is assumed.
% 
%   str = ANGL2STR(ang,'format','units') defines the units in which
%   the input angles are supplied.  This string also controls the
%   units in which the string matrix is constructed.  Any valid
%   angle units string can be entered.  If omitted or blank,
%   'degrees' are assumed.
% 
%   str = ANGL2STR(ang,'format',digits) uses the input digits to
%   determine the number of decimal digits in the output matrix.
%   n = -2 uses accuracy in the hundredths position, n = 0 uses
%   accuracy in the units position.  Default is n = -2.  For further
%   discussion of the input n, see ROUNDN.
% 
%   str = ANGL2STR(ang,'format','units',digits) uses all the inputs
%   to construct the output string matrix.
% 
%   

function dist2str
%MATLAB Tour Partial Function Help:  map_con
%
% DIST2STR  Distance conversion to a string
% 
%   str = DIST2STR(dist) converts a numerical vector of distances to
%   a string matrix.  The output string matrix is useful for the
%   display of distances.
% 
%   str = DIST2STR(dist,'format') uses the specified format input
%   to construct the string matrix.  Allowable format strings are
%   'pm' for plus/minus notation; and 'none' for blank/minus notation.
%   If omitted or blank, 'none' is assumed.
% 
%   str = DIST2STR(dist,'format','units') defines the units which
%   the input distances are supplied.  This string also controls the
%   units in which the string matrix is constructed.  Any valid
%   distance units string can be entered.  If omitted or blank,
%   'kilometers' is assumed.
% 
%   str = DIST2STR(dist,'format',digits) uses the input digits to
%   determine the number of decimal digits in the output matrix.
%   n = -2 uses accuracy in the hundredths position, n = 0 uses
%   accuracy in the units position.  Default is n = -2.  For further
%   discussion of the input n, see ROUNDN.
% 
%   str = DIST2STR(dist,'format','units',digits) uses all the inputs
%   to construct the output string matrix.
% 
%   

function time2str
%MATLAB Tour Partial Function Help:  map_con
%
% TIME2STR  Time conversion to a string
% 
%   str = TIME2STR(t) converts a numerical vector of times to
%   a string matrix.  The output string matrix is useful for the
%   display of times.
% 
%   str = TIME2STR(t,'clock') uses the specified clock input to
%   construct the string matrix.  Allowable clock strings are
%   '12' for a regular 12 hour clock (AM and PM);  '24' for a
%   regular 24 hour clock; and 'nav' for a navigational hour clock.
%   If omitted or blank, '24' is assumed.
% 
%   str = TIME2STR(t,'clock','format') uses the specified format input
%   to construct the string matrix.  Allowable format strings are
%   'hm' for hours and minutes; and 'hms' for hours, minutes
%   and seconds.  If omitted or blank, 'hm' is assumed.
% 
%   str = TIME2STR(t,'clock','format','units') defines the units which
%   the input times are supplied.  Any valid time units string can be
%   entered.  If omitted or blank, 'hours' is assumed.
% 
%   str = TIME2STR(t,'clock','format',digits) uses the input digits to
%   determine the number of decimal digits in the output matrix.
%   n = -2 uses accuracy in the hundredths position, n = 0 uses
%   accuracy in the units position.  Default is n = 0.  For further
%   discussion of the input n, see ROUNDN.
% 
%   str = TIME2STR(t,'clock','format','units',digits) uses all the inputs
%   to construct the output string matrix.
% 
%   

function unitstr
%MATLAB Tour Partial Function Help:  map_con
%
% UNITSTR  Tests for valid unit string or abbreviations
% 
%   UNITSTR displays a list of recognized unit string in
%   the Mapping Toolbox.
% 
%   str = UNITSTR('str0','measstr') tests for valid unit strings or
%   abbreviations.  If a string or abbreviation is found, then the output
%   string is set to the corresponding preset string.
% 
%   The second input to determine the measurement system to be used.
%   Allowable strings are 'angles' for angle unit checks;  'distances'
%   for distance unit checks; and 'time' for time unit checks.
% 
%   [str,msg] = UNITSTR(...) returns the string describing any error
%   condition encountered.
% 
%   

function usamap
%MATLAB Tour Partial Function Help:  map_con
%
% USAMAP creates a map of the United States of America
%   
%    USAMAP creates a map of all or some of the United States of America.  The 
%    state or states are selected interactively from a list.  A map axes and 
%    map is created in the current axes.  The AXIS limits are set tight around 
%    the map frame.
%   
%    h = USAMAP('ALL') or USAMAP ALL creates a standard map of the U.S.A. The 
%    conterminous states, Alaska and Hawaii are each displayed as insets in 
%    different axes using projection parameters suggested by the U.S. 
%    Geological Survey.  The handles for the three map axes are returned in h.  
%    h(1) contains the conterminous states, h(2) Alaska, and h(3) Hawaii.
%   
%    USAMAP ALLEQUAL creates the map with Alaska and Hawaii at the same scale 
%    as the conterminous states.  
%   
%    USAMAP CONUS maps only the conterminous states.
%   
%    USAMAP STATE or USAMAP('STATE') maps the requested state.  Example: 
%    USAMAP vermont.  STATE may also be a padded string matrix or a cell array 
%    of strings containing multiple state names.  
%    
%    USAMAP STATEONLY maps only that state.  Example: USAMAP vermontonly.
%    If any of the country names in a STATE string matrix or cell array of 
%    strings end with 'only', only the requested countries are displayed.
%   
%    USAMAP('STATE','TYPE') controls the atlas data displayed.  Type 'line' or 
%    'patch' creates a map with atlas data of those types and text annotation 
%    of the state names.  Type 'lineonly' or 'patchonly' suppresses text 
%    annotation.  Type 'none' suppresses all atlas data.  If omitted, type 
%    'patch' is assumed.
%    
%    USAMAP(latlim,lonlim) creates a map of the states covering the provided 
%    latitude and longitude limits.  The limits are two-element vectors in units 
%    of degrees.
%   
%    USAMAP(map,maplegend) and USAMAP(map,maplegend,'TYPE') use the supplied 
%    regular matrix map to define the geographic limits. The matrix map is displayed
%    using MESHM unless type is 'none', 'lineonly', 'patch' or 'patchonly'. Use type
%    'meshonly' to display only the matrix map.
% 
%    USAMAP(latlim,lonlim,'TYPE') is also a valid calling form.
%  
%    h = USAMAP(...)  returns the handle or handles of the axes containing the 
%    map
%    
%    USAMAP uses TIGHTMAP set the axis limits tight around the map. If you change 
%    the projection, or just want more white space around the map frame, use TIGHTMAP
%    again or AXIS AUTO.
% 
%    

function worldmap
%MATLAB Tour Partial Function Help:  map_con
%
% WORLDMAP maps a country or region using the WORLDLO atlas data
%   
%    WORLDMAP maps a region or country using the WORLDLO atlas data. The region 
%    is selected interactively from a list. The map is created in the current
%    axes. 
%   
%    WORLDMAP REGION or WORLDMAP('REGION') makes a map of the specified 
%    region.  Recognized region strings are 'Africa', 'Antarctica', 'Asia', 
%    'Europe',.  'North America', 'North Pole', 'Pacific', 'South America', 
%    'South Pole', 'World' and the names of the countries in the WORLDLO atlas 
%    data.  REGION may also be a padded string matrix or a cell array of strings 
%    containing multiple country names.
%    
%    WORLDMAP REGIONONLY adds only the specified country to the map.  For 
%    example, WORLDMAP italyonly.  If any of the country names in REGION string 
%    matrix or cell array of strings end with 'only', only the requested 
%    countries are displayed.
%   
%    WORLDMAP('REGION','TYPE') controls the atlas data displayed. Type 'line' or
%    'patch' creates a map with atlas data of those types. If the size of the map
%    permits, point and text annotation of countries and cities is included'. 
%    Type 'lineonly' or 'patchonly' suppresses the point and text annotation.
%    Type 'none' suppresses all atlas data. If omitted, type 'line' is assumed.
%   
%    WORLDMAP(latlim,lonlim) and WORLDMAP(latlim,lonlim,'TYPE') use the supplied
%    geographic limits to define the map. The geographic limits are two-element 
%    vectors of the form [start end], in angular units of degrees. 
%   
%    WORLDMAP(map,maplegend) and WORLDMAP(map,maplegend,'TYPE') use the supplied
%    regular matrix map to define the geographic limits. The matrix map is displayed
%    using MESHM unless type is 'none', 'lineonly', 'patch' or 'patchonly'. Use type
%    'meshonly' to display only the matrix map.
%   
%    h = WORLDMAP(...) returns the handle of the map axes.
%   
%    WORLDMAP uses TIGHTMAP set the axis limits tight around the map. If you change 
%    the projection, or just want more white space around the map frame, use TIGHTMAP
%    again or AXIS AUTO.
%   
%    

function axesm
%MATLAB Tour Partial Function Help:  map_con
%
% AXESM  Map axes definition and property settings
% 
%   AXESM activates a GUI to define a map projection for the
%   current axes.
% 
%   AXESM('PropertyName',PropertyValue,...) uses the map properties
%   in the input list to define a map projection for the current axes.
%   For a list of map projection properties, execute GETM AXES.  All
%   standard (non-mapping) axes properties are controlled using the
%   axes command.  For a list of available projections, execute
%   GETM MAPPROJECTION.
% 
%   AXESM(mstruct,...) uses the map structure specified by mstruct
%   to initialize the map projection.
% 
%   AXESM('ProjectionFile',...) uses the m-file specified by
%   'ProjectionFile' to initialize the map projection.  If this form
%   is used, the input string 'ProjectionFile' must correspond to an
%   m-file on the user's path.  The m-file name must correspond in
%   case to how 'ProjectionFile' is typed.
% 
%   

function gcm
%MATLAB Tour Partial Function Help:  map_con
%
% GCM  Get the map projection structure from an axes
% 
%   GCM will return the map projection data structure from the
%   current axes (gca).  If the current axes does not contain a
%   map definition, then an error results.
% 
%   GCM(hndl) returns the map structure from the axes specified
%   by the input hndl.
% 
%   [m,msg] = GCM(...) returns an optional second argument
%   which is a string indicating any error state.
% 
%   

function ismap
%MATLAB Tour Partial Function Help:  map_con
%
% ISMAP  Test for current map axes
% 
%   ISMAP returns a 1 if the current axes (gca) have the proper
%   tag and structure for a map definition.  Otherwise, it
%   returns a 0.
% 
%   ISMAP(hndl) tests the axes specified by hndl for a map definition.
% 
%   [m,msg] = ISMAP(...) returns an optional second argument
%   which is a string indicating any error state.
% 
%   

function ismapped
%MATLAB Tour Partial Function Help:  map_con
%
% ISMAPPED  Test if object is projected on a map axes
% 
%   ISMAPPED returns a 1 if the current object (gco) is projected on
%   a map axes.  Otherwise it returns a 0.
% 
%   ISMAPPED(hndl) tests the object specified by hndl.
% 
%   [m,msg] = ISMAPPED(...) returns an optional second argument
%   which is a string indicating any error state.
% 
%   

function maps
%MATLAB Tour Partial Function Help:  map_con
%
% MAPS  Lists available map projections and verifies id strings
% 
%   MAPS lists the available map projections.
% 
%   s = MAPS IDLIST returns the list of all available map
%   projection id strings.
% 
%   s = MAPS NAMELIST returns the list of all available map
%   projection names.
% 
%   s = MAPS CLASSCODES returns the list of codes for the projection
%   classes of all available maps projections.
% 
%   str = MAPS('str') verifies and standardizes the map projection
%   id string.
% 
%   [str,msg] = MAPS(...) returns the string indicating any error
%   condition encountered.
% 
%   

function project
%MATLAB Tour Partial Function Help:  map_con
%
% PROJECT  Projects existing graphics objects onto a map axes
% 
%   PROJECT(h) will take existing displayed graphics objects (lines,
%   surfaces, etc) specified by the input handles h and project the
%   data onto a map axes.  The existing objects must be displayed on a
%   valid map axes, but not projected using the map definition data.
%   For example, PROJECT will take data displayed using the PLOT command
%   and re-display it on a map as if it were plotted using the PLOTM
%   command.  If a scalar axis handle is provided, then all the children
%   of the axes are projected.
% 
%   PROJECT(h,'option') uses the option string to specify the relationship
%   between x,y data and latitude, longitude data.  'xy' defines x
%   data as longitude and y data as latitude.  'yx' defines x data as
%   latitude and x data as longitude (which occurs with accidental use of 
%   a non-mapping Matlab display command, such as PLOT instead of PLOTM).  
%   If omitted, option = 'xy' is assumed.
% 
%   

function contorm
%MATLAB Tour Partial Function Help:  map_con
%
% CONTORM  Project a contour plot of data onto the current map axes
% 
%   CONTORM(lat,lon,map) produces a contour plot of map data projected
%   onto the current map axes.  The input latitude and longitude vectors
%   can be the size of map (as in a general matrix map), or can specify the 
%   corresponding row and column dimensions for the map.
% 
%   CONTORM(map,maplegend) produces a contour plot of map data in a 
%   regular matrix map.
% 
%   CONTORM(lat,lon,map,'LineSpec') uses any valid LineSpec string
%   to draw the contour lines.
% 
%   CONTORM(lat,lon,map,'PropertyName',PropertyValue,...) uses the
%   line properties specified to draw the contours.
% 
%   CONTORM(lat,lon,map,n,...) draws n contour levels, where n is a scalar.
% 
%   CONTORM(lat,lon,map,v,...) draws contours at the levels specified
%   by the input vector v.
% 
%   CONTOR3M(map,maplegend,...) takes any of the optional arguments 
%   described above.
% 
%   c = CONTORM(...) returns a standard contour matrix, with the first
%   row representing longitude data and the second row represents
%   latitude data.
% 
%   [c,h] = CONTORM(...) returns the contour matrix and the handles
%   to the contour lines drawn.
% 
%   CONTORM, without any inputs, will activate a GUI to project contour
%   lines onto the current map axes.
% 
%   

function contor3m
%MATLAB Tour Partial Function Help:  map_con
%
% CONTOR3M  Project a 3D contour plot of data onto the current map axes
% 
%   CONTOR3M(lat,lon,map) produces a 3D contour plot of map data projected
%   onto the current map axes.  The input latitude and longitude vectors
%   can be the size of map (as in a general matrix map), or can specify the 
%   corresponding row and column dimensions for the map.
% 
%   CONTOR3M(map,maplegend) produces a contour plot of map data in a 
%   regular matrix map.
% 
%   CONTOR3M(lat,lon,map,'LineSpec') uses any valid LineSpec string
%   to draw the contour lines.
% 
%   CONTOR3M(lat,lon,map,'PropertyName',PropertyValue,...) uses the
%   line properties specified to draw the contours.
% 
%   CONTOR3M(lat,lon,map,n,...) draws n contour levels, where n is a scalar.
% 
%   CONTOR3M(lat,lon,map,v,...) draws contours at the levels specified
%   by the input vector v.
% 
%   CONTOR3M(map,maplegend,...) takes any of the optional arguments 
%   described above.
% 
%   c = CONTOR3M(...) returns a standard contour matrix, with the first
%   row representing longitude data and the second row represents
%   latitude data.
% 
%   [c,h] = CONTOR3M(...) returns the contour matrix and the handles
%   to the contour lines drawn.
% 
%   CONTOR3M, without any inputs, will activate a GUI to project contour
%   lines onto the current map axes.
% 
%   

function contourfm
%MATLAB Tour Partial Function Help:  map_con
%
% CONTOURFM  Filled contour map. 
% 
%   CONTOURFM(lat,lon,map) produces a contour plot of map data projected
%   onto the current map axes.  The input latitude and longitude vectors
%   can be the size of map (as in a general matrix map), or can specify the 
%   corresponding row and column dimensions for the map.
% 
%   CONTOURFM(map,maplegend) produces a contour plot of map data in a 
%   regular matrix map.
% 
%   CONTOURFM(lat,lon,map,'LineSpec') uses any valid LineSpec string
%   to draw the contour lines.
% 
%   CONTOURFM(lat,lon,map,'PropertyName',PropertyValue,...) uses the
%   line properties specified to draw the contours.
% 
%   CONTOURFM(lat,lon,map,n,...) draws n contour levels, where n is a scalar.
% 
%   CONTOURFM(lat,lon,map,v,...) draws contours at the levels specified
%   by the input vector v.
% 
%   CONTOURFM(map,maplegend,...) takes any of the optional arguments 
%   described above.
% 
%   c = CONTOURFM(...) returns a standard contour matrix, with the first
%   row representing longitude data and the second row represents
%   latitude data.
% 
%   [c,h] = CONTOURFM(...) returns the contour matrix and the handles
%   to the contour lines drawn.
% 
%   CONTOURFM, without any inputs, will activate a GUI to project contour
%   lines onto the current map axes.
% 
%   

function linem
%MATLAB Tour Partial Function Help:  map_con
%
% LINEM  Project line objects onto the current map axes
% 
%   LINEM(lat,lon) projects the line objects onto the current
%   map axes.  The input latitude and longitude data must be in
%   the same units as specified in the current map axes.
%   Unlike PLOTM and PLOT3M, LINEM will always add lines to
%   the current axes, regardless of the current hold state.
% 
%   LINEM(lat,lon,z) projects a 3D line object onto the current
%   map axes.
% 
%   LINEM(lat,lon,'LineSpec') and LINEM(lat,lon,z,'LineSpec') uses
%   any valid LineSpec string to display the line object.
% 
%   LINEM(lat,lon,'PropertyName',PropertyValue,...) and
%   LINEM(lat,lon,z,'PropertyName',PropertyValue,...) uses
%   the line object properties specified to display the line
%   objects.  Except for xdata, ydata and zdata, all line properties,
%   and styles available through LINE are supported by LINEM.
% 
%   h = LINEM(...) returns the handles to the line objects displayed.
% 
%   [h,msg] = LINEM(...) returns a string msg indicating any error
%   encountered.
% 
%   LINEM, without any inputs, will activate a GUI to project line
%   objects onto the current map axes.
% 
%   

function plot3m
%MATLAB Tour Partial Function Help:  map_con
%
% PLOT3M  Project 3D line objects onto the current map axes
% 
%   PLOT3M(lat,lon,z) projects 3D line objects onto the current
%   map axes.  The input latitude and longitude data must be in
%   the same units as specified in the current map axes.
%   PLOT3M will clear the current map if the hold state is off.
% 
%   PLOT3M(lat,lon,z,'LineSpec') uses any valid LineSpec string to
%   display the line object.
% 
%   PLOT3M(lat,lon,z,'PropertyName',PropertyValue,...) uses
%   the line object properties specified to display the line
%   objects.  Except for xdata, ydata and zdata, all line properties,
%   and styles available through PLOT3 are supported by PLOT3M.
% 
%   h = PLOT3M(...) returns the handles to the line objects displayed.
% 
%   PLOT3M, without any inputs, will activate a GUI to project line
%   objects onto the current map axes.
% 
%   

function plotm
%MATLAB Tour Partial Function Help:  map_con
%
% PLOTM  Project 2D line objects onto the current map axes
% 
%   PLOTM(lat,lon) projects line objects onto the current
%   map axes.  The input latitude and longitude data must be in
%   the same units as specified in the current map axes.
%   PLOTM will clear the current map if the hold state is off.
% 
%   PLOTM(lat,lon,'LineSpec') uses any valid LineSpec string to
%   display the line object.
% 
%   PLOTM(lat,lon,'PropertyName',PropertyValue,...) uses
%   the line object properties specified to display the line
%   objects.  Except for xdata, ydata and zdata, all line properties,
%   and styles available through PLOT are supported by PLOTM.
% 
%   PLOTM(mat,...) uses a single input matrix, mat = [lat lon],
%   where the first half of the matrix columns represents the
%   latitude data and the second half of the columns represent
%   longitude data.
% 
%   h = PLOTM(...) returns the handles to the line objects displayed.
% 
%   PLOTM, without any inputs, will activate a GUI to project line
%   objects onto the current map axes.
% 
%   

function fill3m
%MATLAB Tour Partial Function Help:  map_con
%
% FILL3M  Project 3D patch objects onto the current map axes
% 
%   FILL3M(lat,lon,z,cdata) projects 3D patch objects onto the current
%   map axes.  The input latitude and longitude data must be in the same
%   units as specified in the current map axes.  The input cdata defines
%   the patch face color.  If the input vectors are NaN clipped, then
%   a single patch is drawn with multiple faces.  FILL3M will clear the
%   current map if the hold state is off.
% 
%   FILLM(lat,lon,z,'PropertyName',PropertyValue,...) uses the patch
%   properties supplied to display the patch.  Except for xdata, ydata
%   and zdata, all patch properties available through FILL3 are supported
%   by FILL3M.
% 
%   h = FILL3M(...) returns the handles to the patch objects drawn.
% 
%   FILL3M, without any inputs, activates a GUI for projecting patches
%   onto the current axes.
% 
%   

function fillm
%MATLAB Tour Partial Function Help:  map_con
%
% FILLM  Project 2D patch objects onto the current map axes
% 
%   FILLM(lat,lon,cdata) projects 2D patch objects onto the current
%   map axes.  The input latitude and longitude data must be in the same
%   units as specified in the current map axes.  The input cdata defines
%   the patch face color.  If the input vectors are NaN clipped, then
%   a single patch is drawn with multiple faces.  FILLM will clear the
%   current map if the hold state is off.
% 
%   FILLM(lat,lon,'PropertyName',PropertyValue,...) uses the patch
%   properties supplied to display the patch.  Except for xdata, ydata
%   and zdata, all patch properties available through FILL are supported
%   by FILLM.
% 
%   h = FILLM(...) returns the handles to the patch objects drawn.
% 
%   FILLM, without any inputs, activates a GUI for projecting patches
%   onto the current axes.
% 
%   

function patchesm
%MATLAB Tour Partial Function Help:  map_con
%
% PATCHESM  Project patch objects onto the current map axes
% 
%   PATCHESM(lat,lon,cdata) projects 2D patch objects onto the current
%   map axes.  The input latitude and longitude data must be in the same
%   units as specified in the current map axes.  The input cdata defines
%   the patch face color.  If the input vectors are NaN clipped, then
%   a multiple patches are drawn each with a single face.  Unlike FILLM
%   and FILL3M, PATCHESM will always add the patches to the current map,
%   regardless of the current hold state.
% 
%   PATCHESM(lat,lon,z,cdata) projects 3D planar patches.
% 
%   PATCHESM(...,'PropertyName',PropertyValue,...) uses the patch
%   properties supplied to display the patch.  Except for xdata, ydata
%   and zdata, all patch properties available through PATCH are supported
%   by PATCHESM.
% 
%   h = PATCHESM(...) returns the handles to the patch objects drawn.
% 
%   [h,msg] = PATCHESM(...) returns a string indicating any
%   error encountered.
% 
%   PATCHESM, without any inputs, activates a GUI for projecting patches
%   onto the current axes.
% 
%   

function patchm
%MATLAB Tour Partial Function Help:  map_con
%
% PATCHM  Project patch objects onto the current map axes
% 
%   PATCHM(lat,lon,cdata) projects 2D patch objects onto the current
%   map axes.  The input latitude and longitude data must be in the same
%   units as specified in the current map axes.  The input cdata defines
%   the patch face color.  If the input vectors are NaN clipped, then
%   a single patch is drawn with multiple faces.  Unlike FILLM and
%   FILL3M, PATCHM will always add the patches to the current map,
%   regardless of the current hold state.
% 
%   PATCHM(lat,lon,z,cdata) projects a 3D patch.
% 
%   PATCHM(...,'PropertyName',PropertyValue,...) uses the patch
%   properties supplied to display the patch.  Except for xdata, ydata
%   and zdata, all patch properties available through PATCH are supported
%   by PATCHM.
% 
%   h = PATCHM(...) returns the handles to the patch objects drawn.
% 
%   [h,msg] = PATCHM(...) returns a string indicating any error encountered.
% 
%   PATCHM, without any inputs, activates a GUI for projecting patches
%   onto the current axes.
% 
%   

function imagem
%MATLAB Tour Partial Function Help:  map_con
%
% IMAGEM  Display a regular matrix map as an image
% 
%   IMAGEM(map,maplegend) allows the display of regular matrix
%   maps as images.  As such, the displayed map is a Platte Carre
%   projection.  This projection produces significant distortion at the
%   poles.  IMAGEM produces quick displays of matrix maps, but
%   it is generally not recommended for final output due
%   to the distortion of the image display.  A regular matrix map is
%   defined using map and maplegend.
% 
%   IMAGEM(map,maplegend,'PropertyName',PropertyValue,...) uses the
%   specified image properties to display the map.
% 
%   h = IMAGEM(...) returns the handle of the image object displayed.
% 
%   

function meshm
%MATLAB Tour Partial Function Help:  map_con
%
% MESHM  Display a regular matrix map warped to a projected graticule
% 
%   MESHM(map,maplegend) will display the regular matrix map warped
%   to the default projection graticule.  The current axes must have a
%   valid map projection definition.
% 
%   MESHM(map,maplegend,gsize) displays a regular matrix map warped to a
%   graticule mesh defined by gsize.  GSIZE must be a 2 element vector
%   specifying the number of latitude graticule lines, gsize(1), and the
%   number of longitude graticule lines, gsize(2).
% 
%   MESHM(map,maplegend,gsize,alt) displays the regular surface map at
%   the altitude specified by alt.  If alt is a scalar, then the map is
%   drawn in the z = alt plane.  If alt is a matrix, then size(alt) must
%   equal gsize, and the graticule mesh is drawn at the altitudes specified
%   by alt.  If the default graticule is desired, set gsize = [].
% 
%   MESHM(map,maplegend,'PropertyName',PropertyValue,...) and
%   MESHM(map,maplegend,gsize,'PropertyName',PropertyValue,...) and
%   MESHM(map,maplegend,gsize,alt,'PropertyName',PropertyValue,...) display
%   regular matrix map using the specified surface properties.  If data is
%   placed in the UserData property of the surface, then the projection of
%   this object can not be altered once displayed.
% 
%   h = MESHM(...) returns the handle to the surface drawn.
% 
%   MESHM, without any inputs, activates a GUI for projecting regular surfaces
%   onto the current axes.
% 
%   

function pcolorm
%MATLAB Tour Partial Function Help:  map_con
%
% PCOLORM  Projected matrix map in the z = 0 plane
% 
%   PCOLORM(lat,lon,map) will warp a matrix map to a projected
%   graticule mesh, thus allowing matrix surfaces to be displayed
%   in a map projection.  The graticule mesh is specified by the lat
%   and lon inputs.    PCOLORM will clear the current map if the hold
%   state is off.  Unlike MESHM and SURFM, PCOLORM will always
%   produce a map drawn in the z = 0 plane.
% 
%   PCOLORM(lat,lon,map,'PropertyName',PropertyValue,...) and
%   PCOLORM(lat,lon,map,alt,'PropertyName',PropertyValue,...) display
%   general matrix map using the specified surface properties.
% 
%   PCOLORM(map) and PCOLORM(map,npts) computes a default
%   graticule mesh is computed with MESHGRAT using the latitude
%   and longitude limits in the current map axes definition.  If
%   npts is supplied, then a MESHGRAT is executed using npts and
%   the map latitude and longitude limits in the current map axes.
% 
%   h = PCOLORM(...) returns the handle to the surface object displayed.
% 
%   PCOLORM, without any inputs, activates a GUI for projecting general
%   surfaces onto the current axes.
% 
%   

function surfacem
%MATLAB Tour Partial Function Help:  map_con
%
% SURFACEM  Display a matrix map warped to a projected graticule
% 
%   SURFACEM(lat,lon,map) will warp a matrix map to a projected
%   graticule mesh, thus allowing matrix surfaces to be displayed
%   in a map projection.  The graticule mesh is specified by the lat
%   and lon inputs.  Unlike MESHM and SURFM, SURFACEM will always
%   add surfaces to the current axes, regardless of the current
%   hold state.
% 
%   SURFACEM(lat,lon,map,alt) uses the input alt as the zdata to
%   draw the graticule mesh.  In this case, size(alt) and size(lat)
%   must be the same.  If the alt input is not supplied, then the
%   graticule zdata is dependent on size(lat).  If size(lat) and
%   size(map) are not the same, then the graticule mesh is drawn
%   at the z = 0 plane.  However, if size(lat) and size(map) are
%   equal, then the graticule mesh is drawn with zdata = map,
%   thus producing a 3D surface map.
% 
%   SURFACEM(lat,lon,map,'PropertyName',PropertyValue,...) and
%   SURFACEM(lat,lon,map,alt,'PropertyName',PropertyValue,...) display
%   general matrix map using the specified surface properties.
% 
%   SURFACEM(map) and SURFACEM(map,npts) computes a default graticule mesh 
%   with MESHGRAT using the latitude and longitude limits in the current map 
%   axes definition.  If npts is supplied, then MESHGRAT is executed using 
%   npts and the map latitude and longitude limits in the current map axes.
% 
%   h = SURFACEM(...) returns the handle to the surface object displayed.
% 
%   [h,msg] = SURFACEM(...) returns a string indicating any error encountered.
% 
%   SURFACEM, without any inputs, activates a GUI for projecting general
%   surfaces onto the current axes.
% 
%   

function surfm
%MATLAB Tour Partial Function Help:  map_con
%
% SURFM  Display a matrix map warped to a projected graticule
% 
%   SURFM(lat,lon,map) will warp a matrix map to a projected
%   graticule mesh, thus allowing matrix surfaces to be displayed
%   in a map projection.  The graticule mesh is specified by the lat
%   and lon inputs.    SURFM will clear the current map if the hold
%   state is off.
% 
%   SURFM(lat,lon,map,alt) uses the input alt as the zdata to
%   draw the graticule mesh.  In this case, size(alt) and size(lat)
%   must be the same.  If the alt input is not supplied, then the
%   graticule zdata is dependent on size(lat).  If size(lat) and
%   size(map) are not the same, then the graticule mesh is drawn
%   at the z = 0 plane.  However, if size(lat) and size(map) are
%   equal, then the graticule mesh is drawn with zdata = map,
%   thus producing a 3D surface map.
% 
%   SURFM(lat,lon,map,'PropertyName',PropertyValue,...) and
%   SURFM(lat,lon,map,alt,'PropertyName',PropertyValue,...) display
%   general matrix map using the specified surface properties.
% 
%   SURFM(map) and SURFM(map,npts) computes a default graticule mesh with 
%   MESHGRAT using the latitude and longitude limits in the current map axes 
%   definition.  If npts is supplied, then MESHGRAT is executed using npts and 
%   the map latitude and longitude limits in the current map axes.
% 
%   h = SURFM(...) returns the handle to the surface object displayed.
% 
%   SURFM, without any inputs, activates a GUI for projecting general
%   surfaces onto the current axes.
% 
%   

function lightm
%MATLAB Tour Partial Function Help:  map_con
%
% LIGHTM  Project light objects onto the current map axes
% 
%   LIGHTM activates a Graphical User Interface for projecting
%   a light object onto the current map axes.
% 
%   LIGHTM(lat,lon) projects a light source positioned an infinite distance 
%   above the specified geographic location onto the current map axes.  The 
%   input latitude and longitude data must be in the same units as specified 
%   in the current map axes.  If lat and lon are vectors, then a light is 
%   projected at each element. 
% 
%   LIGHTM(lat,lon,'PropertyName',PropertyValue,...) uses the
%   properties specified to define the light source.  Except
%   for 'Position', all properties are supported.
% 
%   LIGHTM(lat,lon,alt) and
%   LIGHTM(lat,lon,alt,'PropertyName',PropertyValue,...) project
%   a local light source at the altitude specified by alt.
% 
%   h = LIGHTM(...) returns the handles to the light objects projected.
% 
%   [h,msg] = LIGHTM(...) returns an text string indicating any error
%   condition encountered.
% 
%   

function meshlsrm
%MATLAB Tour Partial Function Help:  map_con
%
% MESHLSRM Project 3-D lighted shaded relief of a regular matrix map
% 
%   MESHLSRM(map,maplegend) displays the regular matrix map colored according
%   to elevation and surface slopes.  By default, shading is based on a light
%   to the east (90 deg.) at an elevation of 45 degrees.  Also by default,
%   the colormap is constructed from 16 colors and 16 grays.  Lighting is
%   applied before the data is projected.  The current axes must have a valid
%   map projection definition.
% 
%   MESHLSRM(map,maplegend,[azim elev]) displays the regular matrix map with
%   the light coming from the specified azimuth and elevation.  Angles are
%   specified in degrees, with the azimuth measured clockwise from North,
%   and elevation up from the zero plane of the surface.
% 
%   MESHLSRM(map,maplegend,[azim elev],cmap) displays the regular matrix map
%   using the provided colormap.  The number of grayscales is chosen to keep
%   the size of the shaded colormap below 256.  If the vector of azimuth and
%   elevation is empty, the default locations are used.  Color axis limits are
%   computed from the data.
% 
%   MESHLSRM(map,maplegend,[azim elev],cmap,clim) uses the provided caxis limits.
% 
%   h = MESHLSRM(...) returns the handle to the surface drawn.
% 
% 
%   

function surflm
%MATLAB Tour Partial Function Help:  map_con
%
% SURFLM  Display a lighted matrix map warped to a projected graticule
% 
%   SURFLM(lat,lon,map) is the same as SURFM(...) except that it
%   projects the surface with highlights from a light surface.
%   The light source is 45 degrees counterclockwise from the
%   current view direction.  The shading is based on a combination
%   of diffuse, specular and ambient lighting models.  The inputs
%   lat and lon must be in the angle units specified in the map
%   structure.
% 
%   SURFLM(lat,lon,map,s) uses the input s to control the position
%   of the light source.  The input s is a three element vector,
%   s = [Sx Sy Sz], that specifies the coordinates of the light
%   sources.  This input can also be specified in spherical
%   coordinates, s = [Az, El].
% 
%   SURFLM(lat,lon,map,S,K) where K=[ka,kd,ks,spread] is used to
%   control the relative contributions due to ambient light, diffuse
%   reflection, specular reflection, and the specular spread
%   coefficient.
% 
%   SURFLM activates a Graphical User Interface to project a lighted
%   map surface onto the current map axes.
% 
%   SURFLM(map) and SURFLM(map,s) project the matrix map by constructing
%   a map graticule to span the MapLatLimit and MapLonLimit specified
%   in the map structure.
% 
%   h = SURFLM(...) returns the handle to the projected surface object.
% 
%   

function surflsrm
%MATLAB Tour Partial Function Help:  map_con
%
% SURFLSRM Project 3-D lighted shaded relief of a general matrix map
% 
%   SURFLSRM(lat,long,map) displays the general matrix map colored according
%   to elevation and surface slopes.  By default, shading is based on a light
%   to the east (90 deg.)  at an elevation of 45 degrees.  Also by default,
%   the colormap is constructed from 16 colors and 16 grays.  Lighting is
%   applied before the data is projected.  The current axes must have a valid
%   map projection definition.
% 
%   SURFLSRM(lat,long,map,[azim elev]) displays the general matrix map with
%   the light coming from the specified azimuth and elevation.  Angles are
%   specified in degrees, with the azimuth measured clockwise from North,
%   and elevation up from the zero plane of the surface.
% 
%   SURFLSRM(lat,long,map,[azim elev],cmap) displays the general matrix map
%   using the provided colormap.  The number of grayscales is chosen to keep
%   the size of the shaded colormap below 256. If the vector of azimuth and
%   elevation is empty, the default locations are used. Color axis limits are
%   computed from the data.
% 
%   SURFLSRM(lat,long,map,[azim elev],cmap,clim) uses the provided caxis limits.
% 
%   h = SURFLSRM(...) returns the handle to the surface drawn.
% 
% 
%   

function shaderel
%MATLAB Tour Partial Function Help:  map_con
%
%  SHADEREL Construct cdata and colormap for colored shaded relief
% 
% 
%   [cindx,cimap,clim] = SHADEREL(X,Y,Z,cmap) constructs the colormap and
%   color indices to allow a surface to be displayed in colored shaded relief.
%   The colors are proportional to the magnitude of Z, but modified by shades
%   of gray based on the surface normals, as if the surface were lighted.
%   This representation allows both large and small-scale differences to be
%   seen.  X, Y and Z define the surface.  cmap is the small colormap which
%   will be used as the basis for the output rgbmap colormap.  The number of
%   gray levels is chosen to give a final colormap with a length of less than
%   256.  By default, shading is for a light at an elevation of 45 degrees and
%   an azimuth of 90 (as if the light was an infinite distance away).  cindex
%   is a matrix which can be used as cdata in a surface command.  cimap is the
%   colormap into which the elements of cindx are indices.  clim is a vector
%   of color limits for use in a caxis command.
% 
%   [cindx,cimap,clim] = SHADEREL(X,Y,Z,cmap,[azim elev]) places the light at
%   the specified azimuth and elevation.
% 
%   [cindx,cimap,clim] = SHADEREL(X,Y,Z,cmap,[azim elev],cmaplen) choses the
%   number of grays to give a cimap of length cmaplen.  If the vector of
%   azimuth and elevation is empty, the default locations are used.
% 
%   [cindx,cimap,clim] = SHADEREL(X,Y,Z,cmap,[azim elev],cmaplen,clim) uses
%   the color limits to index Z into cmap, as if a CAXIS command had been
%   used.
% 
% 
%   

function cometm
%MATLAB Tour Partial Function Help:  map_con
%
% COMETM  Two dimensional comet plot projected on a map axes
% 
%   COMETM(lat,lon) projects a comet plot in two dimensions
%   (z = 0) on the current map axes.  A comet plot is an animated
%   graph in which a circle (the comet head) traces the data points on the
%   screen.  The comet body is a trailing segment that follows the head.
%   The tail is a solid line that traces the entire function.  The
%   lat and lon vectors must be in the same units as specified in
%   the map structure.
% 
%   COMETM(lat,lon,p) uses the input p to specify a comet body size of
%   p*length(lat)
% 
%   COMETM activates a Graphical User Interface for projecting comet plots.
% 
%   

function comet3m
%MATLAB Tour Partial Function Help:  map_con
%
% COMET3M  Three dimensional comet plot projected on a map axes
% 
%   COMET3M(lat,lon,z) projects a comet plot in three dimensions
%   on the current map axes.  A comet plot is an animated graph
%   in which a circle (the comet head) traces the data points on the
%   screen.  The comet body is a trailing segment that follows the head.
%   The tail is a solid line that traces the entire function.  The
%   lat and lon vectors must be in the same units as specified in
%   the map structure.
% 
%   COMET3M(lat,lon,z,p) uses the input p to specify a comet body
%   size of p*length(lat)
% 
%   COMET3M activates a Graphical User Interface for projecting
%   comet plots.
% 
%   

function quiverm
%MATLAB Tour Partial Function Help:  map_con
%
%  QUIVERM  Two dimensional quiver plot projected on a map axes
% 
%   QUIVERM(lat,lon,u,v) projects two dimensional vector plot onto the current 
%   map axes.  The vectors components (u,v) are specified at the points
%   (lat,lon).  Note that both the (lat,lon) and (u,v) data must be in 
%   the same angle units as the current map.  The vector is plotted from 
%   (lat,lon) to (lat+u,lon+v).
% 
%   QUIVERM(lat,lon,u,v,s) uses the input s to scale the vectors after they 
%   have been automatically scaled to fit within the rectangular grid.  If 
%   omitted, s = 1 is assumed.  To suppress the automatic scaling, specify 
%   s = 0.
% 
%   QUIVERM(lat,lon,u,v,'LineSpec'), QUIVERM(lat,lon,u,v,'LineSpec',s),
%   QUIVERM(lat,lon,u,v,'LineSpec','filled') and
%   QUIVERM(lat,lon,u,v,'LineSpec',s,'filled') use the LineSpec string
%   to define the line style of the vectors.  If a symbol is specified in 
%   'LineSpec', then the symbol is plotted at the base of the vector.  
%   Otherwise, an arrow is drawn at the end of the vector.  If a marker is 
%   specified at the base, then this symbol can be filled in by providing the 
%   input string 'filled'.
% 
%   QUIVERM activates a Graphical User Interface to project a quiver plot onto 
%   the current map axes.
% 
%   h = QUIVERM(...)  returns a vector of handles to the projected vectors.
% 
%   

function quiver3m
%MATLAB Tour Partial Function Help:  map_con
%
%  QUIVER3M  Three dimensional quiver plot projected on a map axes
% 
%   QUIVER3M(lat,lon,alt,u,v,w) projects three dimensional vector plot onto 
%   the current map axes.  The vectors components (u,v,w) are specified at the 
%   points (lat,lon,alt).  Note that both the (lat,lon) and (u,v) data must be 
%   in the same angle units as the current map.  The units of alt and w must 
%   be consistent, since these components will be used to define the altitude 
%   of the vector above the map.  The vector is plotted from (lat,lon,alt) to 
%   (lat+u,lon+v,alt+w).
% 
%   QUIVER3M(lat,lon,alt,u,v,w,s) uses the input s to scale the velocity
%   vectors after they have been automatically scaled to fit within
%   the rectangular grid.  If omitted, s = 1 is assumed.  To suppress
%   the automatic scaling, specify s = 0.
% 
%   QUIVER3M(lat,lon,alt,u,v,w,'LineSpec'),
%   QUIVER3M(lat,lon,alt,u,v,w,'LineSpec',s),
%   QUIVER3M(lat,lon,alt,u,v,w,'LineSpec','filled') and
%   QUIVER3M(lat,lon,alt,u,v,w,'LineSpec',s,'filled') use the LineSpec
%   string to define the line style of the velocity vectors.  If a symbol
%   is specified in 'LineSpec', then the symbol is plotted at the
%   base of the velocity vector.  Otherwise, an arrow is drawn at
%   the end of the velocity vector.  If a marker is specified at
%   the base, then this symbol can be filled in by providing
%   the input string 'filled'.
% 
%   QUIVER3M activates a Graphical User Interface to project a quiver
%   plot onto the current map axes.
% 
%   h = QUIVER3M(...) returns a vector of handles to the projected
%   velocity vectors.
% 
%   

function stem3m
%MATLAB Tour Partial Function Help:  map_con
%
% STEM3M  Construct a thematic map with proportional stem heights
% 
%   STEM3M(lat,lon,z) constructs a thematic map where a stem of height
%   z is drawn at each lat/lon data point.
% 
%   STEM3M(lat,lon,z,'LineSpec') draws each stem using the LineSpec
%   string.  Any LineSpec string supported by PLOT can be used.
% 
%   STEM3M(lat,lon,z,'PropertyName',PropertyValue,...) uses the
%   specified line properties to draw the stems.
% 
%   STEM3M activates a Graphical User Interface for projecting a
%   stem plot onto the current map axes.
% 
%   h = STEM3M(...) returns the handle of the stem plot.  The stems
%   are drawn as a single NaN clipped line.
% 
%   

function scatterm
%MATLAB Tour Partial Function Help:  map_con
%
% SCATTERM Scatter map.
% 
%    SCATTERM(LAT,LON,S,C) displays colored circles at the locations specified
%    by the vectors LAT and LON (which must be the same size).  The area of
%    each marker is determined by the values in the vector S (in points^2)
%    and the colors of each marker are based on the values in C. S can be a
%    scalar, in which case all the markers are drawn the same size, or a
%    vector the same length as LAT and LON.
%    
%    When C is a vector the same length as LAT and LON, the values in C
%    are linearly mapped to the colors in the current colormap.  
%    When C is a LENGTH(LAT)-by-3 matrix, the values in C specify the
%    colors of the markers as RGB values.  C can also be a color string.
% 
%    SCATTERM(LAT,LON) draws the markers in the default size and color.
%    SCATTERM(LAT,LON,S) draws the markers with a single color.
%    SCATTERM(...,M) uses the marker M instead of 'o'.
%    SCATTERM(...,'filled') fills the markers.
% 
%    SCATTERM, without any inputs, will activate a GUI to project point
%    data onto the current map axes.
% 
%    H = SCATTERM(...) returns handles the PATCHES created.
% 
%    Use PLOTM for single color, single marker size scatter plots.
% 
%    Example
%      load seamount
%      worldmap([-49 -47.5],[-150 -147.5],'none')
%      scatterm(y,x,5,z)
%      scaleruler
% 
%    

function displaym
%MATLAB Tour Partial Function Help:  map_con
%
% DISPLAYM  Project data in a geographic data structure
% 
%   DISPLAYM(mstruct) will project the data contained in the input
%   structure onto the current axes.  The current axes must have a
%   valid map definition.  The input mstruct must be a valid Mapping
%   Toolbox Geographic Data Structure.
% 
%   DISPLAYM(mstruct,'object') will display vector data from
%   entries in the Mapping Toolbox Geographic Data structure whose
%   tag begins the 'object' string.  The output vectors use NaNs to
%   separate the individual entries in the map structure.  Matches of
%   the tag string must be vector data (lines and patches) to be
%   included in the output. The search is not case-sensitive.
% 
%   DISPLAYM(mstruct,objects), where objects is a character
%   array or a cell array or strings, allows more than one object to
%   be the basis for the search. Character array objects will have 
%   trailing spaces stripped before matching.
% 
%   [lat,lon]=DISPLAYM(mstruct,objects,'searchmethod') controls the method 
%   used to match the objects input.  Search method 'strmatch' searches for 
%   matches at the beginning of the tag, similar to the MATLAB STRMATCH 
%   function.  Search method 'findstr' searches within the tag, similar to 
%   the MATLAB FINDSTR function.  Search method 'exact' requires an exact 
%   match. If omitted, search method 'strmatch' is assumed. The search is 
%   case-sensitive.
% 
%   h = DISPLAYM(mstruct) returns the handles to the objects projected.
% 
%   

function extractm
%MATLAB Tour Partial Function Help:  map_con
%
% EXTRACTM  Extracts vector data from geographic data structures
% 
%   [lat,lon]=EXTRACTM(mstruct,'object') will extract vector data from
%   entries in the Mapping Toolbox Geographic Data structure whose
%   tag begins the 'object' string.  The output vectors use NaNs to
%   separate the individual entries in the map structure.  Matches of
%   the tag string must be vector data (lines and patches) to be
%   included in the output. The search is not case-sensitive.
% 
%   [lat,lon]=EXTRACTM(mstruct,objects), where objects is a character
%   array or a cell array or strings, allows more than one object to
%   be the basis for the search. Character array objects will have 
%   trailing spaces stripped before matching.
% 
%   [lat,lon]=EXTRACTM(mstruct,objects,'searchmethod') controls the method 
%   used to match the objects input.  Search method 'strmatch' searches for 
%   matches at the beginning of the tag, similar to the MATLAB STRMATCH 
%   function.  Search method 'findstr' searches within the tag, similar to 
%   the MATLAB FINDSTR function.  Search method 'exact' requires an exact 
%   match. If omitted, search method 'strmatch' is assumed. The search is 
%   case-sensitive.
% 
%   [lat,lon]=EXTRACTM(mstruct) extracts all vector data from the
%   input map structure.
% 
%   [lat,lon,indx]=EXTRACTM(...) also returns the vector indx identifying
%   the entries in the structure which meet the selection criteria.
% 
%   mat = EXTRACTM(...) returns the vector data in a single
%   matrix, where mat = [lat lon].
% 
% 
%   

function scircleg
%MATLAB Tour Partial Function Help:  map_con
%
% SCIRCLEG:  Display of small circles defined via a mouse input
% 
%   SCIRCLEG(n) will compute and display n small circles on the
%   current map axes.  The small circles are defined by
%   a mouse click on the center of the circle and then by
%   a mouse click on the circle, thereby defining its radius.
% 
%   SCIRCLEG(n,npts) uses the inputs npts to define the number
%   of points per circle computed for each small circle.
% 
%   SCIRCLEG(n,'LineSpec') and SCIRCLEG(n,npts,'LineSpec') uses
%   any valid LineSpec string to display the small circles.
% 
%   SCIRCLEG(n,'PropertyName',PropertyValue,...) and
%   SCIRCLEG(n,npts,'PropertyName',PropertyValue,...) uses the
%   specified line properties to display the small circles.
% 
%   SCIRCLEG('track',...) uses the track string to define
%   the distance calculation for the circle radius.  If
%   'track' = 'gc', then great circle distance is used as
%   the circle radius.  If 'track' = 'rh', then rhumb line
%   distance is used as the circle radius.  If omitted,
%   'track' = 'gc' is assumed.
% 
%   h = SCIRCLEG(...) returns the handles of the circles drawn.
% 
%   [lat,lon] = SCIRCLEG(...) returns the latitude and longitude
%   matrices corresponding to the circles drawn.
% 
%   

function trackg
%MATLAB Tour Partial Function Help:  map_con
%
% TRACKG  Display of great circles and rhumb lines defined via a mouse input
% 
%   TRACKG(n) will compute and display n great circles on the
%   current map axes.  The great circles are defined by
%   a mouse click on the starting and ending point of the track.
% 
%   TRACKG(n,npts) uses the inputs npts to define the number
%   of points per circle computed for each great circle.
% 
%   TRACKG(n,'LineSpec') and TRACKG(n,npts,'LineSpec') uses
%   any valid LineSpec string to display the great circles.
% 
%   TRACKG(n,'PropertyName',PropertyValue,...) and
%   TRACKG(n,npts,'PropertyName',PropertyValue,...) uses the
%   specified line properties to display the great circles.
% 
%   TRACKG('track',...) uses the track string to define
%   the track drawn.  If 'track' = 'gc', then great circles
%   are drawn.  If 'track' = 'rh', then rhumb lines are drawn.
%   If omitted, 'track' = 'gc' is assumed.
% 
%   h = TRACKG(...) returns the handles of the tracks drawn.
% 
%   [lat,lon] = TRACKG(...) returns the latitude and longitude
%   matrices corresponding to the tracks drawn.
% 
%   

function mdistort
%MATLAB Tour Partial Function Help:  map_con
%
%  MDISTORT displays contours of constant distortion on a map
%  
%    MDISTORT, with no input arguments, toggles the display of contours of 
%    projection-induced distortion on the current map axes.  The magnitude of 
%    the distortion is reported in percent.
%    
%    MDISTORT OFF removes the contours.
%    
%    MDISTORT('PARAMETER') or MDISTORT PARAMETER displays contours of 
%    distortion for the specified parameter.  Recognized parameter strings are 
%    'area', 'angles' for the maximum angular distortion of right angles, 
%    'scale' or 'maxscale' for the maximum scale, 'minscale' for the minimum 
%    scale, 'parscale' for scale along the parallels, 'merscale' for scale 
%    along the meridians, and 'scaleratio' for the ratio of maximum and 
%    minumum scale.  If omitted, the 'maxscale' parameter is displayed.  All 
%    parameters are displayed as percent distortion, except angles, which are
%    displayed in degrees.
%  
%    MDISTORT(parameter,levels) specifies the levels for which the contours 
%    are drawn.  levels is a vector of values as used by CONTOUR. If omitted, 
%    the default levels are used.
%    
%    MDISTORT('parameter',levels, gsize) controls the size of the underlying  
%    graticule matrix used to compute the contours.  gsize is a two-element  
%    vector containing the number of rows and columns.  If omitted, the default 
%    Mapping Toolbox graticule size of [50 100] is assumed.
%  
%    [h,ht] = MDISTORT(...) returns the handles to the line and text objects.
% 
%    

function tissot
%MATLAB Tour Partial Function Help:  map_con
%
% TISSOT  Tissot indicatrices projected onto a map axes
% 
%   TISSOT plots Tissot indicatrices projected onto the
%   current map axes.  A Tissot indicatrix is a small circle
%   which is drawn in a map projection.  If the projection is
%   conformal, then the circle remains a circle on the projection.
%   Otherwise, the circle becomes an ellipse.  On an equal area
%   projection, this ellipse has the same area as the original circle.
%   The Tissot Indicatrices are a graphical tool to demonstrate the
%   distortion associated with a map projection.
% 
%   TISSOT('LineSpec') draws the circle using the properties specified
%   by the LineSpec string.  Any LineSpec strings supported by PLOT
%   can be supplied.
% 
%   TISSOT('PropertyName',PropertyValue,...) draws the circle using the
%   properties specified.  Any line property can be supplied.
% 
%   TISSOT('LineSpec','PropertyName',PropertyValue,...) is a valid form.
% 
%   TISSOT(npts,...) uses the data in the vector npts to control the
%   number and location of the indicatrices.  The options for
%   npts are as follows:
%          npts = [Radius of circles]  (in same distance units as geoid(1))
%          npts = [Lat of circle center, Lon of circle center]
%          npts = [Lat, Lon, Radius]
%          npts = [Lat, Lon, Radius, Number of points per circle]
%   Default values for omitted portions of npts are
%          radius     =  0.1  (0ne tenth of the geoid radius)
%          lat center =  30   (every 30 degrees)
%          lon center =  30   (every 30 degrees)
%          points     = 100   (100 points per circle)
% 
%   h = TISSOT(...) returns the handle to the objects drawn.  These
%   circles are drawn as a single NaN clipped object
% 
%   

function clabelm
%MATLAB Tour Partial Function Help:  map_con
%
% CLABELM	Add contour labels to a map contour plot.
% 
%   CLABELM(CS,H) adds value labels to the current map contour
%   plot.  The labels are rotated and inserted within the contour
%   lines.  CS and H are the contour matrix and object handle
%   outputs from CONTORM or CONTOR3M.
% 
%   CLABELM(CS,H,V) labels just those contour levels given in the
%   vector V.  The default action is to label all known contours.
%   The label positions are selected randomly.
% 
%   CLABELM(CS,H,'manual') places contour labels at the locations
%   determined by a mouse click.  Pressing the return key terminates
%   labeling.  Use the space bar to enter contours and the arrow
%   keys to move the crosshair if no mouse is available.
% 
%   CLABELM(CS) or CLABELM(CS,V) or CLABELM(CS,'manual') places
%   contour labels as above, except that the labels are drawn as
%   plus signs on the contour with a nearby height value.
% 
%   H = CLABELM(...) returns handles to the TEXT (and possibly LINE)
%   objects created.
% 
%   

function clegendm
%MATLAB Tour Partial Function Help:  map_con
%
% CLEGENDM	Add a legend labels to a map contour plot.
% 
%   CLEGENDM(CS,H) adds a legend specifying the contour line heights
%   to the current map contour plot.  CS and H are the contour matrix
%   output and object handle outputs from CONTORM or CONTOR3M.
% 
%   CLEGENDM(...,Pos) places the legend in the specified location:
%         0 = Automatic placement (default)
%         1 = Upper right-hand corner
%         2 = Upper left-hand corner
%         3 = Lower left-hand corner
%         4 = Lower right-hand corner
%        -1 = To the right of the plot
% 
%   

function framem
%MATLAB Tour Partial Function Help:  map_con
%
% FRAMEM  Toggle and control the display of the map frame
% 
%   FRAMEM toggles the display of the map frame.  The map frame
%   is drawn at the longitude and latitude limits specified
%   by the frame properties in the map axes.
% 
%   FRAMEM ON turns the map frame on.  FRAMEM OFF turns it off.
% 
%   FRAMEM RESET will redraw the frame with the currently
%   specified properties.  This differs from the ON and OFF
%   which simply sets the visible property of the current frame.
% 
%   FRAMEM('LineSpec') uses any valid LineSpec string to define
%   the frame edge.
% 
%   FRAMEM('MapAxesPropertyName',PropertyValue,...) uses the
%   specified Map Axes properties to draw the frame.
% 
%   h = FRAMEM(...) returns the handle of the frame drawn.
% 
%   

function gridm
%MATLAB Tour Partial Function Help:  map_con
%
% GRIDM  Toggle and control the display of the map grid
% 
%   GRIDM toggles the display of the map grid.  The map grid
%   is drawn using the properties specified in the map axes.
% 
%   GRIDM ON turns the map frame on.  GRIDM OFF turns it off.
% 
%   GRIDM RESET will redraw the grid with the currently
%   specified properties.  This differs from the ON and OFF
%   which simply sets the visible property of the current grid.
% 
%   GRIDM('LineSpec') uses any valid LineSpec string to define
%   the grid lines.
% 
%   GRIDM('MapAxesPropertyName',PropertyValue,...) uses the
%   specified Map Axes properties to draw the grid.
% 
%   h = GRIDM(...) returns the handles of the grid drawn.
% 
%   

function mlabel
%MATLAB Tour Partial Function Help:  map_con
%
% MLABEL  Meridian labels projected onto a map axes
% 
%   MLABEL toggles the display of the meridian labels on the
%   map axes.  These labels are drawn using the properties
%   specified in the map axes.
% 
%   MLABEL ON turns the meridian labels on.
%   MLABEL OFF turns them off.
% 
%   MLABEL RESET will redraw the meridian labels with the currently
%   specified properties.  This differs from the ON and OFF option
%   which simply sets the visible property of the current labels.
% 
%   MLABEL(parallel) places the meridian labels at the specified
%   parallel.  The input parallel is used to set the MLabelParallel
%   property in the map axes.
% 
%   MLABEL('MapAxesPropertyName',PropertyValue,...) uses the
%   specified Map Axes properties to draw the meridian labels.
% 
%   h = MLABEL(...) returns the handles of the labels drawn.
% 
%   

function plabel
%MATLAB Tour Partial Function Help:  map_con
%
% PLABEL  Parallel labels projected onto a map axes
% 
%   PLABEL toggles the display of the parallel labels on the
%   map axes.  These labels are drawn using the properties
%   specified in the map axes.
% 
%   PLABEL ON turns the parallel labels on.
%   PLABEL OFF turns them off.
% 
%   PLABEL RESET will redraw the parallel labels with the currently
%   specified properties.  This differs from the ON and OFF
%   which simply sets the visible property of the current labels.
% 
%   PLABEL(meridian) places the parallel labels at the specified
%   meridian.  The input meridian is used to set the PLabelMeridian
%   property in the map axes.
% 
%   PLABEL('MapAxesPropertyName',PropertyValue,...) uses the
%   specified Map Axes properties to draw the parallel labels.
% 
%   h = PLABEL(...) returns the handles of the labels drawn.
% 
%   

function rotatetext
%MATLAB Tour Partial Function Help:  map_con
%
% ROTATETEXT rotates text to the projected graticule
%  
%    ROTATETEXT rotates displayed text objects to account for the curvature of 
%    the graticule.  The objects are selected interactively from a graphical 
%    user interface.
%    
%    ROTATETEXT(objects) rotates the selected objects.  objects may be a name 
%    string recognized by HANDLEM, or a vector of handles to displayed text 
%    objects.
%    
%    ROTATETEXT(objects,'inverse') removes the rotation added by an earlier use 
%    of ROTATETEXT.  If omitted, 'forward' is assumed.
% 
%    Meridian and parallel labels can be rotated automatically setting the 
%    map axes LabelRotation property to on.
%    
%    

function scaleruler
%MATLAB Tour Partial Function Help:  map_con
%
%  SCALERULER add or modify graphic scale
%  
%    SCALERULER toggles the display of a graphic scale.  A graphic scale is a 
%    ruler-like graphic object that shows distances on the ground at the 
%    correct size for the projection.  If no graphic scale is currently 
%    displayed in the current map axes, one will be added.  If any graphic 
%    scales are currently displayed, they will be removed.
%    
%    SCALERULER ON adds a graphic scale to the current map axes. Multiple 
%    graphic scales can be added to the same map axes.
%     
%    SCALERULER OFF removes any currently displayed graphic scales.
%    
%    SCALERULER('property',value,...) adds a graphic scale and sets the 
%    properties to the values specified. A list of graphic scale properties is 
%    displayed by the command SETM(h), where h is the handle to a graphic 
%    scale object. The current values for a displayed graphic scale object 
%    can be retrieved using GETM.   The properties of a displayed graphic 
%    scale object can be modified using SETM.
%  
%    Modifying the properties of the graphic scale results in the replacement of 
%    the original object. For this reason, handles to the graphic scale object 
%    will change. Use HANDLEM('scaleruler') to get a list of the current handles 
%    to graphic scale objects.
%   
%    The graphic scale object can be repositioned by dragging the baseline 
%    with the mouse. The position can also be changed by modifying the 'XPos' 
%    and 'YPos' properties using SETM.
%    
%    

function textm
%MATLAB Tour Partial Function Help:  map_con
%
% TEXTM	Project text onto the current map axes
% 
%   TEXTM(lat,lon,'string') projects the text string onto the
%   current map axes.  The latitude and longitude locations are
%   supplied in the same units as the current map axes.  Multiple
%   text entries can be defined by multiple rows in the lat, lon and
%   string matrix inputs.
% 
%   TEXTM(lat,lon,z,'string') draws the text at the altitude
%   specified by the z data input.
% 
%   TEXTM(...,'PropertyName',PropertyValue,...) uses the text
%   properties supplied to draw the text.
% 
%   h = TEXTM(...) returns the handles to the text objects drawn.
% 
%   [h,msg] = TEXTM(...) returns an optional second output which
%   contains a string indicating any errors encountered.
% 
%   

function demcmap
%MATLAB Tour Partial Function Help:  map_con
%
% DEMCMAP colormaps for Digital Elevation Maps
% 
%   DEMCMAP(map) creates and assigns a colormap appropriate for elevation data.
%   The colormap has the number of land and sea colors in proportion to
%   the maximum elevations and depths in the matrix map. With no output
%   arguments, the colormap is applied to the current figure and the axes
%   CLim property is set so that the interface between the land and sea
%   is correct.
% 
%   DEMCMAP(map,n) makes a colormap with a length of n.
% 
%   DEMCMAP(map,n,rgbseamat,rgblandmat) allows the default colors for
%   sea and land to be replaced by colormap matrices. Default colors for either
%   land or sea can be retained by providing an empty matrix, [], in place
%   of a colormap matrix. The current figure colormap can be specified by
%   entering the string 'window' in place of either rgb matrix.  The input
%   colormap matrices may be of any size. The actual colors used in the
%   created colormap are interpolated.
% 
%   DEMCMAP('mode',map,n,...) uses the 'mode' string to define the colormap
%   construction.  If 'mode' = 'size', n is the length of the colormap,
%   with a default value of n = 64.  If 'mode' = 'inc', n is the altitude
%   increment assigned to each color, with a default value of n = 100.  If omitted,
%   'mode' = 'size' is assumed.
% 
%   [cmap,clim] = DEMCMAP(...) returns the colormap matrix and color axis vector,
%   but does not apply them to the current figure.

function polcmap
%MATLAB Tour Partial Function Help:  map_con
%
% POLCMAP colormap for political maps
% 
%  POLCMAP applies a random muted colormap. The size of the colormap
%  is the same as the current figure's existing colormap.
% 
%  POLCMAP(ncolors) creates a colormap with the specified number of colors
% 
%  POLCMAP(ncolors,maxsat) controls the maximum saturation of the colors. 
%  Larger maximum saturation values produce brighter, more saturated colors. 
%  If omitted, the default is 0.5.
% 
%  POLCMAP(ncolors,huelimits,saturationlimits,valuelimits) controls the colors. 
%  Hue, saturation and value are randomly selected values within the limit 
%  vectors. These are two-element vector of the form [min max]. Valid 
%  values range from 0 to 1.  As the hue varies from 0 to 1, the resulting 
%  color varies from red, through yellow, green, cyan, blue and magenta, 
%  back to red. When the saturation is 0, the colors are unsaturated; they are
%  simply shades of gray.  When the saturation is 1, the colors are fully 
%  saturated; they contain no white component.  As the value varies from 
%  0 to 1, the brightness increases.
% 
%  cmap = POLCMAP(...) returns the colormap without applying it to the figure.
% 
%  

function gcpmap
%MATLAB Tour Partial Function Help:  map_con
%
% GCPMAP  Gets the current point from a map
% 
%   mat = GCPMAP will compute the current point on a map axes
%   in Greenwich coordinates.  GCPMAP works much like
%   get(gca,'CurrentPoint') except that the returned
%   matrix is [lat lon z], not [x y z].
% 
%   mat = GCPMAP(h) returns the current map point from the axes
%   specified by the handle h.
% 
%   

function gtextm
%MATLAB Tour Partial Function Help:  map_con
%
% GTEXTM  Place text on a 2-D map using a mouse
% 
%   GTEXTM('string') positions the input string at the location
%   specified by a mouse click.  Unlike GTEXT, this text object is
%   projected on the map and will remain at the corresponding
%   Greenwich coordinates even if the map is reprojected.  If string
%   is a matrix, then each row of the matrix can be placed at different
%   locations.
% 
%   GTEXTM('string','PropertyName',PropertyValue,...) uses the properties
%   specified to draw the text object.  Any text object property can
%   be supplied.
% 
%   h = GTEXTM(...) returns the handles of the text objects placed on
%   the map.
% 
%   

function inputm
%MATLAB Tour Partial Function Help:  map_con
%
% INPUTM  Return mouse click positions from displayed map
% 
%   [lat,lon] = INPUTM returns the latitudes and longitudes in Greenwich
%   frame of points selected by mouse clicks on a displayed map.
%   The point selection continues until the return key is pressed.
% 
%   [lat,lon] = INPUTM(n) returns n points specified by mouse clicks.
% 
%   [lat,lon] = INPUTM(n,h) prompts for points from the map axes specified
%   by the handle h.  If omitted, the current axes (gca) is assumed.
% 
%   mat = INPUTM(...) returns a single matrix, where mat = [lat lon].
% 
%   

function clma
%MATLAB Tour Partial Function Help:  map_con
%
% CLMA  Clears current map
% 
%   CLMA clears the current map, deleting objects plotted on the map
%   but leaving the frame and grid lines displayed.
% 
%   CLMA ALL clears the current map, frame and grid lines.  The map
%   definition is left in the axes definition.
% 
%   CLMA PURGE removes the map definition from the current axes, but
%   leaves all objects projected on the axes intact.
% 
%   

function clmo
%MATLAB Tour Partial Function Help:  map_con
%
% CLMO  Deletes identified graphic objects
% 
%   CLMO('str') deletes the object on the current axes specified
%   by the string 'str', where 'str' is any string recognized by HANDLEM.
% 
%   CLMO displays a Graphical User Interface prompting for the
%   objects to be deleted from the current axes.
% 
%   CLMO(h) deletes the objects specified by the input handles h.  This
%   is equivalent to DELETE(h)
% 
%   

function hidem
%MATLAB Tour Partial Function Help:  map_con
%
% HIDEM  Hides identified graphics objects
% 
%   HIDEM('str') hides the object on the current axes specified
%   by the string 'str', where 'str' is any string recognized by HANDLEM.
%   Hiding an object is accomplished by setting its visible property to off.
% 
%   HIDEM will display a Graphical User Interface prompting for the
%   objects to be hid from the current axes.
% 
%   HIDEM(h) hides the objects specified by the input handles h.
% 
%   

function showaxes
%MATLAB Tour Partial Function Help:  map_con
%
% SHOWAXES  Toggles the display of the current MATLAB cartesian axes
% 
%   SHOWAXES ON displays the MATLAB cartesian axes and default axes ticks.
%   SHOWAXES OFF removes the axes ticks from the MATLAB cartesian axes.
%   SHOWAXES alone toggles between ON and OFF.
% 
%   SHOWAXES HIDE hides the cartesian axes.
%   SHOWAXES SHOW shows the cartesian axes.
% 
%   SHOWAXES RESET sets the cartesian axes to the default map display settings.
%   SHOWAXES BOXOFF removes the axes ticks, axes color and box from
%   the cartesian axes.
% 
%   SHOWAXES('colorstr') sets the cartesian axes to the color
%   specified by 'colorstr'.  SHOWAXES(colorvec) uses the RBG triple
%   colorvec to set the cartesian axes color.
% 
%   

function showm
%MATLAB Tour Partial Function Help:  map_con
%
% SHOWM  Displays identified graphic objects
% 
%   SHOWM('str') shows the object on the current axes specified
%   by the string 'str', where 'str' is any string recognized by HANDLEM.
%   Showing an object is accomplished by setting its visible property to on.
% 
%   SHOWM will display a Graphical User Interface prompting for the
%   objects to be shown from the current axes.
% 
%   SHOWM(h) shows the objects specified by the input handles h.
% 
%   

function trimcart
%MATLAB Tour Partial Function Help:  map_con
%
% TRIMCART trims graphic objects to the map frame
% 
%   TRIMCART(h) trims the cartesian graphic objects to the map frame.  h can 
%   be a handle or a vector of handles to graphics objects.  h can also be any 
%   object name recognized by HANDLEM. TRIMCART trims lines, surfaces, and 
%   text objects.  TRIMCART does not trim patches.
%   
%   

function cart2grn
%MATLAB Tour Partial Function Help:  map_con
%
% CART2GRN  Transforms from projected cartesian coordinates to Greenwich frame
% 
%   [lat,lon,alt] = CART2GRN will transform the current displayed
%   map object from cartesian coordinates to the Greenwich frame.  In
%   doing so, any clips or trims introduced during the display process
%   are removed from the output data.
% 
%   [lat,lon,alt] = CART2GRN(hndl) will transform the object specified
%   by hndl, which must currently be displayed on a map axes.
% 
%   [lat,lon,alt] = CART2GRN(hndl,mstruct) uses the input map
%   structure to determine the projection parameters for the
%   displayed object.  If this is omitted, then the structure from
%   the current axes will be obtained.

function getm
%MATLAB Tour Partial Function Help:  map_con
%
% GETM  Get map object properties
% 
%   mat = GETM(h,'MapPropertyName') returns the value of the specified
%   map property for the map graphics object with handle h.  The
%   graphics object h must be a map axis or one of its children.
% 
%   mat = GETM(h) returns all map property values for the map object with
%   handle h.  
% 
%   GETM MAPPROJECTION lists the available map projections.
%   GETM AXES lists the map axes properties.
%   GETM UNITS lists the recognized unit strings.
% 
%   

function handlem
%MATLAB Tour Partial Function Help:  map_con
%
% HANDLEM  Returns the graphics handle for identified objects
% 
% 
%   HANDLEM displays a Graphical User Interface to select displayed
%   object handles.  The selections choices are determined from the
%   object tags.
% 
%   HANDLEM PROMPT displays a Graphical User Interface to select displayed
%   object handles.  The selection choices are determined from all the
%   recognized HANDLEM string inputs.
% 
%   HANDLEM ALL returns the handles for all children of the current axes
%   HANDLEM CLABEL returns the handles for map contour labels.
%   HANDLEM CONTOUR returns the handles for the map contour lines.
%   HANDLEM FRAME returns the handle for the map frame.
%   HANDLEM GRID returns the handles for the map grid lines
%   HANDLEM HIDDEN returns the handles for all hidden map objects.
%   HANDLEM IMAGE returns the handles for untagged image objects.
%   HANDLEM LIGHT returns the handles for untagged light objects.
%   HANDLEM LINE returns the handles for untagged line objects.
%   HANDLEM MAP returns the handles for map objects, excluding the frame and grid.
%   HANDLEM MERIDIAN returns the handles for meridian grid lines
%   HANDLEM MLABEL returns the handles for meridian labels.
%   HANDLEM PARALLEL returns the handles for parallel grid lines.
%   HANDLEM PATCH returns the handles for untagged patch objects.
%   HANDLEM PLABEL returns the handles for parallel labels.
%   HANDLEM SURFACE returns the handles for untagged surface objects.
%   HANDLEM TEXT returns the handles for untagged text objects.
%   HANDLEM TISSOT returns the handles for tissot indicatricies.
%   HANDLEM VISIBLE returns the handles for all visible objects.
% 
%   HANDLEM('str') returns the handles for any objects whose tag matches
%   the input 'str'.
% 
%   HANDLEM('str',axesh) seaches within the axes specified by the input handle
%   axesh.
% 
%   HANDLEM('str',axesh,'searchmethod') controls the method used to match the 
%   'str' input. If omitted, 'exact' is assumed. Search method 'strmatch' 
%   searches for matches at the beginning of the tag, similar to the MATLAB 
%   STRMATCH function.  Search method 'findstr' searches within the tag, 
%   similar to the MATLAB FINDSTR function. 
% 
%   [h,msg] = HANDLEM(...)  returns a string msg indicating any error
%   encountered.
% 
%   A prefix of 'all' may be applied to strings defining a Handle Graphics
%   Object type (image, line, surface patch, text) to find  all object
%   handles which meet the type criteria (eg. all lines, etc), and not 
%   just the objects with empty tag properties (normal operation).
% 
%   

function makemapped
%MATLAB Tour Partial Function Help:  map_con
%
% MAKEMAPPED make an object a mapped object
% 
%  MAKEMAPPED(h) adds a Mapping Tooolbox structure to the displayed objects 
%  associated with h. h can be a handle, vector of handles, or any name string
%  recognized by HANDLEM. The objects are then considered to be geographic 
%  data. Objects extending outside the map frame should first be trimmed to the 
%  map frame using TRIMCART.
% 
%  

function namem
%MATLAB Tour Partial Function Help:  map_con
%
% NAMEM  Determines the object name (tag or type) for graphics objects
% 
%   obj = NAMEM returns the object name for all objects on the current
%   axes.  The object name is defined as its tag, if the tag property
%   is supplied.  Otherwise, it is the object type.  Duplicate object
%   names are removed from the output string matrix.
% 
%   obj = NAMEM(h) returns the object names for the objects specified
%   by the input handles h.
% 
%   [obj,msg] = NAMEM(...)  returns a string msg indicating any error
%   encountered.
% 
%   

function restack
%MATLAB Tour Partial Function Help:  map_con
%
% RESTACK restacks objects within the axes
% 
%   RESTACK(h,position) changes the stacking order of the object h within 
%   the axes.  h can be a handle or vector of handles to graphics objects, or 
%   h can be a name string recognized by HANDLEM. Recognized position strings 
%   are 'top','bottom','bot','up' or 'down'. RESTACK permutes the order of the 
%   children of the axes.
% 
%   

function setm
%MATLAB Tour Partial Function Help:  map_con
%
% SETM  Modify the properties of a displayed map
% 
%   SETM(h,'MapAxesPropertyName',PropertyValue,...), where h is a
%   valid map axes handle, sets the map properties specified in
%   the input list.  The map properties must be recognized by AXESM.
% 
%   SETM(h,'MapPosition',position), where h is a valid projected
%   map text object, uses a two or three element position vector
%   specifying [latitude, longitude, altitude].  For two element
%   vectors, altitude = 0 is assumed.
% 
%   SETM(h,'Graticule',lat,lon,alt), where h is a valid projected
%   surface object, uses lat and lon matrices of same size to specify
%   the graticule vertices.  The input alt can be either a scalar
%   to specify the altitude plane, a matrix of the same size as lat and
%   lon, or an empty matrix.  If omitted, alt = 0 is assumed.
% 
%   For projected surface objects displayed using MESHM:
%   SETM(h,'MeshGrat',gsize,alt), where h is a valid surface object
%   displayed using MESHM, uses the two element vector gsize to
%   specify the graticule size (see MESHM).  The last input alt can
%   be either a scalar to specify the altitude plane, a matrix of the
%   size(gsize), or an empty matrix.  If omitted, alt = 0 is assumed.
% 
%   

function tagm
%MATLAB Tour Partial Function Help:  map_con
%
% TAGM  Sets the name (tag property) for graphics objects
% 
%   TAGM displays a Graphical User Interface for selecting an object
%   from the current axes and modifying its tag.
% 
%   TAGM(h) displays a Graphical User Interface to modify the tag of
%   the object(s) specified by the input handles h.  If a vector is
%   supplied, all objects will be given the same tag.
% 
%   TAGM(h,'str') sets the tag of the objects specified by the handles h
%   to the input string str.  If 'str' is a string matrix, it must
%   have the same rows as the number of entries in h.
% 
%   msg = TAGM(...)   returns a string msg indicating any error
%   encountered.
% 
%   

function zdatam
%MATLAB Tour Partial Function Help:  map_con
%
% ZDATAM  Adjusts the zdata property of displayed map objects
% 
%   ZDATAM(h,zdata) will alter the zdata property of displayed map objects.
%   This function allows quick manipulation of the z plane in which a
%   map object is displayed.  If zdata is omitted, then a modal dialog
%   box prompts for the zdata entry.
% 
%   If a scalar handle is supplied, then zdata can be either a scalar
%   (z plane definition), or a zdata matrix of appropriate dimension
%   for the displayed object.  If hndl is a vector, then zdata can be
%   a scalar or a vector of the same dimension as hndl.  If zdata is
%   a scalar, then all objects in hndl are drawn on the zdata plane.  If
%   zdata is a vector, then each object in hndl is drawn on the plane
%   defined by the corresponding zdata element.
% 
%   ZDATAM('str',zdata) identifies the objects by the input'str', where
%   'str' is any string recognized by HANDLEM.
% 
%   ZDATAM(h) and ZDATAM('str') displays a Graphical User Interface
%   to modify the zdata of the object(s) specified by the input.
% 
%   ZDATAM displays a Graphical User Interface for selected an object
%   from the current axes and modifying its zdata.
% 
%   

function axesscale
%MATLAB Tour Partial Function Help:  map_con
%
%   AXESSCALE Resize axes for equivalent scale 
%  
%   AXESSCALE resizes all axes in the current figure to have the same scale 
%   as the current axes (gca). In this context, scale means the relationship 
%   between axes X and Y coordinates to figure and paper coordinates. The 
%   XLimMode and YLimMode of the axes are set to Manual to prevent autoscaling 
%   from changing the scale
%  
%   AXESSCALE(hbase) uses the axes hbase as the reference axes, and rescales  
%   the other axes in the current figure.
%  
%   AXESSCALE(hbase,hother) uses the axes hbase as the base axes, and rescales  
%   only the axes hother.
%  
%   

function camposm
%MATLAB Tour Partial Function Help:  map_con
%
% CAMPOSM Camera position from geographic coordinates
% 
%    CAMPOSM(lat,long,alt) sets the axes CameraPosition property of the
%    current map axes to the position specified in geographic coordinates. 
%    The inputs lat and long are assumed to be in the angle units of the 
%    current map axes. 
% 
%    [x,y,z] = CAMPOSM(lat,long,alt) returns the camera position in the
%    projected cartesian coordinate system.
% 
%     

function camtargm
%MATLAB Tour Partial Function Help:  map_con
%
% CAMTARGM Camera target from geographic coordinates
% 
%    CAMTARGM(lat,long,alt) sets the axes CameraTarget property of the
%    current map axes to the position specified in geographic coordinates. 
%    The inputs lat and long are assumed to be in the angle units of the 
%    current map axes. 
% 
%    [x,y,z] = CAMTARGM(lat,long,alt) returns the camera target in the
%    projected cartesian coordinate system.
% 
%     

function camupm
%MATLAB Tour Partial Function Help:  map_con
%
% CAMUPM Camera UpVector from geographic coordinates
% 
%    CAMUPM(lat,long) sets the axes CameraUpVector property of the
%    current map axes to the position specified in geographic coordinates. 
%    The inputs lat and long are assumed to be in the angle units of the 
%    current map axes. 
% 
%    [x,y,z] = CAMUPM(lat,long) returns the camera position in the
%    projected cartesian coordinate system.
% 
%     

function daspectm
%MATLAB Tour Partial Function Help:  map_con
%
% DASPECTM figure DataAspectRatio property for a map  
% 
%      DASPECTM('zunits') sets the figure DataAspectRatio property so
%      that the z axis is in proportion to the x and y projected coordinates.
%      This permits elevation data to be displayed without vertical distortion.
%      The string 'zunits' specifies the units of the elevation data, and can
%      be any string recognized by DISTDIM.
% 
%      DASPECTM('zunits',vfac) sets the DataAspectRatio property so
%      that the z axis is vertically exaggerated by the factor vfac. If
%      omitted, the default is no vertical exaggeration.
%      
%      DASPECTM('zunits',vfac,lat,long) sets the aspect ratio based 
%      on the local map scale at the specified geographic location. 
%      If omitted, the default is the center of the map limits.
%      
% 
%      DASPECTM('zunits',vfac,lat,long,az) also specifies the direction 
%      along which the scale is computed. If omitted, 90 degrees (west) 
%      is assumed.
% 
%      DASPECTM('zunits',vfac,lat,long,az,'gunits') also specifies the 
%      units in which the geographic position and direction are given. 
%      If omitted, 'degrees' is assumed.
% 
%      DASPECTM('zunits',vfac,lat,long,az,'gunits',radius) 
%      uses the last input to determine the radius of the sphere.  If radius is 
%      a string, then it is evaluated as an ALMANAC body to determine the 
%      spherical radius.  If numerical, it is the radius of the desired sphere 
%      in zunits. If omitted, the default radius of the Earth is used.
% 
%      

function paperscale
%MATLAB Tour Partial Function Help:  map_con
%
%  PAPERSCALE figure paper size for a given map scale
%   
%    PAPERSCALE(paperdist,'punits',surfdist,'sunits') sets the figure paper 
%    position to print the map in the current axes at the desired scale.  The 
%    scale is described by the geographic distance which corresponds to a 
%    paper distance.  For example, a scale of 1 inch = 10 kilometer is 
%    specified as PAPERSCALE(1,'inch',10,'km').  See below for an alternate 
%    method of specifying the map scale.  The surface distance units string 
%    'sunits' can be any string recognized by DISTDIM. The paper units string 
%    can be any dimensional units string recognized for the figure PaperUnits 
%    property.
%        
%    PAPERSCALE(paperdist,'punits',surfdist,'sunits',lat,long) sets the paper 
%    position so that the scale is correct at the specified geographic 
%    location.  If omitted, the default is the center of the map limits.
%   
%    PAPERSCALE(paperdist,'punits',surfdist,'sunits',lat,long,az) also 
%    specifies the direction along which the scale is correct.  If omitted, 90 
%    degrees (east) is assumed.
%   
%    PAPERSCALE(paperdist,'punits',surfdist,'sunits',lat,long,az,'gunits') 
%    also specifies the units in which the geographic position and direction 
%    are given.  If omitted, 'degrees' is assumed.
%   
%    PAPERSCALE(paperdist,'punits',surfdist,'sunits',lat,long,az,'gunits',radius) 
%    uses the last input to determine the radius of the sphere.  If radius is 
%    a string, then it is evaluated as an ALMANAC body to determine the 
%    spherical radius.  If numerical, it is the radius of the desired sphere 
%    in the same units as the surface distance.  If omitted, the default 
%    radius of the Earth is used.
%   
%    PAPERSCALE(scale,...)  where the numeric scale replaces the two 
%    property-value pairs "paperdist,'punits',surfdist,'sunits'" in the above 
%    calling forms, specifies the scale as a ratio between distance on the 
%    sphere and on paper.  This is commonly notated on maps as 1:scale, e.g.  
%    1:100 000, or 1:1 000 000.  For example, PAPERSCALE(100000) or 
%    PAPERSCALE(1000000,lat,long).
%   
%    [paperXdim,paperYdim] = PAPERSCALE(...)  returns the computed paper 
%    dimensions. The dimensions are in the paper units specified. For the scale
%    calling form, the returned  dimensions are in centimeters.
%   
%    

function previewmap
%MATLAB Tour Partial Function Help:  map_con
%
%  PREVIEWMAP view map at printed size
%  
%    PREVIEWMAP changes the size of the current figure to match the printed 
%    output.  This provides an accurate display of the relative placement and 
%    size of objects as they will be printed.  If the resulting figure size 
%    exceeds the screen size, the figure will be enlarged as much as possible.
%    
%    

function tightmap
%MATLAB Tour Partial Function Help:  map_con
%
% TIGHTMAP removes whitespace around a map
%  
%    TIGHTMAP sets the MATLAB axis limits to be tight around the map in the 
%    current axes.  This eliminates or reduces the white border between the 
%    map frame and the axes box.  Use AXIS AUTO to undo TIGHTMAP.
%    
%    

function axesmui
%MATLAB Tour Partial Function Help:  map_con
%
% AXESMUI  Interactive tool for manipulating map axes properties
% 
%   AXESMUI provides an interactive tool for manipulating map properties
%   of the current axes.  AXESMUI(hndl) will manipulate the map properties
%   of the axes specified by hndl.
% 
%   C = AXESM(...) provides an optional output argument indicating if
%   the dialog window was closed by the cancel button.  If the Cancel
%   button is pushed, C = 1.  Otherwise, C = 0.
% 
%   

function colorm
%MATLAB Tour Partial Function Help:  map_con
%
% COLORM  Interactive tool creating colormaps for regular surface maps
% 
%   COLORM(map,maplegend) creates an interactive tool for creating
%   colormaps for indexed regular surface maps.  Once created, the
%   colormap can be saved to the workspace.
% 
%   

function maptrim
%MATLAB Tour Partial Function Help:  map_con
%
% MAPTRIM  Interactive trimming of a map data set
% 
%   MAPTRIM(lat,long) will display the supplied data in a new
%   figure window.  Using the menu choices and interactive zooming,
%   a region of the map can be defined and the appropriate map data
%   variables saved in the workspace.  The inputs lat and long must
%   be vector map data.  If a patch map output is selected, then the
%   input lat and long must originally represent patch map data.
% 
%   MAPTRIM(lat,long,'LineSpec') displays the vector map data using
%   the LineSpec string.
% 
%   MAPTRIM(map,maplegend) displays the matrix map data in a new figure
%   window and allows a subset of this map to be selected and saved.  The
%   output map will be a regular matrix map.  Only even multiples of the
%   input map scale can be selected as output resolutions.
% 
%   MAPTRIM(map,maplegend,'PropertyName',PropertyValue,...) displays the
%   matrix map data using the surface properties provided.  The 'Tag',
%   'UserData' and 'EdgeColor' properties can not be set.
% 
%   

function maptool
%MATLAB Tour Partial Function Help:  map_con
%
% MAPTOOL  Creates a figure window with a map axes and associated tools
% 
%   MAPTOOL creates a figure window with a map axes and activates
%   the interactive tool for specifying a map projection.
% 
%   MAPTOOL ProjectionName creates a figure window with the default
%   projection specified by ProjectionName.
% 
%   MAPTOOL('MapPropertyName',MapPropertyValue,...) creates a figure
%   window and defines a map axes using the supplied Map properties.
%   MAPTOOL supports all the same properties as AXESM.
% 
%   h = MAPTOOL(...) returns a two element vector containing the
%   handle of the Maptool figure window and the handle of the map axes.
% 
%   

function originui
%MATLAB Tour Partial Function Help:  map_con
%
% ORIGINUI  Tool for interactively modifying a map origin
% 
%   ORIGINUI provides a tool to modify the origin of a displayed map
%   projection.  A marker (dot) is displayed where the origin is
%   currently located.  This dot can be moved and the map reprojected with
%   the identified point as the new origin.
% 
%   ORIGINUI automatically toggles the current axes into a mode where
%   only actions recognized by ORIGINUI are executed.  Upon exit of
%   this mode, all prior ButtonDown functions are restored to the
%   current axes and its children.
% 
%   ORIGINUI ON activates origin tool.  ORIGINUI OFF de-activates
%   the tool.  ORIGINUI will toggle between these two states.
% 
%   ORIGINUI recognizes the following keystrokes.  RETURN will reproject
%   the map with the identified origin and remain in the originui mode.
%   ENTER reprojects the map with the identified origin and exits the
%   originui mode.  DELETE and ESCAPE will exit the origin mode
%   (same as ORIGINUI OFF).  N,S,E,W Keys move the marker North, South,
%   East or West by 10.0 degrees for each keystroke.  n,s,e,w keys move
%   the marker in the respective directions by 1 degree per keystroke.
% 
%   ORIGINUI recognizes the following mouse actions when the cursor is on
%   the origin marker.  Single click and hold moves the origin marker.
%   Double click on the marker reprojects the map with the specified
%   map origin and remains in the origin mode (same as ORIGINUI RETURN).
%   Extended click moves the marker along the cartesian X or Y direction
%   only (depending on the direction of greatest movement).  Alternative
%   click exits the origin tool (same as ORIGINUI OFF).
% 
%   For Macintosh:   Extend click - Shift click mouse button
%                    Alternate click - Option click mouse button
% 
%   For MS-Windows:  Extend click - Shift click left button or both buttons
%                    Alternate click - Control click left button or right button
% 
%   For X-Windows:   Extend click - Shift click left button or middle button
%                    Alternate click - Control click left button or right button
% 
%   

function panzoom
%MATLAB Tour Partial Function Help:  map_con
%
% PANZOOM  Pan and zoom on a 2D plot
% 
%   PANZOOM provides a graphical means for defining zoom limits
%   on a 2D plot.  A box which can be resized and moved is provided
%   on the current axes to allow the definition of a zoom area.  The
%   pan and zoom box can not be moved beyond the current axes limits
% 
%   PANZOOM automatically toggles the current axes into a mode where
%   only actions recognized by PANZOOM are executed.  Upon exit of
%   this mode, all prior ButtonDown functions are restored to the
%   current axes and its children.
% 
%   PANZOOM ON activates the pan and zoom tool.  PANZOOM OFF de-activates
%   the tool.  PANZOOM will toggle between these two states.
% 
%   PANZOOM SETLIMITS will define the zoom out limits to the current
%   settings on the axes.  PANZOOM OUT will zoom out to the current axes
%   limit settings.  PANZOOM FULLVIEW will reset the axes to their
%   full view range and resets the pan and zoom tool with these settings.
% 
%   PANZOOM recognizes the following keystrokes.  RETURN will set the axes
%   to the current zoom box and remain the in pan and zoom mode.  ENTER
%   sets the axes to the current zoom box and exits the pan and zoom
%   mode.  DELETE and ESCAPE will exit the pan and zoom mode (same as
%   PANZOOM OFF).
% 
%   PANZOOM recognizes the following mouse actions when the cursor is inside
%   the pan and zoom box.  Single click and hold on center of box moves the
%   zoom box.  Single click and hold on corners allows the box to be resized.
%   Double click on the center of the box sets the axes to the current zoom
%   box and remains in pan and zoom mode (same as PANZOOM RETURN).
% 
%   PANZOOM recognizes the following mouse actions when the cursor is
%   outside the pan and zoom box.  Single click relocates the pan and
%   zoom box centered on the cursor location.  Double click will
%   zoom out to the full view or last SETLIMITS setting.
% 
%   Regardless of the cursor location, PANZOOM recognizes the following
%   mouse actions.  Extended click zooms out by a factor of 2.  Alternative
%   click exits the pan and zoom tool (same as PANZOOM OFF).
% 
%   For Macintosh:   Extend click - Shift click mouse button
%                    Alternate click - Option click mouse button
% 
%   For MS-Windows:  Extend click - Shift click left button or both buttons
%                    Alternate click - Control click left button or right button
% 
%   For X-Windows:   Extend click - Shift click left button or middle button
%                    Alternate click - Control click left button or right button
% 
%   

function parallelui
%MATLAB Tour Partial Function Help:  map_con
%
% PARALLELUI Tool for interactively modifying map parallels
%   
%     PARALLELUI provides a tool to modify the standard parallels of a displayed 
%     map projection.  One or two red lines are displayed where the standard 
%     parallels are currently located.  The parallel lines can be dragged to new 
%     locations.  Double-clicking on one of the standard parallels reprojects the 
%     map using the new parallel locations.
%    
%     PARALLELUI ON activates parallel tool.  PARALLELUI OFF de-activates the 
%     tool.  PARALLELUI will toggle between these two states.
%   
%     

function qrydata
%MATLAB Tour Partial Function Help:  map_con
%
% QRYDATA  Links data variables for interactive queries
% 
%   QRYDATA(cellarray,...) provides a GUI to explore data sets
%   specified in the cellarray (see below).  X and Y coordinates
%   can be input and the data corresponding to this coordinate
%   is displayed.  In addition, the results of functional operations
%   using the (x,y) coordinate can be supplied, depending on the
%   definition of the cellarray.  Multiple cellarray inputs can be
%   provided, each specifying a data query to be performed.
% 
%   QRYDATA(titlestr,cellarray,...) uses the string titlestr to
%   label the figure window.
% 
%   QRYDATA(hndl,cellarray,...) and QRYDATA(hndl,titlestr,cellarray,...)
%   link the data queries to the axes specified by hndl.  In this
%   usage, coordinates of interest can then be specified by clicking
%   on the appropriate location of the axes specified by hndl.
% 
%   The CELLARRAY input is used to define the type and data for the
%   query operation.  The first cell must contain the string used
%   to label the data line in the query window.  The second cell must
%   contain either one of the pre-defined query operations, or a valid
%   user-created function name.  The pre-defined operations are 'matrix',
%   'vector', 'mapmatrix' and 'mapvector'.
% 
%   For the 'matrix' operation,  the query executes an interp2 command on
%   a data matrix.  The CELLARRAY input is {'label','matrix',x,y,z,'method'}.
%   The method string is optional (default is nearest).
% 
%   For the 'vector' operation, the query executes an interp2 command
%   (method == 'nearest') on a data matrix to determine the value at
%   the specified x and y entry.  This value is then used as
%   to index the vector of desired data.  The CELLARRAY input is
%   {'label','vector',x,y,z,vector}.
% 
%   For the 'mapmatrix' operation, the query executes a ltln2val command
%   on the supplied data matrix.  The CELLARRAY input is {'label',
%   'mapmatrix',map,maplegend,'method'}.  The method string is
%   optional (default is nearest).
% 
%   For the 'mapvector' operation, the query executes an ltln2val command
%   (method == 'nearest') on a data matrix to determine the value at
%   the specified lat and lon entry.  This value is then used as
%   to index the vector of desired data.  The CELLARRAY input is
%   {'label','mapvector',map,maplegend,vector}.
% 
%   If a user-created function name is supplied in the CELLARRAY, then
%   this must refer to an m-file of the form z = fcn(x,y,other arguments...).
%   The other arguments are the remaining elements (3 and above) of the
%   initial cell array.  The output z must be a scalar.

function uimaptbx
%MATLAB Tour Partial Function Help:  map_con
%
% UIMAPTBX  Processes the button down callbacks for the Mapping Toolbox objects
% 
%   UIMAPTBX processes the mouse events for objects displayed using
%   the Mapping Toolbox, as long as no WindowButtonDownFcn is currently
%   assigned.  To assign it to an object, set the ButtonDownFcn to 'uimaptbx'.
%   This is the default setting for all Mapping Toolbox objects.
% 
%   If UIMAPTBX is assigned to an object, the following mouse events are
%   recognized.  Single click and hold on an object displays its tag, or
%   type if no tag is specified.  Double click on an object opens up
%   the GUIDE object editor allowing all properties to be changed.
%   Extended click on an object allows the map properties to be edited.
%   Alternative click on an object allows selected properties to be
%   edited using the Click and Drag tools.
% 
%   For Macintosh:   Extend click - Shift click mouse button
%                    Alternate click - Option click mouse button
% 
%   For MS-Windows:  Extend click - Shift click left button or both buttons
%                    Alternate click - Control click left button or right button
% 
%   For X-Windows:   Extend click - Shift click left button or middle button
%                    Alternate click - Control click left button or right button
% 
%   

function trackui
%MATLAB Tour Partial Function Help:  map_con
%
%   TRACKUI  Interactive tool for adding great circles and rhumb lines to a map
% 
%   TRACKUI activates the interactive tool and associates it with the
%   current axes.  The current axes must be a map axes.
% 
%   TRACKUI(hndl)  activates the interactive tool and associates it
%   with the axes specified by hndl.  Again, the axes specified by hndl
%   must be a map axes.
% 
%   

function scirclui
%MATLAB Tour Partial Function Help:  map_con
%
%   SCIRCLUI  Interactive tool for adding small circles to a map
% 
%   SCIRCLUI activates the interactive tool and associates it with the
%   current axes.  The current axes must be a map axes.
% 
%   SCIRCLUI(hndl)  activates the interactive tool and associates it
%   with the axes specified by hndl.  Again, the axes specifed by hndl
%   must be a map axes.
% 
%   

function seedm
%MATLAB Tour Partial Function Help:  map_con
%
% SEEDM  Interactive tool encoding regular surface maps
% 
%   SEEDM(map,maplegend) creates an interactive tool for encoding
%   regular matrix maps.  Seeds can be interactively specified and the
%   encoded map generated.  The encoded map can then be saved back
%   to the workspace.
% 
%   

function surfdist
%MATLAB Tour Partial Function Help:  map_con
%
%   SURFDIST  Interactive tool for distance, azimuth and reckoning calculations
% 
%   SURFDIST activates the interactive tool.  If the current axes have a
%   proper map definition, then the tool will be associated with the axes.
%   Otherwise, the tool will not be associated with any axes.
% 
%   SURFDIST(hndl)  activates the interactive tool and associates it
%   with the axes specified by hndl. The axes specifed by hndl
%   must be a map axes.
% 
%   SURFDIST([]) activates the tool and does not associate it with any
%   axes, regardless of whether the current axes has a valid map definition.
% 
%   

function mlayers
%MATLAB Tour Partial Function Help:  map_con
%
% MLAYERS  GUI for display layers of a geographic data structure
% 
%   MLAYERS allows interactive display of Mapping Toolbox Geographic
%   Data Structures.  The data structure is either stored in a workspace
%   or provided as a cell array input to MLAYERS.
% 
%   MLAYERS(Workspace) will search the data in Workspace.mat for layer
%   structures.  If found, these layers will be associated with the
%   current map axes.  The input Workspace must be a string.
% 
%   MLAYERS(Workspace,hndl) will assign the layers in Workspace.mat to
%   the map axes specified by hndl.
% 
%   MLAYERS(CellArray) will take the layers specified in CellArray and
%   associate them with the current map axes.  The CellArray must be n by 2.
%   Each row of the cell array represents a layer.  The first column
%   must contain the layer structure and the second column must contain
%   the name of the layer structure.
% 
%   This CellArray can be prepared from structures in the current
%   workspace using ROOTLAYR. The calling sequence in this case would be
%   rootlayr;mlayers(ans)
% 
%   MLAYERS(CellArray,hndl) will take the layers specified in CellArray
%   to the map axes specified by hndl.
% 
%   For further details on creating a Geographic Data Structure, consult
%   the Mapping Toolbox User Guide.
% 
%   

function mobjects
%MATLAB Tour Partial Function Help:  map_con
%
% MOBJECTS  GUI for manipulating objects displayed on an axes
% 
%   MOBJECTS allows interactive manipulating of object sets on the
%   current axes.  Each object set is defined as all objects with
%   identical tags.  If no tags are supplied, then the set is
%   defined by the object type.
% 
%   MOBJECTS(hndl) associates the object set tool with the axes
%   specified by the input handle hndl.
% 
%   

function rootlayr
%MATLAB Tour Partial Function Help:  map_con
%
%   ROOTLAYR  Construct mlayers cell array input for current workspace
% 
%   ROOTLAYR constructs the cell array input to be used for mlayers
%   for the base workspace.  This will process each variable in
%   the workspace to determine if it is a structure.  All structures
%   are included in the cell array constructed for the MLAYERS tool.
%   The cell array is provided in the variable ans.
% 
%   This is a script to allow its operation on the base workspace.
%   The recommended calling procedure is:  rootlayr;mlayers(ans).
% 
%   Note:  This script will create a temporary variable MLAYERSINPUTS,
%          which is cleared upon successful completion.
% 
%   

function clrmenu
%MATLAB Tour Partial Function Help:  map_con
%
% CLRMENU Add a colormap menu to a figure window.
% 
%   CLRMENU adds a colormap menu choices to the current figure.
% 
%   CLRMENU(h) adds the menu choices to the figure window specified
%   by the handle h.
% 
%   Each of the menu choices operates on the colormap:
%   HOT, PINK, COOL, BONE, JET, COPPER, SPRING, SUMMER, AUTUMN,
%   WINTER, FLAG and PRISM are names of functions which generate colormaps.
%   RAND is a random colormap.
%   BRIGHTEN increases the brightness.
%   DARKEN decreases the brightness.
%   FLIPUD inverts the order of the colormap entries.
%   FLIPLR interchanges the red and blue components.
%   PERMUTE cyclic permuations: red -> blue, blue -> green, green -> red.
%   SPIN spins the colormap, which is a rapid sequence of FLIPUD's.
%   DEFINE allows a workspace variable to be specied for the colormap
%   DIGITAL MAP creates a digital elevation colormap using DEMCMAP
%   POLITICAL MAP creates a political colormap using POLCMAP
%   REMEMBER pushes a copy of the current colormap onto a stack.
%   RESTORE pops a map from the stack (initially, the stack contains the
%        map in use when CLRMENU was invoked.)

function coast
%MATLAB Tour Partial Function Help:  map_con
%
% COAST coastline data
%   
%   ll = COAST returns the world vector shoreline in the coast MAT-file as a 
%   two-column vector of latitudes and longitudes in degrees.
%   
%   

function usahi
%MATLAB Tour Partial Function Help:  map_con
%
%  USAHI returns data from the USAHI atlas data file
%  
%    USAHI types a list of the atlas data variables in the USAHI Mat-file to 
%    the screen.
%    
%    s = USASHI('request') returns the requested variable.  Valid requests are 
%    'stateline','statepatch', and 'statetext'.  This command can be used as 
%    an argument to other commands, such as DISPLAYM(USAHI('statepatch')).  
%   
%    

function usalo
%MATLAB Tour Partial Function Help:  map_con
%
%  USALO returns data from the USALO atlas data file
%  
%    USALO types a list of requests for the USALO Mat-file to the screen.
%    
%    s = USASLO('request') returns the requested data.  Valid requests for two 
%    column vectors are 'conusvec', 'statebvec' and 'gtlakevec'.  Valid 
%    requests for geographic data structures are 'conus', 'state', 
%    'stateborder' and 'greatlakes'.  This command can be used as an argument 
%    to other commands, such as DISPLAYM(USALO('conus')).
%   
%    

function worldlo
%MATLAB Tour Partial Function Help:  map_con
%
%  WORLDLO returns data from the WORLDLO atlas data file
%  
%    WORLDLO types a list of the atlas data variables in the WORLDLO Mat-file to
%    the screen.
%    
%    s = WORLDLO('request') returns the requested variable.  Valid requests 
%    are 'POline', 'POpatch', 'POtext', 'PPpoint', 'PPtext', 'DNline', 
%    'DNpatch', 'oceanmask' and 'gazette'.  This command can be used as an 
%    argument to other commands, such as DISPLAYM(WORLDLO('POline')).
%   
%    

function loadcape
%MATLAB Tour Partial Function Help:  map_con
%
% LOADCAPE load Cape Cod elevation image into a regular matrix map

function loadmoonalb
%MATLAB Tour Partial Function Help:  map_con
%
% LOADMOONALB load moon albedo image into a regular matrix map
% 
%  LOADMOONALB loads a albedo map of the Earth's moon into the regular matrix 
%  map variables moonalb and moonalblegend. The string variable CAPTION contains
%  a description and source of the data.
% 
%  

function grepfields
%MATLAB Tour Partial Function Help:  map_con
%
% GREPFIELDS identifies matching records in fixed record length files
%  
%    GREPFIELDS('FILENAME','SEARCHSTRING') displays lines in the file that 
%    begin with the search string.  The file must have fixed length records 
%    with line endings.
%  
%    GREPFIELDS('FILENAME','SEARCHSTRING',CASESENS), with 
%    CASESENS 'matchcase' specifies a case-sensitive search.  If 
%    omitted or 'none', the search string will match regardless of the case.
%  
%    GREPFIELDS('FILENAME','SEARCHSTRING',CASESENS,STARTCOL) searches 
%    starting with the specified column.  STARTCOL is an integer between 1 and 
%    the bytes per record in the file.  In this calling form, the file is 
%    regarded as a text file with line endings.
%    
%    GREPFIELDS('FILENAME','SEARCHSTRING',CASESENS,STARTFIELD,FIELDS) 
%    searches within the specified field.  STARTFIELD is an integer between 1 
%    and the number of fields per record.  The format of file is described by 
%    the FIELDS structure.  See READFIELDS for recognized FIELDS structure 
%    entries.  In this calling form, the file can be binary and lack line 
%    endings.  The search is within STARTFIELD, which must be a character 
%    field.
%  
%    GREPFIELDS('FILENAME','SEARCHSTRING',CASESENS,STARTFIELD,FIELDS,MACHINEFORMAT) 
%    opens the file with the specified machine format.  MACHINEFORMAT must be 
%    recognized by FOPEN.
%  
%    indx = GREPFIELDS(...) returns the record numbers of matched records 
%    instead of displaying them on-screen.
%    
%    

function nanclip
%MATLAB Tour Partial Function Help:  map_con
%
% NANCLIP  Clips vector data with NaNs at specified pen-down locations
% 
%   mat = NANCLIP(datain) creates NaN clipped vectors from pen-down
%   identified vectors.  The first column in datain must contain the
%   pen-down commands identifying the start of a new vector.  The output
%   argument, mat, will have n-1 columns, where n is the number of
%   columns of datain.  The assumed pen down command is a -1 at the
%   proper location in the first column of the input matrix.
% 
%   mat = NANCLIP(datain,pendowncmd) uses the specifed input scalar
%   pendowncmd.
% 
%   

function rc2yx
%MATLAB Tour Partial Function Help:  map_con
%
% RC2YX Row and column indices to x and y coordinates
% 
%  [ygrat,xgrat] = RC2YX(rowgrat,colgrat,y1,x1,yperrow,xpercol) computes y and x
%   coordinates from row and column indices. rowgrat and colgrat are matrices 
%   of the same size containing integer row and column indices for a grid with 
%  the upper left corner at the Cartesian coordinates x1 and y1. yperrow and 
%  xpercol are the y and x increment per row and column. The outputs ygrat and 
%  xgrat are the cartesian coordinates corresponding to matrix locations rowgrat
%  and colgrat.
% 
%  

function readfields
%MATLAB Tour Partial Function Help:  map_con
%
% READFIELDS reads fields or records from a fixed format file
%  
%  struc = READFIELDS(filename,filestruct) reads all the records from a fixed 
%  format file.  Filename is a string containing the name of the file. If it 
%  is empty, the file is selected interactively. filestruct is structure defining 
%  the format of the file. The contents of filestruct are described below. The 
%  result is returned in a structure.
%  
%  struc = READFIELDS(filename,filestruct,recordIDs) reads only the records 
%  specified in the vector recordIDs.  For example, recordIDs = [1 2 4].  All 
%  of the fields in the selected records are read.
%  
%  struc = READFIELDS(filename,filestruct,fieldIDs) reads only the fields 
%  specified in the cell array fieldIDs. For example, fieldIDs = {1 2 4}. The 
%  selected fields are read from all of the records. fieldIDs may be used 
%  in place of recordIDs in all calling forms.
%  
%  struc = READFIELDS(filename,filestruct,recordIDs,machineformat) opens the file 
%  with the specified machine format.  machineformat must be recognized by 
%  FOPEN.
%  
%  struc = READFIELDS(filename,filestruct,recordIDs,machineformat,fid) reads from a 
%  file that is already open. The records are read starting from the current 
%  location in the file. 
%  
%  The format of the file is described in the input argument filestruct.  
%  filestruct is a structure with one entry for every field in the file.  
%  filestruct has three required fields: length, name and type.  For fields 
%  containing data binary data of the type that would be read by FREAD, length 
%  is the number of elements to be read, name is a string containing the 
%  fieldname under which the read data will be stored in the output structure, 
%  and type is a format string recognized by FREAD. Repetition modifiers such 
%  as '40*char' are NOT supported.  Fields with empty fieldnames are omitted 
%  from the output.
%  
%  The following filestruct definition is for a file with a 40 character 
%  character field, a field containing two integers, and a field with a 
%  single-precision floating point number.
%  
%    filestruct(1).length = 40;     
%    filestruct(1).name = 'character Field';  % spaced will be suppressed					
%    filestruct(1).type = 'char';
%    
%    filestruct(2).length = 2;     
%    filestruct(2).name = 'integer Field';  % spaced will be suppressed					
%    filestruct(2).type = 'int16';
%    
%    filestruct(3).length = 1;     
%    filestruct(3).name = 'float Field';  % spaced will be suppressed					
%    filestruct(3).type = 'real*4';
%  
%  
%  The type can also be a FSCANF and SSCANF-style format string of the form 
%  '%nX', where n is the number of characters within which the formatted data 
%  is found, and X is the conversion character such as g or d.  For formatted 
%  fields, the length entry in filestruct is the number of elements, each of 
%  which have the width specified in the type string.  Fortran-style double 
%  precision output such as '0.0D00' may be read using a type string such as 
%  '%nD', where n is the number of characters per element.  This is an 
%  extension to the C-style format strings accepted by SSCANF. Users unfamiliar 
%  with C should note that '%d' is preferred over '%i' for formatted integers. 
%  Matlab follows C in interpreting '%i' integers with leading zeros as octal.  
%  Line ending characters in ASCII files must also be counted in the filestruct 
%  specification. Note that the number of line ending characters differs across 
%  platforms.
%  
%  A field specification for a formatted field with two integers each 6 
%  characters wide would be
%  
%    filestruct(4).length = 2;     
%    filestruct(4).name = 'Elevation Units';  					
%    filestruct(4).type = '%6d'
%  
%  To summarize, length is number of elements for binary numbers, the number 
%  of characters for strings, and the number of elements for formatted data.
%  
%  Fields can be omitted from all output by providing an empty string for the 
%  filestuct name field.
%  
%  

function readmtx
%MATLAB Tour Partial Function Help:  map_con
%
% READMTX read a matrix stored in a file
%  
%   mtx = READMTX(filename,nrows,ncols,precision) reads a matrix stored in a 
%   file.  The file contains only a matrix of numbers with the dimensions 
%   nrows by ncolumns stored with the specified precision.  Recognized 
%   precision strings are described below.
%  
%   READMTX(filename,nrows,ncols,precision,readrows,readcols) reads a subset 
%   of the matrix.  readrows and readcols specify which rows and columns are 
%   to be read.  They can be vectors containing the row or column numbers, or 
%   two-element row vectors of the form [start end], which are expanded using  
%   the colon operator to start:1:end. To read just two noncontiguous rows or 
%   columns, provide the indices as a column matrix.
%   
%   READMTX(filename,nrows,ncols,precision,readrows,readcols,machineformat) 
%   specifies the format used to write the file. machineformat can be any 
%   string recognized by FOPEN. This option is used to automatically swap 
%   bytes for file written on platforms with a different byte ordering.
%  
%   READMTX(filename,nrows,ncols,precision,readrows,readcols,machineformat,...  
%   nheadbytes) skips the file header, whose length is specified in bytes.
%  
%   READMTX(filename,nrows,ncols,precision,readrows,readcols,machineformat,...  
%   nheadbytes,nRowHeadBytes) also skips a header which precedes every row of 
%   the matrix.  The length of the header is specified in bytes.
%  
%   READMTX(filename,nrows,ncols,precision,readrows,readcols,machineformat,...  
%   nheadbytes,nRowHeadBytes,nRowTrailBytes) also skips a trailer which 
%   follows every row of the matrix.  The length of the trailer is 
%   specified in bytes.
%  
%   READMTX(filename,nrows,ncols,precision,readrows,readcols,machineformat,...  
%   nheadbytes,nRowHeadBytes,nRowTrailBytes,nFileTrailBytes) accounts for the 
%   length of data following the matrix. The sizes of the components of the 
%   matrix are used to compute an expected file size, which is compared to 
%   the actual file size.
%  
%   READMTX(filename,nrows,ncols,precision,readrows,readcols,machineformat,...
%   nheadbytes,nRowHeadBytes,nRowTrailBytes,nFileTrailBytes,recordlen) 
%   overrides the record length calculated from the precision and number of 
%   columns, and instead uses the record length given in bytes. This is used 
%   for formatted data with extra spaces or line breaks in the matrix. 
%  
%   This function reads both binary and formatted data files.  If the file is 
%   binary, the precision argument is a format string recognized by FREAD. 
%   Repetition modifiers such as '40*char' are NOT supported.  
% 
%   If the file is formatted with a fixed format (the number of characters per
%   number is fixed), precision is a FSCANF and SSCANF-style format string of  
%   the form '%nX', where n is the number of characters within which the  
%   formatted data is found, and X is the conversion character such as g or d.  
%   Fortran-style double precision output such as '0.0D00' may be read using a 
%   precision string such as '%nD', where n is the number of characters per 
%   element.  This is an extension to the C-style format strings accepted by 
%   SSCANF. Formatted files with line endings need to provide the number of 
%   trailing bytes per row, which may be 1 for platforms with carriage returns 
%   OR linefeed (Macintosh, Unix) , or 2 for platforms with carriage returns 
%   AND linefeeds (DOS).
% 
%   This function also reads formatted files with a variable number of 
%   characters per row. Use a precision string of the form '%X', where 
%   X is the conversion character such as g or d.  Users unfamiliar with 
%   C should note that '%d' is preferred over '%i' for formatted integers, 
%   because Matlab follows C in interpreting '%i' integers with leading zeros 
%   as octal. All values for a row of the matrix must be stored within a single 
%   record (no line breaks within a row).
%  
%   

function spcread
%MATLAB Tour Partial Function Help:  map_con
%
% SPCREAD  Read columns of data from an ascii text file
% 
%   mat = SPCREAD reads two columns of data from an ascii text file
%   into the workspace.  The file name is supplied by a dialog box.
%   This function reads the file signifcantly faster than DLMREAD when
%   a space delimiter is supplied.
% 
%   mat = SPCREAD(filename) reads the data from the file name specifed.
% 
%   mat = SPCREAD(cols) and mat = SPCREAD(filename,cols) assumes that
%   the ascii text file contains the number of columns specified by cols.
% 
%   

function yx2rc
%MATLAB Tour Partial Function Help:  map_con
%
% YX2RC X and Y coordinates to row and column indices
%  [rowgrat,colgrat] = YX2RC(ygrat,xgrat,y1,x1,yperrow,xpercol) computes row 
%  and column indices from y and x coordinates. ygrat and xgrat are the 
%  cartesian coordinates for a grid with the upper left corner at coordinates 
%  x1 and y1. yperrow and xpercol are the y and x increment per row and column. 
%  The outputs rowgrat and colgrat correspond to matrix locations ygrat and 
%  xgrat.
% 
%  

function avhrrgoode
%MATLAB Tour Partial Function Help:  map_con
%
% AVHRRGOODE reads AVHRR data stored in the Goode Projection
%  
%   [latgrat,longrat,map] = AVHRRGOODE reads data from an Advanced Very High 
%   Resolution Radiometer (AVHRR) dataset with a nominal resolution of 1 km 
%   that is stored in the Goode projection.  Data of this type includes a 
%   nondimensional vegetation index (NDVI) and Global Land Cover 
%   Characteristics (GLCC).  These files have 17347 rows and 40031 columns of 
%   data, or somehat more than the capacity of one CD-ROM. The file is 
%   selected interactively.  Data is returned as a general matrix map with the 
%   graticule matrices in units of degrees.
%  
%   [...] = AVHRRGOODE('region') Reads data from a file with data covering the 
%   specified region.  Valid regions are 'g' or 'global', 'af' or 'africa', 
%   'ap' or 'australia/pacific', 'ea' or 'eurasia', 'na' or 'north america', 
%   'sa' or 'south america', 'af' or 'africa'.  The file is selected 
%   interactively.  If omitted, 'global' is assumed.
%   
%   AVHRRGOODE('region','filename') uses the provided filename.
%   
%   AVHRRGOODE('region','filename',scalefactor) uses the integer scalefactor 
%   to downsample the data.  A scalefactor of 1 returns every point.  A 
%   scalefactor of 10 returns every 10th point.  If omitted, 100 is assumed.
%   
%   AVHRRGOODE('region','filename',scalefactor,latlim,lonlim) returns data for 
%   the specified region.  The returned data will extend somewhat beyond the 
%   requested area.  If omitted, the entire area covered by the data file is 
%   returned. The limits are two element vectors in units of degrees, with 
%   latlim in the range [-90 90] and lonlim in the range [-180 180].
%  
%   AVHRRGOODE('region','filename',scalefactor,latlim,lonlim,gsize) controls 
%   the size of the graticule matrices.  Gsize is a two-element vector 
%   containing the number of rows and columns desired.  If omitted, a 
%   graticule the size of the map is returned.
%  
%   AVHRRGOODE('region','filename',scalefactor,latlim,lonlim,gsize,fnrows,fncols) 
%   overrides the standard file format for the selected region.  This is 
%   useful for data stored on CD-ROM, which may have been truncated to fit.  
%   Some data was distributed with 16347 rows and 40031 columns of data on 
%   CD-ROMS. Nondimensional vegetation index data at 8 km spatial resolution 
%   has 2168 rows and 5004 columns.
%  
%   AVHRRGOODE('region','filename',scalefactor,latlim,lonlim,gsize,...  
%   fnrows,fncols,resolution) reads a dataset with the spatial resolution 
%   specified in meters.  If omitted, the full resolution of 1000 meters is 
%   assumed.  Data is also available at 8000 meter resolution.
%  
%   AVHRRGOODE('region','filename',scalefactor,latlim,lonlim,gsize,...  
%   fnrows,fncols,resolution,'precision') reads a dataset with the integer 
%   precision specified.  If omitted, 'uint8' is assumed.  'uint16' is 
%   appropriate for some files.  Check the data's README file for 
%   specification of the file format and contents.
%  
%   The AVHRR project and datasets are described in 
%     http://daac.gsfc.nasa.gov/DATASET_DOCS/avhrr_dataset.html
%     http://daac.gsfc.nasa.gov/CAMPAIGN_DOCS/FTP_SITE/readmes/pal.html
%     http://edcwww.cr.usgs.gov/landdaac/1KM/1kmhomepage.html
%     http://edcwww.cr.usgs.gov/landdaac/glcc/glcc_na.html
%   
%   Some sources for the data include
%     <ftp://daac.gsfc.nasa.gov/data/avhrr/>
%     <ftp://edcftp.cr.usgs.gov/pub/data/glcc/>
% 
%   This function reads the binary files as-is. You should not use byte swapping
%   software on these files.
%  
%   

function dcwdata
%MATLAB Tour Partial Function Help:  map_con
%
% DCWDATA extracts selected data from the Digital Chart of the World
% 
%  struc = DCWDATA(library,latlim,lonlim,theme,topolevel) reads
%  the data for the specified theme and topology level directly from the
%  named DCW CD-ROM. There are four CD's, one each for the library: 'NOAMER'
%  (North America), 'SASAUS' (Southern Asia and Australia), 'EURNASIA'
%  (Europe and Northern Asia) and 'SOAMAFR' (South America and Africa).
%  The desired theme is specified by a two letter code string.  A list of
%  valid codes will be displayed when an invalid code, such as '?', is
%  entered.  The region of interest can be given as a point latitude and
%  longitude or as a region with two-element vectors of latitude and
%  longitude limits.  The units of latitude and longitude are degrees.
%  The data covering the requested region is returned, but will include
%  data extending to the edges of the 5 by 5 degree tiles.  The result is
%  returned as a Mapping Toolbox Geographic Data Structure.
% 
%  [struc1, struc2, ...]  = ...
%  DCWDATA(library,latlim,lonlim,theme,{topolevel1,topolevel2,...})
%  reads several topology levels.  The levels must be specified as a cell
%  array with the entries 'patch', 'line', 'point' or 'text'.  Entering
%  {'all'} for the topology level argument is equivalent to {'patch',
%  'line', 'point','text'}. Upon output, the data are returned in the
%  output arguments by topology level in the same order as they were
%  requested.
% 
%  DCWDATA(devicename,library,latlim,...) specifies the logical device
%  name of the CD-ROM for computers which do not automatically name the
%  mounted disk.
% 
%  The Digital Chart of the World is now out of print, and has been 
%  superceded by the Vector Map Level 0 (VMAP0). The documentation 
%  for the VMAP0DATA function has more information on VMAP0.
% 
%  

function dcwgaz
%MATLAB Tour Partial Function Help:  map_con
%
% DCWGAZ searches for entries in a Digital Chart of the World Gazzette file
% 
%  DCWGAZ(library,object) searches the DCW gazette for items
%  beginning with the object string.  There are four CD's, one for each
%  library: 'NOAMER' (North America), 'SASAUS' (Southern Asia and
%  Australia), 'EURNASIA' (Europe and Northern Asia) and 'SOAMAFR' (South
%  America and Africa).  Items which exactly match or begin with the
%  object string are displayed on screen.
% 
%  mtextstruc = DCWGAZ(library,object) displays the matched items
%  on screen and returns a Mapping Toolbox Geographic Data Structure with
%  the matches as text entries.  This structure contains the latitude,
%  longitude and theme.
% 
%  [mtextstruc,mpointstruc] = DCWGAZ(library,object) returns the
%  matches in structures formatted as text and as points.
% 
%  DCWGAZ(devicename,library,object) specifies the logical device
%  name of the CD-ROM for computers which do not automatically name
%  the mounted disk.
% 
%  

function dcwread
%MATLAB Tour Partial Function Help:  map_con
%
% DCWREAD reads a Digital Chart of the World file
% 
%  DCWREAD reads a DCW file.  The user may select the file interactively.
% 
%  DCWREAD(filepath,filename) reads the specified file.  The combination
%  [filepath filename] must form a valid complete filename.
% 
%  DCWREAD(filepath,filename,recordIDs) reads selected records or
%  fields from the file.  If recordIDs is a scalar or a vector of
%  integers, the function returns the selected records.  If recordIDs is
%  a cellarray of integers, all records of the associated fields are
%  returned.
% 
%  DCWREAD(filepath,filename,recordIDs,field,varlen) uses previously read
%  field and variable length record information to skip parsing the file
%  header.
% 
%  struc = DCWREAD...  returns the file contents in a structure.
% 
%  [struc,field] = DCWREAD...  returns the contents and a structure
%  describing the format of the file.
% 
%  [struc,field,varlen] = DCWREAD ...  also returns a vector describing
%  which fields have variable length records.
% 
%  [struc,field,varlen,description] = DCWREAD ...  adds the string
%  describing the contents of the file to the output arguments.
% 
%  [struc,field,varlen,description,narrativefile] = DCWREAD ...  also
%  returns the name of the narrative file for the current file.
% 
%  

function dted
%MATLAB Tour Partial Function Help:  map_con
%
% DTED read U.S. Department of Defense Digital Terrain Elevation Data (DTED) data
% 
%   [map,maplegend] = DTED returns all of the elevation data in a DTED file as 
%   a regular matrix map with elevations in meters.  The file is selected 
%   interactively.  This function reads the DTED elevation files, which 
%   generally have filenames ending in ".dtN", where N is 0,1,2,3,...  .
% 
%   [map,maplegend] = DTED(filename) returns all of the elevation data in the 
%   specified DTED file.  The file must be found on the Matlab path.  If not 
%   found, the file may be selected interactively.
% 
%   [map,maplegend] = DTED(filename,scalefactor) returns data from the 
%   specified DTED file, downsampled by the scalefactor.  If omitted, a 
%   scalefactor of 1 is assumed.
%  
%   [map,maplegend] = DTED(filename,scalefactor,latlim,lonlim) reads the data 
%   for the part of the DTED file within the latitude and longitude limits.  
%   The limits must be two-element vectors in units of degrees.
% 
%   [map,maplegend,UHL,DSI,ACC] = DTED(...)  also returns the DTED User Header 
%   Label (UHL), Data Set Identification (DSI) and ACCuracy metadata records 
%   as structures.  Documentation describing the meaning of these records is 
%   available online at 
%   http://164.214.2.59/publications/specs/printed/DTED/dted1-2.doc.
% 
%   DTED files contain digitial elevation maps covering 1 by 1 degree 
%   quadrangles at horizontal resolutions ranging from about 1 kilometer to 1 
%   meter.  The 1 kilometer data is available online at 
%       http://164.214.2.59/geospatial/products/DTED/dted.html 
%   The higher resolution data is available to the U.S. Department of Defense 
%   and its contractors from the National Imagery and Mapping Agency (NIMA).
% 
%   A third-party description of the DTED data may be found at
%         http://www.fas.org/irp/program/core/dted.htm
%   Detailed official documentation is available at 
%         http://164.214.2.59/publications/specs/printed/DTED/dted1-2.doc.
%  
%   The DTED files are binary.  No line ending conversion or byte swapping is 
%   required.
% 
%  

function egm96geoid
%MATLAB Tour Partial Function Help:  map_con
%
%  EGM96GEOID 15-minute gridded geoid heights from the EGM96 geoid model of the Earth
%  
%   [map,maplegend] = EGM96GEOID(scalefactor) reads the data for the entire 
%   world, downsampling the data by the scale factor.  The result is returned 
%   as a regular matrix map and associated map legend.  Heights are given in 
%   meters in the tide-free system.
%  
%   [map,maplegend] = EGM96GEOID(scalefactor,latlim,lonlim) reads the data for 
%   the part of the world within the latitude and longitude limits.  The 
%   limits must be two-element vectors in units of degrees.  Longitude limits 
%   can be defined in the range [-180 180] or [0 360].  For example, lonlim = 
%   [170 190] returns data centered on the dateline, while lonlim = [-10 10] 
%   returns data centered on the prime meridian.
%  
%   This function reads the 15-minute EGM96 grid file 'WW15MGH.GRD'.
%   PC users should download the DOS self-extracting executable in 
%       <ftp://164.214.2.59/pub/gg/gravity3/ww15mgh.exe>.  
%   Other users should download and extract the unix compressed file at 
%       <ftp://164.214.2.59/pub/gg/gravity3/WW15MGH.GRD.Z>.  
%   Do not modify the file once it has been extracted.
%  
%   Information on the dataset may be found at 
%   http://cddisa.gsfc.nasa.gov/926/egm96/egm96.html.
%  
%   

function etopo5
%MATLAB Tour Partial Function Help:  map_con
%
% ETOPO5  ETOPO5 Global 5-Min digital terrain data extraction
% 
%  [map,maplegend] = ETOPO5(scalefactor) reads the data for the entire
%  world, downsampling the data by the scale factor. The result is
%  returned as a regular matrix map and associated map legend.
%  Scalefactor is an integer, which when equal to 1 gives the data
%  at its full resolution (1080 by 4320 values).  When scalefactor is 
%  an integer n larger than one, every nth point is returned.  The 
%  scalefactor must divide evenly into the number of rows and columns 
%  in the data file. Data values are in whole meters, representing 
%  the elevation of the center of each cell.
% 
%  [map,maplegend] = ETOPO5(scalefactor,latlim,lonlim) reads the data for
%  the part of the world within the latitude and longitude limits. The
%  limits must be two-element vectors in units of degrees.
% 
%  The ETOPO5 data files (etopo5.southern.bat and etopo5.northern.bat)
%  are available over the Internet from The MathWorks
%  <ftp://ftp.mathworks.com/pub/mathworks/toolbox/map/extMapData/>
% 
%  

function fipsname
%MATLAB Tour Partial Function Help:  map_con
%
%  FIPSNAME reads the name file used to index the TIGER thinned boundary files
% 
%  s = FIPSNAME opens a file selection window to pick a file, reads
%  the Federal Information Processing Standard codes, and returns them
%  in a structure.
% 
%  s = FIPSNAME(filename) reads the specified file.
% 
%  

function gshhs
%MATLAB Tour Partial Function Help:  map_con
%
% GSHHS  Extracts Global Self-consistent Hierarchical High-resolution Shoreline data
%  
%   struc = GSHHS(filename) reads the specified gshhs file and extracts data 
%   for the entire world.  The result is returned as a geographic data 
%   structure.  Each element of struc represents a unique polygon.  The tag 
%   field for each element contains the topographic level represented by the 
%   polygon, and will be either 'land', 'lake', 'island' for an island in a 
%   lake, or 'pond' for a pond on an island in a lake.  GSHHS files have 
%   filenames of the form 'gshhs_X.b', where X is one of the letters c, l, i, h 
%   and f, corresponding to increasing resolution (and file size).
%  
%   struc = GSHHS(filename,latlim,lonlim) reads the data for the part of the 
%   world within the latitude and longitude limits.  The limits must be 
%   two-element vectors in units of degrees. Longitude limits should be 
%   between [-180 195].
%  
%   GSHHS(filename,'createindex') creates an index file for faster
%   reading.  The index file has the same name the GSHHS data file, but with 
%   the extension 'i', instead of 'b'.  The file is written in the present 
%   working directory, which can be identified with the command PWD.  This file 
%   is needed for acceptable performance with the larger datasets.  No map data 
%   is returned while creating the index.
%  
%   The GSHHS data in various resolutions is available over the Internet from 
%   <ftp://ftp.ngdc.noaa.gov/MGG/shorelines> and 
%   <ftp://kiawe.soest.hawaii.edu/pub/wessel/gshhs/>
%   
%   Information on the datasets is available from 
%   <http://www.ngdc.noaa.gov/mgg/shorelines/gshhs.html>
%  
%  

function gtopo30
%MATLAB Tour Partial Function Help:  map_con
%
% GTOPO30 30-Arc-Sec global digital elevation data extraction
% 
%  [map,maplegend] = GTOPO30(filename,scalefactor) reads the GTOPO30
%  files and returns the result as a regular matrix map.  The filename is
%  given as a string which does not include the extension.  If the
%  files are not found on the Matlab path, they may be selected interactively.
%  Scalefactor is an integer, which when equal to 1 gives the data
%  at its full resolution.  When scalefactor is an integer n larger
%  than one, every nth point is returned.  The scalefactor must divide
%  evenly into the number of rows and columns in the data file. The map data
%  is returned as an array of elevations and associated regular matrix map
%  legend. Elevations are given in meters above mean sea level using WGS 84
%  as a horizontal datum.
% 
%  [map,maplegend] = GTOPO30(fname,scalefactor,latlim,lonlim)
%  allows a subset of the map data to be read. The limits of the desired
%  data are specified as vectors of latitude and longitude in degrees.
%  The elements of latlim and lonlim must be in ascending order.
% 
%  The data is available over the Internet via anonymous ftp from
%  <ftp://edcftp.cr.usgs.gov/pub/data/gtopo30/global>. The data and
%  some documentation is also available over the World-Wide-Web from
%  <http://edcwww.cr.usgs.gov/landdaac/gtopo30/gtopo30.html> and
%  <http://edcwww.cr.usgs.gov/landdaac/gtopo30/README.html>.
% 
%  

function readfk5
%MATLAB Tour Partial Function Help:  map_con
%
%  READFK5 read the Fifth Fundamental Catalog of stars and its extension
% 
%  d = READFK5(filename) reads the FK5 file and returns the contents in
%  a structure. Each star is an element in the structure, with the
%  star properties stored in appropriately named fields.
% 
%  d = READFK5(filename,d) appends the data in the file to an existing
%  structure.
% 
%  

function satbath
%MATLAB Tour Partial Function Help:  map_con
%
% SATBATH global 2-minute (4 km) topography from satellite bathymetry
%    
%   [latgrat,longrat,map] = SATBATH reads the global topography file for the 
%   entire world, returning every 50th point.  The result is returned as a 
%   general matrix map.
%  
%   [latgrat,longrat,map] = SATBATH(scalefactor) returns the data for the 
%   entire world, subsampled by the integer scalefactor.  A scalefactor of 10 
%   returns every 10th point.  The matrix at full resolution has 6336 by 10800 
%   points.
%  
%   [latgrat,longrat,map] = SATBATH(scalefactor,latlim,lonlim) returns data 
%   for the specified region.  The returned data will extend slightly beyond 
%   the requested area.  If omitted, the entire area covered by the data file 
%   is returned.  The limits are ascending two element vectors in units of 
%   degrees.
%  
%   [latgrat,longrat,map] = SATBATH(scalefactor,latlim,lonlim,gsize) controls 
%   the size of the graticule matrices.  Gsize is a two-element vector 
%   containing the number of rows and columns desired.  If omitted, a 
%   graticule the size of the map is returned.
% 
%   The data is available over the Internet via anonymous ftp from 
%   <ftp://topex.ucsd.edu/pub/global_topo_2min/topo_6.2.img>.
%   This function reads the binary files as-is. You should not use byte swapping
%   software on these files.
%  
%   Some documentation is also available over the World-Wide-Web from 
%   <http://topex.ucsd.edu/marine_topo/mar_topo.html> and 
%   <http://www.ngdc.noaa.gov/mgg/announcements/announce_predict.html>.
%  
%   

function tbase
%MATLAB Tour Partial Function Help:  map_con
%
% TBASE  TerrainBase Global 5-Min digital terrain data extraction
% 
%  [map,maplegend] = TBASE(scalefactor) reads the data for the entire
%  world, downsampling the data by the scale factor. The result is
%  returned as a regular matrix map and associated map legend.
%  Elevations and depths are given in meters above or below mean sea level.
% 
%  [map,maplegend] = TBASE(scalefactor,latlim,lonlim) reads the data for
%  the part of the world within the latitude and longitude limits. The
%  limits must be two-element vectors in units of degrees. Longitude limits 
%  can be defined in the range [-180 180] or [0 360]. For example,
%  lonlim = [170 190] returns data centered on the dateline, while 
%  lonlim = [-10 10] returns data centered on the prime meridian.
% 
%  The TerrainBase dataset is available over the Internet at
%  (ftp://ftp.ngdc.noaa.gov/Solid_Earth/CD_ROMS/TerrainBase_94/data/)
%  Download the file in binary mode. Don't swap the bytes or change line 
%  endings.
% 
%  

function tgrline
%MATLAB Tour Partial Function Help:  map_con
%
% TGRLINE  TIGER/Line data extraction
% 
%  [CL,PR,SR,RR,H,AL,PL] = TGRLINE(filename) reads the set of 1994
%  TIGER/line files which share the same filename, but
%  different extensions. The results are returned in a set of geographic
%  data structures containing the county boundaries, primary roads,
%  secondary roads, railroads, hydrography, area landmarks and point
%  landmarks, respectively. The data is tagged with the name of the
%  features.
% 
%  [CL,PR,SR,RR,H,AL,PL] = TGRLINE(fname,year) reads the TIGER line files
%  in the format from that year. TIGER/Line files are updated
%  periodically, and the format and filename extensions may change from
%  year to year. Valid years are 1990, 1992, 1994 and 1995.
% 
%  [CL,PR,SR,RR,H,AL,PL] = TGRLINE(fname,year,countyname) uses the string
%  countyname to tag the county data
% 
%  TIGER/Line example files are available over the internet at
%  (ftp://ftp.census.gov/pub/tiger/line/).
% 
%  

function tigermif
%MATLAB Tour Partial Function Help:  map_con
%
%  TIGERMIF reads the TIGER MIF thinned boundary file
% 
%    TIGERMIF(namesstruc) reads a TIGER thinned boundary file in the
%    Mapinfo Interchange Format (MIF) format.  The user selects the
%    file interactively, but must provide the structure containing
%    the names (as returned by FIPSNAME).  The patch data is returned
%    in a Mapping Toolbox geographic data structure.
% 
%    TIGERMIF(namesstruc,filename) reads the MIF file named in
%    string filename. The filename is provided with the '.MIF'
%    extension.
% 
%    TIGERMIF(namesstruc,filename,pstruc) appends the patch data to the
%    existing structure.
% 
%    TIGERMIF(namesstruc,filename,pstruc,tstruc) appends the data the file
%    to the existing patch and text geographic data structures.  The text
%    structure contains labels for the patches.  This form would be used
%    with two output arguments.  The argument for the existing structure
%    can be set to an empty matrix if none is available.
% 
%    TIGERMIF(namesstruc,filename,pstruc,tstruc,getcodes) returns only the data
%    matching the scalar or vector of FIPS codes.  The argument for the
%    existing structure can be set to an empty matrix if none is available.
% 
%    pstruc = TIGERMIF(...) saves the returned patch data in pstruc
% 
%    [pstruc,tstruc] = TIGERMIF(...)  saves the returned patch data in
%    pstruc and text labels in tstruc. Both are geographic data structures.
%  
%    The data files are available over the internet from 
%    (ftp://ftp.census.gov/pub/tiger/boundary).  Extremely limited 
%    documentation on the files is available on the World-Wide Web from 
%    (http://www.census.gov/ftp/pub/geo/www/tiger/mif.txt) and 
%    (http://www.census.gov/ftp/pub/geo/www/tiger/resource.html)
% 
%    

function tigerp
%MATLAB Tour Partial Function Help:  map_con
%
%  TIGERP reads the TIGER p and pa thinned boundary file (ArcInfo format)
% 
%    TIGERP(namesstruc) reads a TIGER thinned boundary file in the
%    ArcInfo format.  The user selects the file interactively, but must
%    provide the structure containing the names (as returned by
%    FIPSNAME).  The patch data is returned in a Mapping Toolbox
%    geographic data structure.
% 
%    TIGERP(namesstruc,filename) reads the ArcInfo file named in
%    string filename. The filename is provided without the '_p' or
%    '_pa' extension.
% 
%    TIGERP(namesstruc,filename,pstruc) appends the patch data to the
%    existing structure.
% 
%    TIGERP(namesstruc,filename,pstruc,tstruc) appends the data the file
%    to the existing patch and text geographic data structures.  The text
%    structure contains labels for the patches.  This form would be used
%    with two output arguments.  The argument for the existing structure
%    can be set to an empty matrix if none is available.
% 
%    TIGERP(namesstruc,filename,pstruc,tstruc,getcodes) returns only the data
%    matching the scalar or vector of FIPS codes.  The argument for the
%    existing structure can be set to an empty matrix if none is available.
% 
%    pstruc = TIGERP(...) saves the returned patch data in pstruc
% 
%    [pstruc,tstruc] = TIGERP(...)  saves the returned patch data in
%    pstruc and text labels in tstruc. Both are geographic data structures.
% 
%    The data files are available over the internet from 
%    (ftp://ftp.census.gov/pub/tiger/boundary).  Documentation on the files is 
%    available from (ftp://ftp.census.gov/pub/tiger/boundary/readme.txt)
%  
%  
%    

function usgs24kdem
%MATLAB Tour Partial Function Help:  map_con
%
%  USGS24KDEM read USGS 1:24,000 (30 m) Digital Elevation Model files
%  
%    [latgrat,longrat,mat] = USGS24KDEM reads a USGS 1:24,000 Digital 
%    Elevation Map (DEM) file in standard format.  The file is selected 
%    interactively.  The entire file is read and subsampled by a factor of 5, 
%    and returned as a general matrix map.  The 1:24,000 series of DEMs are 
%    stored as a grid of elevations spaced 30 meters apart. The number of 
%    points in a file will vary with the geographic location.
%    
%    [latgrat,longrat,mat] = USGS24KDEM(filename) specifies the name of the 
%    DEM file.
%    
%    [latgrat,longrat,mat] = USGS24KDEM(filename,scalefactor) subsamples the 
%    file by the scalefactor.  if omitted, the default is 5, which returns 
%    every 5th point.
%    
%    [latgrat,longrat,mat] = USGS24KDEM(filename,scalefactor,latlim,lonlim) 
%    returns data focusing on the requested geographic area. The area is 
%    specified as two element vectors in units of degrees. The data 
%    will extend somewhat outside the requested area. If omitted, the 
%    entire area covered by the DEM file is returned.
%    
%    [latgrat,longrat,mat] = USGS24KDEM(filename,scalefactor,latlim,lonlim,gsize) 
%    also controls the graticule size. gsize is a two element vector 
%    specifying the number of rows and columns in the latitude and longitude 
%    matrices. If omitted, a graticule the same size as the map is returned.
%    Use empty matrices for latlim and lonlim to specify the graticule size
%    without specifying the geographic limits.
%  
%    [latgrat,longrat,mat,A,B] = USGS24KDEM(...) also returns the contents of 
%    the A and B records of the DEM file. The A record is a header to the file 
%    containing descriptions of the data. The B record is the raw profile data 
%    from which the matrix map is constructed.
%    
%    The data files can be obtained by contacting the U.S. Geological Survey.  
%    Other agencies have made some of the data available online.  A source for 
%    data for the San Francisco Bay area is <http://bard.wr.usgs.gov/> and 
%    <ftp://bard.wr.usgs.gov/bard/dem/dems24k/>
%    
%    Extensive documentation on the data format and standards are available from
%    <http://mapping.usgs.gov/www/ti/DEM/standards_dem.html> and 
%    <ftp://mapping.usgs.gov/pub/ti/DEM/demguide/>
%    
%    

function usgsdem
%MATLAB Tour Partial Function Help:  map_con
%
% USGSDEM  USGS 1-Degree (3-arc-sec resolution) digital elevation data extraction
% 
%  [map,maplegend] = USGSDEM(filename,samplefactor) reads the specified
%  file and returns the data in a regular matrix map.  The data can be
%  read at full resolution (samplefactor = 1), or can be downsampled by
%  the samplefactor.  A samplefactor of 3 returns every third point,
%  giving 1/3 of the full resolution.  The grid for the digital elevation
%  maps is based on the World Geodetic System 1984 (WGS84).  Older DEMs
%  were based on WGS72.  Elevations are in meters relative to National
%  Geodetic Vertical Datum of 1929 (NGVD 29) in the continental U.S. and
%  local mean sea level in Hawaii.
% 
%  [map,maplegend] = USGSDEM(filename,samplefactor,latlim,lonlim) reads
%  data within the latitude and longitude limits. These limits are two
%  element vectors with the minimum and maximum values specified in
%  units of degrees.
% 
%  [map,maplegend,A] = USGSDEM(...) also returns the contents of the 
%  A header in a structure. This header describes the contents of the 
%  file.
% 
%  The digital elevation map data files are available from the U.S.
%  Geological Survey over the internet from
%  <ftp://edcftp.cr.usgs.gov/pub/data/DEM/250/>.
% 
%  

function usgsdems
%MATLAB Tour Partial Function Help:  map_con
%
% USGSDEMS  USGS 1-Degree (3-arc-sec resolution) DEM file names
% 
%  [fname,qname] = USGSDEMS(latlim,lonlim) returns cellarrays of the file
%  names and quadrangle names covering the geographic region for 1-degree
%  USGS digital elevation maps (also referred to as "3-arc second" or
%  "1:250,000 scale" DEMs).  The region is specified by scalar latitude and
%  longitude points, or two element vectors of latitude and longitude
%  limits in units of degrees.
% 
% 
%  The digital elevation map data files are available from the U.S.
%  Geological Survey over the internet from
%  <ftp://edcftp.cr.usgs.gov/pub/data/DEM/250/>.
% 
%  

function vmap0data
%MATLAB Tour Partial Function Help:  map_con
%
% VMAP0DATA extracts selected data from the Vector Map Level 0 CD-ROMs
% 
%  struc = VMAP0DATA(library,latlim,lonlim,theme,topolevel) reads
%  the data for the specified theme and topology level directly from the
%  named VMAP0 CD-ROM. There are four CD's, one each for the library: 'NOAMER'
%  (North America), 'SASAUS' (Southern Asia and Australia), 'EURNASIA'
%  (Europe and Northern Asia) and 'SOAMAFR' (South America and Africa).
%  The desired theme is specified by a two letter code string.  A list of
%  valid codes will be displayed when an invalid code, such as '?', is
%  entered.  The region of interest can be given as a point latitude and
%  longitude or as a region with two-element vectors of latitude and
%  longitude limits.  The units of latitude and longitude are degrees.
%  The data covering the requested region is returned, but will include
%  data extending to the edges of the tiles.  The result is returned as a
%  Mapping Toolbox Geographic Data Structure.
% 
%  [struc1, struc2, ...]  = ...
%  VMAP0DATA(library,latlim,lonlim,theme,{topolevel1,topolevel2,...})
%  reads several topology levels.  The levels must be specified as a cell
%  array with the entries 'patch', 'line', 'point' or 'text'.  Entering
%  {'all'} for the topology level argument is equivalent to {'patch',
%  'line', 'point','text'}. Upon output, the data are returned in the
%  output arguments by topology level in the same order as they were
%  requested.
% 
%  VMAP0DATA(devicename,library,latlim,...) specifies the logical device
%  name of the CD-ROM for computers which do not automatically name the
%  mounted disk.
% 
%  VMAP0 CD-ROMs are available from 
%  
%  	USGS Information Services (Map and Book Sales)
%  	Box 25286
%  	Denver Federal Center
%  	Denver, CO 80225
%  	Telephone: (303) 202-4700
%  	Fax: (303) 202-4693
% 
%  The price as of early 1998 is $82.50 per four disk set.
% 
%  Information on the VMAP0 data can be found at 
%  <http://164.214.2.54/mel/metadata/vmap0.meta.html>

function vmap0read
%MATLAB Tour Partial Function Help:  map_con
%
% VMAP0READ reads a Digital Chart of the World file
% 
%  VMAP0READ reads a VMAP0 file.  The user may select the file interactively.
% 
%  VMAP0READ(filepath,filename) reads the specified file.  The combination
%  [filepath filename] must form a valid complete filename.
% 
%  VMAP0READ(filepath,filename,recordIDs) reads selected records or
%  fields from the file.  If recordIDs is a scalar or a vector of
%  integers, the function returns the selected records.  If recordIDs is
%  a cellarray of integers, all records of the associated fields are
%  returned.
% 
%  VMAP0READ(filepath,filename,recordIDs,field,varlen) uses previously read
%  field and variable length record information to skip parsing the file
%  header.
% 
%  struc = VMAP0READ...  returns the file contents in a structure.
% 
%  [struc,field] = VMAP0READ...  returns the contents and a structure
%  describing the format of the file.
% 
%  [struc,field,varlen] = VMAP0READ ...  also returns a vector describing
%  which fields have variable length records.
% 
%  [struc,field,varlen,description] = VMAP0READ ...  adds the string
%  describing the contents of the file to the output arguments.
% 
%  [struc,field,varlen,description,narrativefile] = VMAP0READ ...  also
%  returns the name of the narrative file for the current file.
% 
%  

function vmap0rhead
%MATLAB Tour Partial Function Help:  map_con
%
% VMAP0RHEAD reads the Digital Chart of the World file headers
% 
%  VMAP0RHEAD allows the user to select the file interactively.
% 
%  VMAP0RHEAD(filepath,filename) reads from the specified file.  The
%  combination [filepath filename] must form a valid complete filename.
% 
%  VMAP0RHEAD(filepath,filename,fid) reads from the already open file
%  associated with fid.
% 
%  VMAP0RHEAD(...),  with no output arguments, displays the formatted header
%  information on the screen.
% 
%  str = VMAP0RHEAD...  returns a string containing the VMAP0 header

function almanac
%MATLAB Tour Partial Function Help:  map_con
%
% ALMANAC  Almanac data for the Solar System
% 
%   ALMANAC, without any input arguments, displays a list of the
%   heavenly objects recognized by ALMANAC.
% 
%   ALMANAC('object') displays recognized parameters, units, and
%   reference body strings for the planet.
% 
%   ALMANAC('object','parameter') returns the specified parameter from the
%   almanac.  Available parameters are the spherical radius of the planet,
%   surface area and volume of the sphere, the definition of the ellipsoid
%   (semimajor axis and eccentricity), the volume and surface area of the
%   ellipsoid, and tabulated surface area and volume.
% 
%   ALMANAC('object','parameter','units') returns the corresponding parameter
%   in the units defined by 'units'.  If omitted, kilometers are used.
% 
%   ALMANAC('object','parameter','units','referencebody') returns the
%   corresponding parameter given the spherical and or elliptical reference
%   body specified by 'referencebody'.  If omitted, a sphere is assumed where
%   appropriate.
% 

function orbits
%MATLAB Tour Partial Function Help:  map_con
%
% ORBITS  GUI demostrating orbit calculations and map interaction
% 
%   Synopsis:  orbits
% 
%   ORBITS produces an interactive window allowing the analysis
%   of various satellite orbits and their resulting rotating
%   earth ground traces.  This example illustrates the utility
%   of a map in a numerical application.  The satellite queries
%   the map at each point and displays its current location.
%   This interaction happens within the simulation and represents
%   how a map can be used as data within an application.  This
%   script is executed by entering ORBITS.

function qrydemo
%MATLAB Tour Partial Function Help:  map_con
%
% QRYDEMO  Demo:  Demonstration of linked map queries
% 
%   Synposis:     qrydemo

function viewmaps
%MATLAB Tour Partial Function Help:  map_con
%
% VIEWMAPS  GUI demonstrating map projections
% 
%   Synopsis:  viewmaps
% 
%   VIEWMAPS is used to display various map projections.  You can alter the
%   projection origin and orientation, and then view the resulting map.
%   This demo allows a rapid comparison of many different map projections.

function vote92
%MATLAB Tour Partial Function Help:  map_con
%
% VOTE92  GUI based analysis of 1992 Presidential election results
% 
%   Synopsis:  vote92
% 
%   VOTE92 produces an interactive window allowing the analysis
%   of the 1992 presidential election results.  The user is
%   allowed to re-allocate Perot's vote to Clinton and Bush
%   and display the resulting electoral vote outcome.  For any
%   postulated outcome, the states switching for the actual
%   outcome to the hypothesized outcome can be highlighted.  In
%   addition, the user can query the map for detailed election
%   results on a state-by-state basis.  The script is
%   executed by entering VOTE92.

function vote96
%MATLAB Tour Partial Function Help:  map_con
%
% VOTE96  GUI based analysis of 1996 Presidential election results
% 
%   Synopsis:  vote96
% 
%   VOTE96 produces an interactive window allowing the analysis
%   of the 1996 presidential election results.  The user is
%   allowed to re-allocate Perot's vote to Clinton and Dole
%   and display the resulting electoral vote outcome.  For any
%   postulated outcome, the states switching for the actual
%   outcome to the hypothesized outcome can be highlighted.  In
%   addition, the user can query the map for detailed election
%   results on a state-by-state basis.  The script is
%   executed by entering VOTE96.

function wrlddemo
%MATLAB Tour Partial Function Help:  map_con
%
% WRLDDEMO  Demo:  Display of a world map and an associated query
% 
%   Synposis:     wrlddemo

function balthsrt
%MATLAB Tour Partial Function Help:  map_con
%
% BALTHSRT  Balthasart Cylindrical Projection
% 
%   This is an orthographic projection onto a cylinder secant at the
%   50 degree parallels.  It is equal area, but distortion of shape
%   increases with distance from the standard parallels.  Scale is true
%   along the standard parallels and constant between two parallels
%   equidistant from the Equator.  This projection is not equidistant.
% 
%   The Balthasart Cylindrical projection was presented in 1935 and is
%   a special form of the Equal Area Cylindrical projection secant
%   at 50 degrees N and S.

function behrmann
%MATLAB Tour Partial Function Help:  map_con
%
% BEHRMANN  Behrmann Cylindrical Projection
% 
%   This is an orthographic projection onto a cylinder secant at the
%   30 degree parallels.  It is equal area, but distortion of shape
%   increases with distance from the standard parallels.  Scale is true
%   along the standard parallels and constant between two parallels
%   equidistant from the Equator.  This projection is not equidistant.
% 
%   The projection is named for Walter Behrmann, who presented it in
%   1910 and is a special form of the Equal Area Cylindrical projection
%   secant at 30 degrees N and S.

function bsam
%MATLAB Tour Partial Function Help:  map_con
%
% BSAM  Bolshoi Sovietskii Atlas Mira Cylindrical Projection
% 
%   This is a perspective projection from a point on the Equator
%   opposite a given meridian onto a cylinder secant at the 30 degree
%   parallels.  It is not equal area, equidistant, or conformal.
%   Scale is true along the standard parallels and constant between
%   two parallels equidistant from the Equator.  There is no distortion
%   along the standard parallels, but it increases moderately away from
%   these parallels, becoming severe at the poles.
% 
%   This projection was first described in 1937, when it was used for
%   maps in the Bolshoi Sovietskii Atlas Mira (Great Soviet World Atlas).
%   It is commonly abbreviated as the BSAM projection.  It is a special
%   form of the Braun Perspective Cylindrical projection, secant at
%   30 degrees N and S.
% 
%   This projection is available for the spherical geoid only.

function braun
%MATLAB Tour Partial Function Help:  map_con
%
% BRAUN  Braun Perspective Cylindrical Projection
% 
%   This is a perspective projection from a point on the Equator
%   opposite a given meridian onto a cylinder secant at standard
%   parallels.  It is not equal area, equidistant, or conformal.
%   Scale is true along the standard parallels and constant between
%   two parallels equidistant from the Equator.  There is no distortion
%   along the standard parallels, but it increases moderately away from
%   these parallels, becoming severe at the poles.
% 
%   This projection was first described by Braun in 1867.  It is less
%   well known than the specific forms of it called the Gall
%   Stereographic and the Bolshoi Sovietskii Atlas Mira projections.
% 
%   This projection is available for the spherical geoid only.

function cassini
%MATLAB Tour Partial Function Help:  map_con
%
% CASSINI  Cassini Cylindrical Projection
% 
%   This is a projection onto a cylinder tangent at the central
%   meridian.  Distortion of both shape and area are functions of distance
%   from the central meridian.  Scale is true along the central meridian
%   and along any straight line perpendicular to the central meridian
%   (i.e., it is equidistant).
% 
%   This projection is the transverse aspect of the Plate Carree projection,
%   developed by Cesar Francois Cassini de Thury (1714-84).  It is still
%   used for the topographic mapping of a few countries.

function ccylin
%MATLAB Tour Partial Function Help:  map_con
%
% CCYLIN  Central Cylindrical Projection
% 
%   This is a perspective projection from the center of the Earth onto
%   a cylinder tangent at the equator.  It is not equal area, equidistant,
%   nor conformal.  Scale is true along the Equator and constant between
%   two parallels equidistant from the Equator.  Scale becomes infinite
%   at the poles.  There is no distortion along the Equator, but it
%   increases rapidly away from the Equator.
% 
%   The origin of the projection is unknown;  it has little use beyond
%   the educational aspects of its method of projection and as a comparison
%   to the Mercator projection which is not perspective.  The transverse
%   aspect of the Central Cylindrical is called the Wetch projection.
% 
%   This projection is available for the spherical geoid only.

function eqacylin
%MATLAB Tour Partial Function Help:  map_con
%
% EQACYLIN  Equal Area Cylindrical Projection
% 
%   This is an orthographic projection onto a cylinder secant at the
%   standard parallels.  It is equal area, but distortion of shape
%   increases with distance from the standard parallels.  Scale is true
%   along the standard parallels and constant between two parallels
%   equidistant from the Equator.  This projection is not equidistant.
% 
%   This projection was proposed by Johann Heinrich Lambert (1772), a
%   prolific cartographer who proposed seven different important
%   projections.  The form of the projection tangent at the Equator
%   is often called the Lambert Equal Area Cylindrical projection.  That
%   and other special forms of this projection are included separately
%   in the toolbox, including the Gall Orthographic, the Behrmann
%   Cylindrical, the Balthasart Cylindrical, and the Trystan
%   Edwards Cylindrical projections.

function eqdcylin
%MATLAB Tour Partial Function Help:  map_con
%
% EQDCYLIN  Equidistant Cylindrical Projection
% 
%   This is a projection onto a cylinder secant at the standard parallels.
%   Distortion of both shape and area increase with distance from the
%   standard parallels.  Scale is true along all meridians (i.e. it is
%   equidistant) and the standard parallels, and is constant along
%   any parallel and along the parallel of opposite sign.
% 
%   This projection was first used by Marinus of Tyre, about A.D. 100.
%   Special forms of this projection are the Plate Carree, with a standard
%   parallel at 0 deg, and the Gall Isographic, with standard parallels
%   at 45 deg N and S.  Other names for this projection include
%   Equirectangular, Rectangular, Projection of Marinus, La Carte
%   Parallelogrammatique, and Die Rechteckige Plattkarte.

function giso
%MATLAB Tour Partial Function Help:  map_con
%
% GISO  Gall Isographic Cylindrical Projection
% 
%   This is a projection onto a cylinder secant at 45 degree parallels.
%   Distortion of both shape and area increase with distance from the
%   standard parallels.  Scale is true along all meridians (i.e. it is
%   equidistant) and the standard parallels, and is constant along
%   any parallel and along the parallel of opposite sign.
% 
%   This projection is a specific case of the Equidistant Cylindrical
%   projection, with standard parallels at 45 deg N and S.

function gortho
%MATLAB Tour Partial Function Help:  map_con
%
% GORTHO  Gall Orthographic Cylindrical Projection
% 
%   This is an orthographic projection onto a cylinder secant at the
%   45 degree parallels.  It is equal area, but distortion of shape
%   increases with distance from the standard parallels.  Scale is true
%   along the standard parallels and constant between two parallels
%   equidistant from the Equator.  This projection is not equidistant.
% 
%   This projection was named for James Gall, who originated it in 1855
%   and is a special form of the Equal Area Cylindrical projection
%   secant at 45 deg N and S. It is also known as the Peters projection.

function gstereo
%MATLAB Tour Partial Function Help:  map_con
%
% GSTEREO  Gall Stereographic Cylindrical Projection
% 
%   This is a perspective projection from a point on the Equator
%   opposite a given meridian onto a cylinder secant at the 45 degree
%   parallels.  It is not equal area, equidistant, or conformal.
%   Scale is true along the standard parallels and constant between
%   two parallels equidistant from the Equator.  There is no distortion
%   along the standard parallels, but it increases moderately away from
%   these parallels, becoming severe at the poles.
% 
%   This projection was presented by James Gall in 1855.  It is also
%   known simply as the Gall projection.  It is special form of the
%   Braun Perspective Cylindrical projection secant at 45 deg N and S.
% 
%   This projection is available for the spherical geoid only.

function lambcyln
%MATLAB Tour Partial Function Help:  map_con
%
% LAMBCYLIN  Lambert Equal Area Cylindrical Projection
% 
%   This is an orthographic projection onto a cylinder tangent at the
%   Equator.  It is equal area, but distortion of shape increases with
%   distance from the Equator.  Scale is true along the Equator and
%   constant between two parallels equidistant from the Equator.  This
%   projection is not equidistant.
% 
%   This projection is named for Johann Heinrich Lambert, and is a
%   special form of the Equal Area Cylindrical projection tangent
%   at the Equator.

function mercator
%MATLAB Tour Partial Function Help:  map_con
%
% MERCATOR  Mercator Cylindrical Projection
% 
%   This is a projection with parallel spacing calculated to maintain
%   conformality.  It is not equal area, equidistant, or perspective.
%   Scale is true along the standard parallels and constant between
%   two parallels equidistant from the Equator.  It is also constant
%   in all directions near any given point.  Scale becomes infinite
%   at the poles.  The appearance of the Mercator projection is
%   unaffected by the selection of the standard parallels;  they
%   serve only to define the latitude of true scale.
% 
%   The Mercator, which may be the most famous of all projections, has
%   the special feature that all rhumb lines, or loxodromes (lines that
%   make equal angles with all meridians, i.e. lines of constant heading)
%   are straight lines.  This makes it an excellent projection for
%   navigational purposes.
% 
%   The transverse and oblique aspects of the projection are often
%   used for topographic mapping and atlas maps.  Its normal aspect
%   is often used for maps of the entire world, for which it is
%   really quite inappropriate.
% 
%   The Mercator projection is named for Geradus Mercator, who presented
%   it "for navigation" in 1569.  It is now known to have been used for
%   the Tunhuang star chart as early as 940 by Ch'ien Lo-Chih.  It was
%   first used in Europe by Erhard Etzlaub in 1511.  It is also, but
%   rarely, called the Wright projection, after Edward Wright, who
%   developed the mathematics behind the projection in 1599.

function miller
%MATLAB Tour Partial Function Help:  map_con
%
% MILLER  Miller Cylindrical Projection
% 
%   This is a projection with parallel spacing calculated to maintain
%   a look similar to the Mercator projection while reducing the distortion
%   near the poles, thus allowing the poles to be displayed.  It is not
%   equal area, equidistant, conformal or perspective.  Scale is true
%   along the Equator and constant between two parallels equidistant
%   from the Equator.  There is no distortion near the Equator, and it
%   increases moderately away from the Equator, but becomes severe at
%   the poles.
% 
%   The Miller Cylindrical projection is derived from the Mercator
%   projection;  parallels are spaced from the Equator by calculating
%   the distance on the Mercator for a parallel at 80% of the true
%   latitude and dividing the result by 0.8.  The result is that the
%   two projections are almost identical near the Equator.
% 
%   This projection was presented by Osborn Maitland Miller of the
%   American Geographical Society in 1942.  It is often used in place
%   of the Mercator projection for atlas maps of the world, for which
%   it is somewhat more appropriate.
% 
%   This projection is available for the spherical geoid only.

function pcarree
%MATLAB Tour Partial Function Help:  map_con
%
% PCARREE  Plate Carree Cylindrical Projection
% 
%   This is a projection onto a cylinder tangent at the Equator.
%   Distortion of both shape and area increase with distance from
%   the Equator.  Scale is true along all meridians (i.e., it is
%   equidistant) and the Equator, and is constant along any parallel
%   and along the parallel of opposite sign.
% 
%   This projection, like the more general equidistant cylindrical, is
%   credited to Marinus of Tyre, thought to have invented it about
%   A.D. 100.  It may, in fact, have been originated by Erastosthenes,
%   who lived approximately 275-195 B.C.  The Plate Carree has the
%   most simply constructed graticule of any projection.  It was
%   used frequently in the 15th and 16th centuries, and is quite common
%   today in very simple computer mapping programs.  It is the simplest
%   and limiting form of the equidistant cylindrical projection.  Another
%   name for this projection is the Simple Cylindrical.  Its tranverse
%   aspect is the Cassini projection.

function trystan
%MATLAB Tour Partial Function Help:  map_con
%
% TRYSTAN  Trystan Edwards Cylindrical Projection
% 
%   This is an orthographic projection onto a cylinder secant at
%   the 37 deg, 24 min parallels.  It is equal area, but distortion
%   of shape increases with distance from the standard parallels.
%   Scale is true along the standard parallels and constant between
%   two parallels equidistant from the Equator.  This projection is
%   not equidistant.
% 
%   This projection is named for Trystan Edwards, who presented it
%   in 1953 and is a special form of the Equal Area Cylindrical
%   projection secant at 37 deg, 24 min N and S.

function utm
%MATLAB Tour Partial Function Help:  map_con
%
% UTM  Universal Transverse Mercator Cylindrical Projection
% 
%   This is a conformal projection with parameters chosen to minimize 
%   distortion over a defined set of small areas.  It is not equal area, 
%   equidistant, or perspective.  Scale is true along two straight lines on 
%   the map approximately 180 kilometers east and west of the central 
%   meridian, and is constant along other straight lines equidistent from the 
%   central meridian.  Scale is less than true between, and greater than true 
%   outside the lines of true scale.
%   
%   The UTM system divides the world between 80 degrees S and 84 degrees N 
%   into a set of quadrangles called zones.  Zones generally cover 6 degrees 
%   of longitude and 8 degrees of latitude.  Each zone has a set of defined 
%   projection parameters, including central meridian, false eastings and 
%   northings and the reference ellipsoid.  The projection equations are the 
%   Gauss-Krueger versions of the transverse Mercator.  The projected 
%   coordinates form a grid system, in which a location is specified by the 
%   zone, easting and northing.
%   
%   The UTM system was introduced in the 1940's by the U.S. Army.  It is 
%   widely used in topographic and military mapping.

function wetch
%MATLAB Tour Partial Function Help:  map_con
%
% WETCH  Wetch Cylindrical Projection
% 
%   This is a perspective projection from the center of the Earth onto
%   a cylinder tangent at the central meridian.  It is not equal area,
%   equidistant, or conformal.  Scale is true along the central meridian
%   and constant between two points equidistant in x and y from the
%   central meridian.  There is no distortion along the central meridian,
%   but it increases rapidly away from it in the y-direction.
% 
%   This is the transverse aspect of the Central Cylindrical projection
%   discussed by J. Wetch in the early 19th century.
% 
%   This projection is available for the spherical geoid only.

function apianus
%MATLAB Tour Partial Function Help:  map_con
%
% APIANUS  Apianus II Pseudocylindrical Projection
% 
%   Scale is constant along any parallel or pair of parallels equidistant from
%   the Equator, as well as along the Central Meridian.  The Equator is free of
%   angular distortion.  This projection is not equal-area, equidistant or
%   conformal.
% 
%   This projection was first described in 1524 by Peter Apian (or Bienewitz).
% 
%   This projection is available for the spherical geoid only.

function collig
%MATLAB Tour Partial Function Help:  map_con
%
% COLLIG  Collignon Pseudocylindrical Projection
% 
%   This is a novelty projection showing a straight-line, equal area
%   graticule.  Scale is true along the 15 deg, 15 min N parallel, 
%   is constant along any parallel, and is different for any pair
%   of parallels.  Distortion is severe in many regions, and is only
%   absent at 15 deg, 15 min N on the central meridian.  This projection
%   is not conformal or equidistant.
% 
%   This projection was presented by Edouard Collignon in 1865.

function craster
%MATLAB Tour Partial Function Help:  map_con
%
% CRASTER  Craster Parabolic Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the 36 deg,
%   46 min parallels, and is constant along any parallel, and between
%   any pair of parallels equidistant from the equator.  Distortion
%   is severe near the outer meridians at high latitudes, but less
%   so than the Sinusoidal projection.  It is free of distortion only at
%   the two points where the central meridian intersects the 36 deg,
%   46 min parallels.  This projection is not conformal or equidistant.
% 
%   This projection was developed by John Evelyn Edmund Craster in 1929;
%   it was further developed by Charles H. Deetz and O. S. Adams in 1934.
%   It was presented independently in 1934 by Putnins as his P4 projection.

function eckert1
%MATLAB Tour Partial Function Help:  map_con
%
% ECKERT1  Eckert I Pseudocylindrical Projection
% 
%   In this projection, scale is true along the 47 deg, 10 min parallels,
%   and is constant along any parallel, between any pair of parallels
%   equidistant from the Equator and along any given meridian.  It
%   is not free of distortion at any point, and the break at the Equator
%   introduces excessive distortion there; regardless of their appearance,
%   Tissot indicatrices are of indeterminate shape along the Equator.
%   This novelty projection is not equal area or conformal.
% 
%   This projection was presented by Max Eckert in 1906.
% 
%   This projection is available for the spherical geoid only.

function eckert2
%MATLAB Tour Partial Function Help:  map_con
%
% ECKERT2  Eckert II Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the 55 deg,
%   10 min parallels, and is constant along any parallel and between
%   any pair of parallels equidistant from the Equator.  It is not free
%   of distortion at any point except at 55 deg, 10 min N and S along
%   the central meridian.  The break at the Equator introduces excessive
%   distortion there;  regardless of their appearance, Tissot indicatrices
%   are of indeterminate shape along the Equator.  This novelty projection
%   is not conformal or equidistant.
% 
%   This projection was presented by Max Eckert in 1906.

function eckert3
%MATLAB Tour Partial Function Help:  map_con
%
% ECKERT3  Eckert III Pseudocylindrical Projection
% 
%   In this projection, scale is true along the 35 deg, 58 min parallels,
%   and is constant along any parallel.  No point is free of all scale
%   distortion, but the Equator is free of angular distortion.  This
%   projection is not equal area, conformal or equidistant.
% 
%   This projection was presented by Max Eckert in 1906.
% 
%   This projection is available for the spherical geoid only.

function eckert4
%MATLAB Tour Partial Function Help:  map_con
%
% ECKERT4  Eckert IV Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the 40 deg,
%   30 min parallels, and is constant along any parallel and between
%   any pair of parallels equidistant from the Equator.  It is not free
%   of distortion at any point except at 40 deg, 30 min N and S along
%   the central meridian.  This projection is not conformal or equidistant.
% 
%   This projection was presented by Max Eckert in 1906.

function eckert5
%MATLAB Tour Partial Function Help:  map_con
%
% ECKERT5  Eckert V Pseudocylindrical Projection
% 
%   This projection is an arithmetical average of the x and y coordinates
%   of the Sinusoidal and Plate Carree projections.  Scale is true along
%   latitudes 37 deg, 55 min N and S, and is constant along any parallel
%   and between any pair of parallels equidistant from the Equator.  There
%   is no point free of all distortion, but the Equator is free of
%   angular distortion.  This projection is not equal area, conformal
%   or equidistant.
% 
%   This projection was presented by Max Eckert in 1906.
% 
%   This projection is available for the spherical geoid only.

function eckert6
%MATLAB Tour Partial Function Help:  map_con
%
% ECKERT6  Eckert VI Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the 49 deg,
%   16 min parallels, and is constant along any parallel and between
%   any pair of parallels equidistant from the Equator.  It is not free
%   of distortion at any point except at 49 deg, 16 min N and S along
%   the central meridian.  This projection is not conformal or equidistant.
% 
%   This projection was presented by Max Eckert in 1906.

function flatplrp
%MATLAB Tour Partial Function Help:  map_con
%
% FLATPLRP  McBryde-Thomas Flat-Polar Parabolic Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the 45 deg,
%   30 min parallels, and is constant along any parallel and between any
%   pair of parallels equidistant from the Equator.  Distortion is severe
%   near the outer meridians at high latitudes, but less so than on the
%   pointed-polar projections.  It is free of distortion only at the two
%   points where the central meridian intersects the 45 deg, 30 min
%   parallels.  This projection is not conformal or equidistant.
% 
%   This projection was presented by F. Webster McBryde and Paul D. Thomas
%   in 1949.

function flatplrq
%MATLAB Tour Partial Function Help:  map_con
%
% FLATPLRQ  McBryde-Thomas Flat-Polar Quartic Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the 33 deg,
%   45 min parallels, and is constant along any parallel and between any
%   pair of parallels equidistant from the Equator.  Distortion is severe
%   near the outer meridians at high latitudes, but less so than on the
%   pointed-polar projections.  It is free of distortion only at the two
%   points where the central meridian intersects the 33 deg, 45 min
%   parallels.  This projection is not conformal or equidistant.
% 
%   This projection was presented by F. Webster McBryde and Paul D. Thomas
%   in 1949 and is also known simply as the Flat-Polar Quartic projection.

function flatplrs
%MATLAB Tour Partial Function Help:  map_con
%
% FLATPLRS  McBryde-Thomas Flat-Polar Sinusoidal Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the 55 deg,
%   51 min parallels, and is constant along any parallel and between any
%   pair of parallels equidistant from the Equator.  Distortion is severe
%   near the outer meridians at high latitudes, but less so than on the
%   pointed-polar projections.  It is free of distortion only at the two
%   points where the central meridian intersects the 55 deg, 51 min
%   parallels.  This projection is not conformal or equidistant.
% 
%   This projection was presented by F. Webster McBryde and Paul D. Thomas
%   in 1949.

function fournier
%MATLAB Tour Partial Function Help:  map_con
%
% FOURNIER  Fournier Pseudocylindrical Projection
% 
%   This projection is equal-area.  Scale is constant along any parallel or
%   pair of parallels equidistant from the Equator.  This projection is neither
%   equidistant nor conformal.
% 
%   This projection was first described in 1643 by Georges Fournier.  This is
%   actually his second projection, the Fournier II.

function goode
%MATLAB Tour Partial Function Help:  map_con
%
% GOODE  Goode Homolosine Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along all parallels
%   and the central meridian between 40 deg 44 min N and S, and is
%   constant along any parallel and between any pair of parallels
%   equidistant from the Equator for all latitudes.  Its distortion
%   is identical to that of the Sinusoidal projection between 40 deg
%   44 min N and S, and to that of the Mollweide projection elsewhere.
%   This projection is not conformal or equidistant.
% 
%   This projection was developed by J. Paul Goode in 1916.  It is
%   sometimes called simply the Homolosine projection, and it is
%   usually in an interrupted form.  It is a merging of the
%   Sinusoidal and Mollweide projections.
% 
%   This projection is available in an uninterrupted form only.

function hatano
%MATLAB Tour Partial Function Help:  map_con
%
% HATANO  Hatano Asymmetrical Equal Area Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along 40 deg,
%   42 min N and 38 deg, 27 min S, and is constant along any parallel
%   but generally not between pairs of parallels equidistant
%   from the Equator.  It is free of distortion along the central
%   meridian at 40 deg, 42 min N and 38 deg, 27 min S.  This
%   projection is not conformal or equidistant.
% 
%   This projection was presented by Masataka Hatano in 1972.

function kavrsky5
%MATLAB Tour Partial Function Help:  map_con
%
% KAVRSKY5  Kavraisky V Pseudocylindrical Projection
% 
%   This is an equal-area projection.  Scale is true along the fixed standard
%   parallels at 35 degrees and 0.9 true along the Equator.  This projection is
%   neither conformal nor equidistant.
% 
%   This projection was described by V. V. Kavrayskiy in 1933.

function kavrsky6
%MATLAB Tour Partial Function Help:  map_con
%
% KAVRSKY6  Kavraisky VI Pseudocylindrical Projection
% 
%   This is an equal-area projection.  Scale is constant along any parallel or
%   pair of equidistant parallels.  This projection is neither conformal nor
%   equidistant.
% 
%   This projection was described by V. V. Kavrayskiy in 1936.  It is also
%   called the Wagner I, for Karlheinz Wagner, who described it in 1932.

function loximuth
%MATLAB Tour Partial Function Help:  map_con
%
% LOXIMUTH  Loximuthal Pseudocylindrical Projection
% 
%   This projection has the special property that from the central point
%   (the intersection of the central latitude with the central meridian, or
%   map origin), rhumb lines (or loxodromes) are shown as straight, true
%   to scale, and correct in azimuth from the center.  This differs from
%   the Mercator projection, in that rhumb lines are here shown in true
%   scale, and that unlike the Mercator projection, this projection does
%   not maintain true azimuth for all points along rhumb lines.  Scale is
%   true along the central meridian, and is constant along any parallel, but
%   not, generally, between parallels.  It is free of distortion only at
%   the central point, and can be severely distorted in places.  However,
%   this projection is designed for its special property, in which
%   distortion is not a concern.
% 
%   This projection was presented by Karl Siemon in 1935, and independently
%   by Waldo R. Tobler in 1966.  The Bordone Oval projection of 1520 was
%   very similar to the Equator-centered Loximuthal.
% 
%   This projection is available for the spherical geoid only.

function modsine
%MATLAB Tour Partial Function Help:  map_con
%
% MODSINE  Tissot Modified Sinusoidal Pseudocylindrical Projection
% 
%   This is an equal-area projection.  Scale is constant along any parallel or
%   any pair of equidistant parallels, and along the central meridian.  It is
%   not equidistant or conformal.
% 
%   This projection was first described by N. A. Tissot in 1881.
% 
%   This projection is available for the spherical geoid only.

function mollweid
%MATLAB Tour Partial Function Help:  map_con
%
% MOLLWEID  Mollweide Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the 40 deg
%   44 min parallels, and is constant along any parallel and between
%   any pair of parallels equidistant from the Equator.  It is free
%   of distortion only at the two points where the 40 deg, 44 min
%   parallels intersect the central meridian.  This projection is
%   not conformal or equidistant.
% 
%   This projection was presented by Carl B. Mollweide in 1805.  Its
%   other names include the Homolographic, the Homalographic, the
%   Babinet, and the Elliptical projections.  It is occassionally
%   used for thematic world maps, and it is combined with the
%   Sinusoidal to produce the Goode Homolosine projection.

function putnins5
%MATLAB Tour Partial Function Help:  map_con
%
% PUTNINS5  Putnins P5 Pseudocylindrical Projection
% 
%   For this projection, scale is true along the 21 deg, 14 min
%   parallels, and is constant along any parallel, between any
%   pair of parallels equidistant from the Equator, and along the
%   central meridian.  It is not free of distortion at any point.
%   This projection is not equal area, conformal or equidistant.
% 
%   This projection was presented by Reinholds V. Putnins in 1934.
% 
%   This projection is available for the spherical geoid only.

function quartic
%MATLAB Tour Partial Function Help:  map_con
%
% QUARTIC  Quartic Authalic Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the Equator,
%   and is constant along any parallel and between any pair of parallels
%   equidistant from the Equator.  Distortion is severe near the outer
%   meridians at high latitudes, but less so than on the Sinusoidal
%   projection.  It is free of distortion along the Equator.  This
%   projection is not conformal or equidistant.
% 
%   This projection was presented by Karl Siemon in 1937 and independently
%   by Oscar Sherman Adams in 1945.

function robinson
%MATLAB Tour Partial Function Help:  map_con
%
% ROBINSON  Robinson Pseudocylindrical Projection
% 
%   For this projection, scale is true along the 38 deg parallels, and
%   is constant along any parallel, and between any pair of parallels
%   equidistant from the Equator.  It is not free of distortion at any
%   point, but distortion is very low within about 45 degrees of the
%   center and along the Equator.  This projection is not equal area,
%   conformal or equidistant;  however, it is considered to "look right"
%   for world maps, and hence is widely used by Rand McNally, the National
%   Geographic Society and others.  This feature is achieved through the
%   use of tabular coordinates rather than mathematical formulae for the
%   graticules.
% 
%   This projection was presented by Arthur H. Robinson in 1963, and is
%   also called the Orthophanic projection, which means "right appearing."
% 
%   This projection is available for the spherical geoid only.

function sinusoid
%MATLAB Tour Partial Function Help:  map_con
%
% SINUSOID  Sinusoidal Pseudocylindrical Projection
% 
%   This projection is equal area.  Scale is true along every parallel
%   and along the central meridian.  There is no distortion along the
%   Equator or along the central meridian, but it becomes severe near
%   the outer meridians at high latitudes.
% 
%   This projection was developed in the 16th century.  It was used
%   by Jean Cossin in 1570 and by Jodocus Hondius in Mercator atlases
%   of the early 17th century.  It is the oldest pseudocylindrical
%   projection currently in use, and is sometimes called the
%   Sanson-Flamsteed or the Mercator Equal Area projections.

function wagner4
%MATLAB Tour Partial Function Help:  map_con
%
% WAGNER4  Wagner IV Pseudocylindrical Projection
% 
%   This is an equal area projection.  Scale is true along the 42 deg,
%   59 min parallels, and is constant along any parallel and between
%   any pair of parallels equidistant from the Equator.  Distortion is
%   not as extreme near the outer meridians at high latitudes as for
%   pointed-polar pseudocylindrical projections, but there is considerable
%   distortion throughout polar regions.  It is free of distortion only
%   at the two points where the 42 deg, 59 min parallels intersect the
%   central meridian.  This projection is not conformal or equidistant.
% 
%   This projection was presented by Karlheinz Wagner in 1932.

function winkel
%MATLAB Tour Partial Function Help:  map_con
%
% WINKEL  Winkel I Pseudocylindrical Projection
% 
%   This projection is an arithmetical average of the x and y coordinates
%   of the Sinusoidal and Equidistant Cylindrical projections.  Scale is
%   true along the standard parallels, and is constant along any parallel
%   and between any pair of parallels equidistant from the Equator.
%   There is no point free of distortion.  This projection is not equal
%   area, conformal, or equidistant.
% 
%   This projection was developed by Oswald Winkel in 1914.  Its
%   limiting form is the Eckert V when a standard parallel of 0 degrees
%   is chosen.

function eqaconic
%MATLAB Tour Partial Function Help:  map_con
%
% EQACONIC  Albers Equal Area Conic Projection
% 
%   This is an equal area projection.  Scale is true along the one or
%   two selected standard parallels.  Scale is constant along any parallel;
%   the scale factor of a meridian at any given point is the reciprocal of
%   that along the parallel to preserve equal area.  This projection is
%   free of distortion along the standard parallels.  Distortion is
%   constant along any other parallel.  This projection is neither
%   conformal nor equidistant.
% 
%   This projection was presented by Heinrich Christian Albers in 1805 and
%   it is also known as a Conical Orthomorphic projection.  The cone of
%   projection has interesting limiting forms.  If a pole is selected as
%   a single standard parallel, the cone is a plane, and a Lambert Equal
%   Area Conic projection is the result.  If the Equator is chosen as a
%   single parallel, the cone becomes a cylinder and a Lambert Cylindrical
%   Equal Area Projection is the result.  Finally, if two parallels
%   equidistant from the Equator are chosen as the standard parallels, a
%   Behrman or other cylindrical equal area projection is the result.

function eqdconic
%MATLAB Tour Partial Function Help:  map_con
%
% EQDCONIC  Equidistant Conic Projection
% 
%   In this projection, scale is true along each meridian and the one or
%   two selected standard parallels.  Scale is constant along any
%   parallel.  This projection is free of distortion along the two
%   standard parallels.  Distortion is constant along any other parallel.
%   This projection provides a compromise in distortion between conformal
%   and equal area conic projections, of which it is neither.
% 
%   In a rudimentary form, this projection dates back to Claudius Ptolemy,
%   about A.D. 100.  Improvements were developed by Johannes Ruysch in
%   1508, Gerardus Mercator in the late 16th century, and Nicolas de
%   l'Isle in 1745.  It is also known as the Simple Conic or Conic
%   projection.  The cone of projection has interesting limiting forms.
%   If a pole is selected as a single standard parallel, the cone is a
%   plane, and an Equidistant Azimuthal projection results.  If the
%   Equator is so chosen, the cone becomes a cylinder and a Plate
%   Carree projection results.  If two parallels equidistant from
%   the Equator are chosen as the standard parallels, an Equidistant
%   Cylindrical projection results.

function lambert
%MATLAB Tour Partial Function Help:  map_con
%
% LAMBERT  Lambert Conformal Conic Projection
% 
%   For this projection, scale is true along the one or two selected
%   standard parallels.  Scale is constant along any parallel, and
%   is the same in every direction at any point.  This projection is
%   free of distortion along the standard parallels.  Distortion is
%   constant along any other parallel.  This projection is conformal
%   everywhere but the poles;  it is neither equal area  nor equidistant.
% 
%   This projection was presented by Johann Heinrich Lambert in 1772,
%   and it is also known as the Conical Orthomorphic projection.  The
%   cone of projection has interesting limiting forms.  If a pole
%   is selected as a single stantard parallel, the cone is a plane
%   and a Stereographic Azimuthal projection results.  If the Equator
%   or two parallels equidistant from the Equator are chosen as the
%   standard parallels, the cone becomes a cylinder, and a Mercator
%   projection results.

function murdoch1
%MATLAB Tour Partial Function Help:  map_con
%
% MURDOCH1  Murdoch I Conic Projection
% 
%   This is an equidistant projection which is nearly minimum-error.  Scale is
%   true along any meridian and is constant along any parallel.  Scale is also
%   true along two standard parallels, which must calculated from the input
%   limiting parallels.  The total area of the mapped area is correct, but it
%   is not equal area everywhere.
% 
%   This was first described by Patrick Murdoch in 1758.
% 
%   This projection is available for the spherical geoid only.  Longitude data
%   greater than 135 degrees east or west of the central meridian is trimmed.

function murdoch3
%MATLAB Tour Partial Function Help:  map_con
%
% MURDOCH3  Murdoch III Minimum Error Conic Projection
% 
%   This is an equidistant projection which is minimum-error.  Scale is true
%   along any meridian and is constant along any parallel.  Scale is also true
%   along two standard parallels, which must calculated from the input
%   limiting parallels.  The total area of the mapped area is correct, but it
%   is not equal area everywhere.
% 
%   This was first described by Patrick Murdoch in 1758, with errors only
%   corrected by Everett in 1904.
% 
%   This projection is available for the spherical geoid only.  Longitude data
%   greater than 135 degrees east or west of the central meridian is trimmed.

function bonne
%MATLAB Tour Partial Function Help:  map_con
%
% BONNE  Bonne Pseudoconic Projection
% 
%   This is an equal area projection.  The curvature of the standard parallel
%   is identical to that on a cone tangent at that latitude.  The central
%   meridian and the central parallel are free of distortion.  This
%   projection is not conformal.
% 
%   This projection dates in a rudimentary form back to Claudius Ptolemy
%   (about A.D. 100).  It was further developed by Bernardus Sylvanus in
%   1511.  It derives its name from its considerable use by Rigobert
%   Bonne, especially in 1752.  It has two interesting limiting forms.
%   If a pole is employed as the standard parallel, a Werner projection
%   results;  if the Equator is used, a Sinusoidal projection results.

function polycon
%MATLAB Tour Partial Function Help:  map_con
%
% POLYCON  Polyconic Projection
% 
%   For this projection, each parallel has a curvature identical to
%   its curvature on a cone tangent at that latitude.  Since each
%   parallel would have its own cone, this is a "polyconic" projection.
%   Scale is true along the central meridian and along each parallel.
%   This projection is free of distortion only along the central meridian;
%   distortion can be severe at extreme longitudes.  This projection is
%   neither conformal nor equal area.
% 
%   This projection was apparently originated about 1820 by Ferdinand
%   Rudolph Hassler.  It is also known as the American Polyconic and
%   the Ordinary Polyconic projections.

function werner
%MATLAB Tour Partial Function Help:  map_con
%
% WERNER  Werner Pseudoconic Projection
% 
%   This is an equal area projection.  It is a Bonne projection with
%   of the poles as its standard parallel.  The central meridian
%   is free of distortion.  This projection is not conformal.
%   Its heart shape gives it the additional descriptor "cordiform".
% 
%   This projection was developed by Johannes Stabius (Stab) about
%   1500 and was promoted by Johannes Werner in 1514.  It is also
%   called the Stab-Werner projection.

function aitoff
%MATLAB Tour Partial Function Help:  map_con
%
% AITOFF Aitoff Projection
% 
%  This is a modified azimuthal projection.  The world is displayed as an 
%  elipse, with curved parallels and meridians.  It is neither conformal nor 
%  equal area.  The only point free of distortion is the center point.  
%  Distortion of shape and area are moderate throughout.
%  
%  This projection was created by David Aitoff in 1889.  It is a modification 
%  of the azimuthal equidistant projection.  The Aitoff projection inspired 
%  the similar Hammer projection, which is equal area.
%  
%  This projection is available for the spherical geoid only.

function breusing
%MATLAB Tour Partial Function Help:  map_con
%
% BREUSING  Breusing Harmonic Mean Azimuthal Projection
% 
%   This is a harmonic mean between a Stereographic and Lambert Equal-Area
%   Azimuthal projection.  It is not equal-area, equidistant, or conformal.
%   There is no point at which scale is accurate in all directions.  The
%   primary feature of this projection is that it is minimum error - distortion
%   is moderate throughout.
% 
%   F. A. Arthur Breusing developed a geometric mean version of this projection
%   in 1892.  A. E. Young modified this to the harmonic mean version presented
%   here in 1920.  This projection is virtually indistinguishable from the Airy
%   Minimum Error Azimuthal Projection, presented by George Airy in 1861.
% 
%   This projection is available for the spherical geoid only.

function bries
%MATLAB Tour Partial Function Help:  map_con
%
% BRIES  Briesemeister's Projection
% 
%  This equal-area groups the continents about the center of the projection.  
%  The only point free of distortion is the center point.  Distortion of shape 
%  and area are moderate throughout.
%  
%  This projection was presented by William Briesemeister in 1953.  It is 
%  an oblique Hammer projection with an axis ratio of 1.75 to 1, instead of 
%  2 to 1.

function eqaazim
%MATLAB Tour Partial Function Help:  map_con
%
% EQAAZIM  Lambert Equal Area Azimuthal Projection
% 
%   This non-perspective projection is equal area.  Only the center
%   point is free of distortion, but distortion is moderate within
%   90 degrees of this point.  Scale is true only at the center point,
%   increasing tangentially and decreasing radially with distance from
%   the center point.  This projection is neither conformal nor
%   equidistant.
% 
%   This projection was presented by Johann Heinrich Lambert in 1772.
%   It is also know as the Zenithal Equal Area and the Zenithal
%   Equivalent projections, and the Lorgna projection in its polar aspect.

function eqdazim
%MATLAB Tour Partial Function Help:  map_con
%
% EQDAZIM  Equidistant Azimuthal Projection
% 
%   This is an equidistant projection.  It is neither equal-area nor conformal.
%   In the polar aspect, scale is true along any meridian.  The projection is
%   distortion free only at the center point.  Distortion is moderate for the
%   inner hemisphere, but it becomes extreme in the outer hemisphere.
% 
%   This projection may have been first used by the ancient Egyptians for star
%   charts.  Several cartographers used it during the sixteenth century,
%   including Guillaume Postel, who used it in 1581.  Other names for this
%   projections include Postel and Zenithal Equidistant.
% 
%   This projection is available for the spherical geoid only.

function globe
%MATLAB Tour Partial Function Help:  map_con
%
% GLOBE  3D Globe Display
% 
%   In the three-dimensional sense, this "projection" is true in scale,
%   equal-area, conformal, minimum error, and equidistant everywhere.  When
%   displayed, however, this "projection" looks like an orthographic azimuthal
%   projection, provided that the Matlab axes projection property is set to
%   orthographic.
% 
%   This is the only three-dimensional representation provided for display.
%   Unless some other display purpose requires three dimensions, the
%   orthographic projection's display is equivalent.

function gnomonic
%MATLAB Tour Partial Function Help:  map_con
%
% GNOMONIC  Gnomonic Azimuthal Projection
% 
%   This is a perspective projection from the center of the globe on
%   a plane tangent at the center point, which is a pole in the common
%   polar aspect, but can be any point.  Less than one hemisphere
%   can be shown with this projection, regardless of its center
%   point.  The significant property of this projection is that all
%   great circles are straight lines.  This is useful in navigation,
%   as a great circle is the shortest path between two points on
%   the globe.  Only the center point enjoys true scale and zero
%   distortion.  This projection is neither conformal nor equal
%   area.
% 
%   This projection may have been first developed by Thales around
%   580 B.C.  Its name is derived from the gnomon, the face of a
%   sundial, since the meridians radiate like hour markings.  This
%   projection is also known as a Gnomic or Central Projection.
% 
%   This projection is available for the spherical geoid only.

function hammer
%MATLAB Tour Partial Function Help:  map_con
%
% HAMMER Hammer Projection
% 
%  This projection is equal-area.  The world is displayed as an elipse, with 
%  curved parallels and meridians.  It is neither conformal nor equal area.  
%  The only point free of distortion is the center point.  Distortion of shape 
%  and area are moderate throughout.
%  
%  This projection was presented by H.H. Ernst von Hammer in 1892.  It is a 
%  modification of the Lambert azimuthal equal area projection.  Inspired by 
%  Aitoff projection, it is also known as the Hammer-Aitoff.  It in turn 
%  inspired the Briesemeister, a modified oblique Hammer projection.  John 
%  Bartholomew's Nordic projection is an oblique Hammer centered on 45 degrees 
%  north and the Greenwich meridian.  The Hammer projection is used in 
%  whole-world maps and astronomical maps in galactic coordinates.

function ortho
%MATLAB Tour Partial Function Help:  map_con
%
% ORTHO  Orthographic Azimuthal Projection
% 
%   This is a perspective projection on a plane tangent at the center
%   point from an infinite distance (that is, orthogonally).  The center
%   point is a pole in the common polar aspect, but can be any point.
%   This projection has two significant properties.  It looks like a
%   globe, providing views of the Earth resembling those seen from outer
%   space.  Additionally, all great and small circles are either straight
%   lines or elliptical arcs on this projection.  Scale is true only
%   at the center point, and is constant in the circumferential direction
%   along any circle having the center point as its center.  Distortion
%   increases rapidly away from the center point, the only place which
%   is distortion free.  This projection is neither conformal nor
%   equal area.
% 
%   This projection appears to have been developed by the Egyptians and
%   Greeks by the second century B.C.
% 
%   This projection is available for the spherical geoid only.

function stereo
%MATLAB Tour Partial Function Help:  map_con
%
% STEREO  Stereographic Azimuthal Projection
% 
%   This is a perspective projection on a plane tangent at the center
%   point from the point antipodal to the center point.  The center
%   point is a pole in the common polar aspect, but it can be any
%   point.  This projection has two significant properties.  It is
%   conformal, being free from angular distortion.  Additionally, all
%   great and small circles are either straight lines or circular
%   arcs on this projection.  Scale is true only at the center point,
%   and is constant along any circle having the center point as its
%   center.  This projection is not equal area.
% 
%   The polar aspect of this projection appears to have been developed
%   by the Egyptians and Greeks by the second century B.C.

function ups
%MATLAB Tour Partial Function Help:  map_con
%
% UPS Universal Polar Stereographic Projection
%  
%   This is a perspective projection on a plane tangent to the north or south 
%   pole This projection has two significant properties.  It is conformal, 
%   being free from angular distortion.  Additionally, all great and small 
%   circles are either straight lines or circular arcs on this projection.  
%   
%   This projection has two zones, 'north' and 'south'.  In the northern zone 
%   scale is true along latitude 87 degrees, 7 minutes N, and is constant 
%   along any other parallel.  In the southern zone the latitude of true scale 
%   is 87 degrees, 7 minutes S. This projection is not equal area.
%  
%   This projection is a special case of the stereographic projection in the 
%   polar aspect.  It is used as part of the Universal Transverse Mercator 
%   (UTM) system to extend coverage to the poles.

function vperspec
%MATLAB Tour Partial Function Help:  map_con
%
% VPERSPEC  Vertical Perspective Azimuthal Projection
% 
%   This is a perspective projection on a plane tangent at the center point 
%   from a finite distance.  Scale is true only at the center point, and is 
%   constant in the circumferencial direction along any circle having the 
%   center point as its center.  Distortion increases rapidly away from the 
%   center point, the only place which is distortion free.  This projection is 
%   neither conformal nor equal area.
%   
%   This projection providing views of the the globe resembling those seen from a 
%   spacecraft in orbit.  The standard parallel can be interpreted physically as 
%   the altitude of the observer above the surface in the same distance units 
%   as the geoid.  The orthographic projection is a limiting form with the 
%   observer at an infinite distance.
%   
%   This projection is available for the spherical geoid only.

function wiechel
%MATLAB Tour Partial Function Help:  map_con
%
% WIECHEL  Wiechel Pseudoazimuthal Projection
% 
%   This equal area projection is a novelty map, usually centered at
%   a pole, showing semicircular meridians in a pinwheel arrangement.
%   Scale is correct along the meridians.  This projection is not
%   conformal.
% 
%   This projection was presented by H. Wiechel in 1879.

function utmgeoid
%MATLAB Tour Partial Function Help:  map_con
%
% UTMGEOID  Recommended UTM geoids for zone
% 
%   GEOID = UTMGEOID without any arguments opens the UTMZONEUI interface 
%   for selecting a UTM zone.  This zone is then used to return the
%   recommended ellipsoid definition(s) for that particular zone.
% 
%   GEOID = UTMGEOID(Zone) uses the input ZONE to return the recommended 
%   ellipsoid definition(s).
% 
%   [GEOID,GEOIDSTR] = UTMGEOID(...) returns the geoid string used by 
%   the almanac function.

function utmzone
%MATLAB Tour Partial Function Help:  map_con
%
% UTMZONE  Universal Transverse Mercator zone
%  
%    ZONE = UTMZONE selects a Universal Transverse Mercator (UTM) zone with
%    a graphical user interface.
%  
%    ZONE = UTMZONE(lat,long) returns the UTM zone containing the geographic 
%    coordinates.  If lat and long are vectors, the zone containing the 
%    geographic mean of the data set is returned.  The geographic coordinates 
%    must be in units of degrees.
%    
%    ZONE = UTMZONE(mat), where mat is or the form [LAT LONG]
%  
%    [LATLIM,LONLIM] = UTMZONE('zone'), where zone is valid UTM zone 
%    designation, returns the geographic limits of the zone.  Valid UTM zones 
%    designations are numbers, or numbers followed by a single letter.  
%    Example: '31' or '31N'.  The returned limits are in units of degrees.
%  
%    LIM = UTMZONE('ZONE') returns the limits in a single vector output.
%  
%    [ZONE,MSG] = UTMZONE(...)  and [LATLIM,LONLIM,MSG] = UTMZONE(...)  
%    returns a message if there is an error.  MSG is empty when there are no 
%    errors.
%  
%    

