linem

Project line on axesm-based map

Syntax

h = linem(lat,lon)
h = linem(lat,lon,LineSpec)
h = linem(lat,lon,PropertyName,PropertyValue,...)
h = linem(lat,lon,z)


Description

h = linem(lat,lon) displays projected line objects on the current axesm-based map. lat and lon are the latitude and longitude coordinates, respectively, of the line object to be projected. Note that this ordering is conceptually reversed from the MATLAB^® line function, because the vertical (y) coordinate comes first. However, the ordering latitude, then longitude, is standard geographic usage. lat and lon must be the same size and in the AngleUnits of the axesm-based map. The object handle for the displayed line can be returned in h.

To display lines on geographic axes or map axes, use the line function instead.

h = linem(lat,lon,LineSpec) specifies the line style, marker, and color.

h = linem(lat,lon,PropertyName,PropertyValue,...) allows the specification of any number of property name/property value pairs for any properties recognized by the MATLAB line function except for XData, YData, and ZData.

h = linem(lat,lon,z) displays a line object in three dimensions, where z is the same size as lat and lon and contains the desired altitude data. z is independent of AngleUnits. If omitted, all points are assigned a z-value of 0 by default.

The units of z are arbitrary, except when using the globe projection. In the case of globe, z should have the same units as the radius of the earth or semimajor axis specified in the 'geoid' (reference ellipsoid) property of the axesm-based map. This implies that when the reference ellipsoid is a unit sphere, the units of z are earth radii.

linem is the mapping equivalent of the MATLAB line function. It is a low-level graphics function for displaying line objects in map projections. Ordinarily, it is not used directly. Use plotm or plot3m instead.

Examples

axesm sinusoid; framem
linem([15; 0; -45; 15],[-100; 0; 100; 170],'r-')

More About

Line Style, Marker, and Color

Specify the line style, marker, and color as a character vector or string containing symbols. The symbols can appear in any order. You do not need to specify all three characteristics (line style, marker, and color). For example, specify a red dashed line using '--r'.

Line Style	Description	Resulting Line
"-"	Solid line
"--"	Dashed line
":"	Dotted line
"-."	Dash-dotted line

Marker	Description	Resulting Marker
"o"	Circle
"+"	Plus sign
"*"	Asterisk
"."	Point
"x"	Cross
"_"	Horizontal line
"|"	Vertical line
"square"	Square
"diamond"	Diamond
"^"	Upward-pointing triangle
"v"	Downward-pointing triangle
">"	Right-pointing triangle
"<"	Left-pointing triangle
"pentagram"	Pentagram
"hexagram"	Hexagram

Color Name	Short Name	RGB Triplet	Appearance
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]