Documentation of Contents


Global Index (all files) (short | long) | Local Index (files in subdir) (short | long)


Help text

 M_Map - mapping toolbox (Author: rich@ocgy.ubc.ca)
 Version 1.3 6/Nov/2000

 You have collected your data, loaded it into Matlab, analyzed 
 everything to death, and now you want to make a simple map showing 
 how it relates to the world. 

 But you can't. 

 Instead you have to figure out how to save all your data, and 
 then read it into a mapping program, and then spend all that extra 
 time figuring out why the mapping program doesn't give you what
 you expected it would...

 No more! 

                            Announcing M_Map v1.3f! 

 M_Map is a set of mapping tools written for Matlab v5. These include: 

    1. Routines to project data in 18 different spherical 
       projections (and determine inverse mappings) 
    2. A grid generation routine to make nice axes with 
       limits either in long/lat terms or in planar
       X/Y terms. 
    3. A coastline database (with 1/4 degree resolution) 
    4. A global elevation database (1 degree resolution) 
    5. Hooks into freely available high-resolution coastlines and
       bathymetry/topography.

 M_Map v1.3 is available via the web at 

       http://www.ocgy.ubc.ca/~rich/


 Toolbox contents

    Contents.m    - This file
    m_demo.m      - demonstrates a few different maps.

  User-callable functions

    m_proj.m      - initializes projections

    m_grid.m      - draws grids 
    m_scale       - forces map to a given scale.

    m_ungrid.m    - erases map elements (if you want to change parameters)

    m_coast.m     - draws a coastline
    m_elev.m      - draws elevation data from 1 degree database

    m_tbase.m     - draws elevation data from 5-minute TerrainBase database
    m_gshhs_c.m   - draws coastline from GSHHS crude database
    m_gshhs_l.m   - draws coastline from GSHHS low-resolution database
    m_gshhs_i.m   - draws coastline from GSHHS intermediate-resolution database
    m_gshhs_h.m   - draws coastline from GSHHS high-resolution database
    m_gshhs_f.m   - draws coastline from GSHHS full database
    m_plotbndry.m - draws a political boundary from the DCW 
    m_usercoast.m - draws a coastline using a user-specified subset database.

    m_plot.m      - draws line data in map coords
    m_line.m      - draws line data in map coords
    m_text.m      - adds text data in map coords
    m_legend.m    - Draw a legend box
    m_quiver      - draws arrows for vector data
    m_contour     - draws contour lines for gridded data
    m_contourf    - draws filled contours
    m_patch       - draws patch data
    m_track       - draws annotated tracklines
    m_range_ring  - draws range rings

    m_ll2xy.m     - converts from long/lat to map coordinates
    m_xy2ll.m     - converts from map coordinates to long/lat

    m_lldist      - distance between points (long/lat coordinates)
    m_xydist      - distance between points (map projection coordinates)

    m_tba2b.m     - used in installing high-resolution elevation database.

    m_vec.m       - fancy arrows

  Internal functions (not meant to be user-callable)

    private/mp_azim.m   - azimuthal projections
    private/mp_cyl.m    - cylindrical projections (equatorial)
    private/mp_conic.m  - conic projections
    private/mp_tmerc.m  - transverse cylindrical projections
    private/mp_utm.m    - elliptical universal transverse cylindrical projections
    private/mp_omerc.m  - oblique cylindrical projection

    private/mu_util.m   - various utility routines
    private/mu_coast.m  - routines to handle coastlines.

    private/clabel.m    - patched version of clabel 
                         (matlab v5.1 version does not contain
                         capabilities for different text properties).    

    private/m_coasts.mat - coastline data

  HTML documentation

    map.html           - Home page, examples
    private/mapug.html - User's guide
    private/*gif       - examples.
  

 Questions or problems; email me - rich@ocgy.ubc.ca.

 Rich Pawlowicz
 Oceanography, Dept. of Earth and Ocean Sciences, Univ. of British Columbia, 
 6270 University Blvd., Vancouver, B.C. CANADA V6T 1Z4
 email: rich@ocgy.ubc.ca 

Pierre-Michel THEVENY <theveny@dt.insu.cnrs.fr>