Program: MKMAPOPT
mkmapopt............get/set MAPping OPTions structure
call: mapopt=mkmapopt;
mapopt=mkmapopt('default');
mapopt=mkmapopt('Name1',Value1,'Name2',Value2,...);
'default': return default settings for all options
This is the same as calling mkmapopt without any
input parameter.
'Name',Value: return complete options structure, in which
the options specified by NAME has the value
specified by VALUE.
If a Name occurs more than once, only the last
of the values specified will apply.
Names used here must correspond to the field names
of eviopt as given below.
Option names are not case sensitive.
result: mapopt: complete mapopt structure as needed by MKMAKEMAP.
The strucutre consists of the following fields:
MAP PROJECTION STUFF
.proj_type: projection type
.proj_scale: projection scale
.proj_range: projected part of topography
4 element vector [minlon maxlon minlat maxlat] that defines the
area shown in the map.
minlon might be negative, but abs(maxlon-minlon) must be <360deg.
If not specified explicitly, this will be equal to [0 360 -90 90]
.proj_specops: special options needed by the projection
The content of this array is not defined here. Some projections
need additional parameters like tangent-parallels and the like.
Such data is stored here. See the projection routines to
find details.
.proj_pole: Rotational parameters
This is a two element vector [lon lat] which defines a
rotation of the coordinate frame.
Data will be rotated by lon degrees eastwward and then
by 90-lat degrees northward
DEFAULT: empty
longitude has to be counted eastward from 0 to 360
latitude has to be counted northward from -90 to 90
If this is empty, no rotation will be applied. PLotting the
map is much fastern then, because delaunay triangulation has
to be applied to rotated topo data. Depending on the projection,
the behaviouir of rotation may be unexpected. Try plotting maps
with [0,0], [0,90], [90,0] to get an idea of what you have to choose.
When using rotation, it is recommended to plot grid lines
with a high number of points per line and in '.' style.
PLANET SIZE STUFF
.planet_type: Ellipsoid type
Planets may be uniaxial, biaxial or triaxial ellipsoids
possible values are:
'uni', 'sphere': Uniaxial is a sphere, of course.
'bi': Biaxial is a rotational ellipsoid.
'tri': Triaxial is a triaxial ellipsoid.
Axes of biaxial and triaxial planets are expected
to be polar and in equatorial plane.
.planet_radius: 1, 2, or 3 element vector of radius values, in km
For uniaxial (spherical) planets, only the first element is used.
For biaxial planets, elements 1 and 2 are used.
For triaxial planets, all three elements are used.
Axis orientation is defined by .PLANET_ORIENT substructure
.planet_orient: Ellipsoid axis orientation for triaxial planets
This substructure defines the points at the surface to
which the three axes of the ellipsoi d point.
Not that axes are not necessarily polar/equatorial!
planet_orient(1,1): longitude of planet_radius(1) [deg]
planet_orient(1,2): latitude of planet_radius(1) [deg]
planet_orient(2,1): longitude of planet_radius(2) [deg]
planet_orient(2,2): latitude of planet_radius(2) [deg]
planet_orient(3,1): longitude of planet_radius(3) [deg]
planet_orient(3,2): latitude of planet_radius(3) [deg]
TOPO DATA STUFF
.topo_mode: switch to enable or disable topography plotting
'on': the topography will be plotted
'off': the topography will not be plotted.
DEFAULT: 'on'
.topo_path: path to .mat file containing topography data
The topography file is expected to contain the following matrix:
topo: matrix of elevation values, with topo(1,1) being the
elevation at 0degE, 90degS and topo(end,end) being the
elevation at 360degE, 90degN
OPTIONAL:
a matrix LON with longitude values and a matrix LAT with
latitude values for each element of TOPO.
.topo_range: 4 element matrix defining coordinate range of topo data
[minlon maxlon minlat maxlat], all given in degrees,
longitude positive to east, latitude positive to north
if the data givn here is not compatible to LON and LAT data
given in the topo file, these are overridden! To avoid this, set
.TOPO_RANGE to empty!
NOTE: this property defines the size of the topo data set, not
the area shown in the map! (that's .proj_range)
.topo_exag: topography exaggeration factor
topography will be multiplied by map scale and then by this factor
This results in a vertical exaggeration of topography withn respect
to horizontal extent by factor .TOPO_EXAGG
GRID STUFF
.grid_mode: grid plot mode
'on': a grid will be drawn according to the grid parameters
'off': no gridd will be drawn, parameters are irrelevant.
.grid_range: area of the map to be covered with lon/lat grid
4 element vector [minlon maxlon minlat maxlat]
If not specified explicitly, this will be equal to [0 360 -90 90]
.grid_lonmesh: grid mesh width in longitude direction [deg]
.grid_latmesh: grid mesh width in latitude direction [deg]
.grid_points: number of points per grid line
.grid_color: grid line color, specified as MatLab ColorSpec
(name string or RGB triple)
.grid_style: grid line style, specified as MatLab LineSpec
FRAME STUFF
.frame_mode: frame plot mode
'on': a frame will be drawn around the map
'off': no frame will be drawn
.frame_color: frame line color, specified as MatLab ColorSpec
.frame_style: frame line style, specified as MatLab LineSpec
COLORBAR STUFF
.colorbar_mode: colorbar plot mode
'on' plots a colorbar under or beside map
'off' does not plot a colorbar
.colorbar_dir: colorbar orientation
'hor': horizontal colorbar under map
'vert': vertical colorbar beside map
Martin Knapmeyer 01.07.2003, 11.05.2004
Read M-File Source Code
eof.