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!
-
** M_Map is a set of mapping tools originally written for Matlab v5. I am attempting to convert it to a python module so that it can be integrated with Jupyter Notebooks so that results and code can be shared more easily over the internet. **
-
M-Map for Matlab includes:
- Routines to project data in 18 different spherical projections (and determine inverse mappings)
- A grid generation routine to make nice axes with limits either in long/lat terms or in planar X/Y terms.
- A coastline database (with 1/4 degree resolution)
- A global elevation database (1 degree resolution)
- Hooks into freely available high-resolution coastlines and bathymetry/topography.
-
_Map v1.4 for Matlab is available via the web at
http://www.eos.ubc.ca/~rich/
Readme.md - This file
m_demo.m - demonstrates a few different maps.
-
** User-callable functions : ** m_map.
m_proj - initializes projections m_coord - converts between geomagnetic and geographic coords.
m_grid - draws grids m_scale - forces map to a given scale. m_ruler - draw a scale ruler
m_ungrid - erases map elements (if you want to change parameters)
m_coast - draws a coastline m_elev - draws elevation data from 1 degree database
m_tbase - draws elevation data from 5-minute TerrainBase database m_gshhs - draws coastline from GSHHS with specified resolution m_gshhs_c - draws coastline from GSHHS crude database m_gshhs_l - draws coastline from GSHHS low-resolution database m_gshhs_i - draws coastline from GSHHS intermediate-resolution database m_gshhs_h - draws coastline from GSHHS high-resolution database m_gshhs_f - draws coastline from GSHHS full database m_plotbndry - draws a political boundary from the DCW m_usercoast - draws a coastline using a user-specified subset database. m_shaperead - reads ESRI shapefiles
m_plot - draws line data in map coords m_line - draws line data in map coords m_text - adds text data in map coords m_legend - 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_hatch.m - hatched or speckled patches. m_range_ring - draws range rings (spherical coords) m_ellipse - draws tidal ellipses (most requested ocean feature!)
m_ll2xy - converts from long/lat to map coordinates m_xy2ll - converts from map coordinates to long/lat
m_geo2mag - converts from long/lat to geomagnetic coordinates m_mag2geo - converts from geomagnetic coordinates to long/lat
m_lldist - spherical distance/geodesics between points (long/lat coordinates) m_xydist - spherical distance between points (map projection coordinates)
m_fdist - ellipsoidal geodesic forward calculation m_idist - ellipsoidal geodesic inverse calculation m_geodesic - points along ellipsoidal geodesics
m_tba2b - used in installing high-resolution elevation database.
m_vec - fancy arrows
-
** Internal functions (not meant to be user-callable) **
private/mp_azim - azimuthal projections private/mp_cyl - cylindrical projections (equatorial) private/mp_conic - conic projections private/mp_tmerc - transverse cylindrical projections private/mp_utm - elliptical universal transverse cylindrical projections private/mp_omerc - oblique cylindrical projection
private/mu_util - various utility routines private/mu_coast - routines to handle coastlines.
private/mc_coords - coordinate systems based on different poles.
private/clabel.m.OLD - patched version of clabel (matlab v5.1 version does not contain capabilities for different text properties). Not compatible with R2011b (and later)
private/m_coasts.mat - coastline data
map.html - Home page, examples
private/mapug.html - User's guide
private/*gif - examples.
Originally written for Matlab by : Rich Pawlowicz Dept. of Earth, Ocean, Atmospheric Sciences, Univ. of British Columbia, 6339 Stores Rd., Vancouver, B.C. CANADA V6T 1Z4 email: [email protected]