quiver3m
Project 3-D quiver plot on axesm-based map
Syntax
Description
quiver3m(
plots a 3-D quiver plot on the current lat,lon,z,dlat,dlon,dz)axesm-based map. The quiver plot
has arrows with directional components dlat, dlon,
and dz at the geographic coordinates specified by
lat and lon with altitude
z. For example, the first arrow originates from the point
lat(1), lon(1), and z(1),
extends in the direction of the latitude axis according to dlat(1),
extends in the direction of the longitude axis according to dlon(1),
and extends in the direction of the z-axis according to
dz(1). By default, the function scales the arrow lengths so that they
do not overlap.
quiver3m(
adjusts the length of arrows:lat,lon,z,dlat,dlon,dz,scale)
When
scaleis a positive number, the function automatically adjusts the lengths of arrows so they do not overlap, then stretches them by a factor ofscale. For example, ascaleof2doubles the length of arrows, and ascaleof0.5halves the length of arrows.When
scaleis"off"or0, such asquiver3m(lat,lon,z,dlat,dlon,dz,"off"), the function does not perform automatic scaling.
h = quiver3m(___)
Examples
Load sample data that represents air currents into the workspace, and select a subset of the data. Specify lon and dz by scaling the original data.
load wind
lat = y(13:19,13:19,1);
lon = -x(13:19,13:19,1);
z = z(13:19,13:19,1);
dlat = v(13:19,13:19,1);
dlon = u(13:19,13:19,1);
dz = 500*w(13:19,13:19,1);Create a map and display a 3-D quiver plot of the subset you selected. The matrices lat, lon, and z represent the location of the base of each arrow, and dlat, dlon, and dz represent the directional components of each arrow. By default, the quiver3m function shortens the arrows so they do not overlap.
figure axesm miller axis off quiver3m(lat,lon,z,dlat,dlon,dz) view(3)
Input Arguments
Altitude components of the arrows, specified as a scalar, vector, or matrix.
The sizes of lat, lon,
z, dlat, dlon, and
dz must match.
When the MapProjection property of the
axesm-based map is 'globe',
dz is referenced to the ellipsoid.
The units of dz must match the units of
z.
Data Types: single | double
Line style, marker, and color, specified as a character vector or string scalar containing symbols. The symbols can appear in any order. You do not need to specify all three characteristics (line style, marker, and color).
If you specify a marker using LineSpec, then the
quiver3m function does not display arrowheads.
Example: "--or" is a red dashed line with circle
markers
| 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] |
|
Arrow scaling factor, specified as a nonnegative number or "off".
By default, the quiver3m function automatically scales the arrows
so they do not overlap. The quiver3m function applies the specified
scaling factor after it automatically scales the arrows.
To turn off automatic scaling, specify scale as
"off" or 0. When you specify either of these
values, the function plots the arrows from (lat,
lon, z) to
(lat+dlat,
lon+dlon,
z+dz).
Output Arguments
Version History
Introduced before R2006a
