Main Content

scircleg

Add small circle to axesm-based map using mouse

Syntax

h = scircleg(ncirc)
h = scircleg(ncirc,npts)
h = scircleg(ncirc,LineSpec)
h = scircleg(ncirc,PropertyName,PropertyValue,...)
[lat,lon] = scircleg(ncirc,npts,...)
h = scircleg(track,ncirc,...)

Description

h = scircleg(ncirc) brings forward the current axesm-based map and waits for the user to make (2 * ncirc) mouse clicks. The output h is a vector of handles for the ncirc small circles, which are then displayed.

h = scircleg(ncirc,npts) specifies the number of plotting points to be used for each small circle. npts is 100 by default.

h = scircleg(ncirc,LineSpec) specifies the line style, marker, and color.

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

[lat,lon] = scircleg(ncirc,npts,...) returns the coordinates of the plotted points rather than the handles of the small circles. Successive circles are stored in separate columns of lat and lon.

h = scircleg(track,ncirc,...) specifies the logic with which ranges are calculated. If track is 'gc' (the default), great circle distance is used. If track is 'rh', rhumb line distance is used.

This function is used to define small circles for display using mouse clicks. For each circle, two clicks are required: one to mark the center of the circle and one to mark any point on the circle itself, thereby defining the radius.

Background

A small circle is the locus of all points an equal surface distance from a given center. For true small circles, this distance is always calculated in a great circle sense; however, the scircleg function allows a locus to be calculated using distances in a rhumb line sense as well. You can modify the circle after creation by shift+clicking it. The circle is then in edit mode, during which you can change the size and position by dragging control points, or by entering values into a control panel. Shift+clicking again exits edit mode.

More About

collapse all

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 StyleDescriptionResulting Line
"-"Solid line

Sample of solid line

"--"Dashed line

Sample of dashed line

":"Dotted line

Sample of dotted line

"-."Dash-dotted line

Sample of dash-dotted line, with alternating dashes and dots

MarkerDescriptionResulting Marker
"o"Circle

Sample of circle marker

"+"Plus sign

Sample of plus sign marker

"*"Asterisk

Sample of asterisk marker

"."Point

Sample of point marker

"x"Cross

Sample of cross marker

"_"Horizontal line

Sample of horizontal line marker

"|"Vertical line

Sample of vertical line marker

"square"Square

Sample of square marker

"diamond"Diamond

Sample of diamond marker

"^"Upward-pointing triangle

Sample of upward-pointing triangle marker

"v"Downward-pointing triangle

Sample of downward-pointing triangle marker

">"Right-pointing triangle

Sample of right-pointing triangle marker

"<"Left-pointing triangle

Sample of left-pointing triangle marker

"pentagram"Pentagram

Sample of pentagram marker

"hexagram"Hexagram

Sample of hexagram marker

Color NameShort NameRGB TripletAppearance
"red""r"[1 0 0]

Sample of the color red

"green""g"[0 1 0]

Sample of the color green

"blue""b"[0 0 1]

Sample of the color blue

"cyan" "c"[0 1 1]

Sample of the color cyan

"magenta""m"[1 0 1]

Sample of the color magenta

"yellow""y"[1 1 0]

Sample of the color yellow

"black""k"[0 0 0]

Sample of the color black

"white""w"[1 1 1]

Sample of the color white

Version History

Introduced before R2006a

See Also

|