Main Content

quiverm

Project 2-D quiver plot on map axes

Syntax

h = quiverm(lat,lon,deltalat,deltalon)
h = quiverm(lat,lon,deltalat,deltalon,LineSpec)
h = quiverm(lat,lon,deltalat,deltalon,LineSpec,'filled')
h = quiverm(lat,lon,deltalat,deltalon,scale)
h = quiverm(lat,lon,deltalat,deltalon,LineSpec,scale,'filled')

Description

h = quiverm(lat,lon,deltalat,deltalon) displays velocity vectors with components (deltalat,deltalon) at the geographic points (lat,lon) on displayed map axes. All four inputs should be in the AngleUnits of the map axes. The inputs deltalat and deltalon determine the direction of the vectors in latitude and longitude, respectively. The function automatically determines the length of these vectors to make them as long as possible without overlap. The object handles of the displayed vectors can be returned in h.

h = quiverm(lat,lon,deltalat,deltalon,LineSpec) specifies the line style, marker, and color. If you use markers, they are plotted at the start points of the vectors, i.e., the input points (lat,lon).

h = quiverm(lat,lon,deltalat,deltalon,LineSpec,'filled') results in the filling in of any symbols specified by LineSpec.

h = quiverm(lat,lon,deltalat,deltalon,scale) and h = quiverm(lat,lon,deltalat,deltalon,LineSpec,scale,'filled') alter the automatically calculated vector lengths by multiplying them by the scalar value scale. For example, if scale is 2, the displayed vectors are twice as long as they would be if scale were 1 (the default). When scale is set to 0, the automatic scaling is suppressed, and the length of the vectors is determined by the inputs. In this case, the vectors are plotted from (lat,lon) to (lat+deltalat,lon+deltalon).

Examples

collapse all

Load the coast lines dataset.

load coastlines

Setup an axes specifying latitude and longitude limits. Plot the coast line data.

axesm('eqaconic','MapLatLimit',[30 60],'MapLonLimit',[-10 10])
framem; 
plotm(coastlat,coastlon)

Figure contains an axes object. The axes object contains 2 objects of type patch, line.

Plot quiver vectors in a direction corresponding to +5 degrees latitude and +3 degrees longitude. Use automatic scaling.

lat0 = [50 39.7]; 
lon0 = [-5.4 2.9];
deltalat = [5 5]; 
deltalon = [3 3];
quiverm(lat0,lon0,deltalat,deltalon,'r')

Figure contains an axes object. The axes object contains 4 objects of type patch, line.

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

's'Square

Sample of square marker

'd'Diamond

Sample of diamond line 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

'p'Pentagram

Sample of pentagram marker

'h'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

See Also

|

Introduced before R2006a