trackg

Display great circle or rhumb line on axesm-based map using mouse

Syntax

h = trackg(ntrax)
h = trackg(ntrax,npts)
h = trackg(ntrax,LineSpec)
h = trackg(ntrax,PropertyName,PropertyValue,...)
[lat,lon] = trackg(ntrax,npts,...)
h = trackg(track,ntrax,...)


Description

h = trackg(ntrax) brings forward the current axesm-based map and waits for the user to make (2 x ntrax) mouse clicks. The output h is a vector of handles for the ntrax track segments, which are then displayed.

h = trackg(ntrax,npts) specifies the number of plotting points to be used for each track segment. npts is 100 by default.

h = trackg(ntrax,LineSpec) specifies the line style, marker, and color.

h = trackg(ntrax,PropertyName,PropertyValue,...) allows property name/property value pairs to be set, where PropertyName and PropertyValue are recognized by the line function.

[lat,lon] = trackg(ntrax,npts,...) returns the coordinates of the plotted points rather than the handles of the track segments. Successive segments are stored in separate columns of lat and lon.

h = trackg(track,ntrax,...) specifies the logic with which tracks are calculated. If track is 'gc' (the default), a great circle path is used. If track is 'rh', rhumb line logic is used.

This function is used to define great circles or rhumb lines for display using mouse clicks. For each track, two clicks are required, one for each endpoint of the desired track segment. You can modify the track after creation by Shift+clicking it. The track is then in edit mode, during which you can change the length and position by dragging control points, or by entering values into a control panel. Shift+clicking again exits edit mode.

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]

Version History

Introduced before R2006a