Plot 3-D discrete sequence data
stem3(
plots entries
in Z
)Z
as stems extending from the xy-plane
and terminating with circles at the entry values. The stem locations
in the xy-plane are automatically generated.
stem3(___,
fills
the circles. Use this option with any of the input argument combinations
in the previous syntaxes.'filled'
)
stem3(___,
specifies
stem series properties using one or more Name,Value
)Name,Value
pair
arguments.
Create a 3-D stem plot of cosine values between
and
with a row vector input.
figure X = linspace(-pi/2,pi/2,40); Z = cos(X); stem3(Z)
stem3
plots elements of Z
against the same y value at equally space x values.
Create a 3-D stem plot of cosine values between
and
with a column vector input.
figure X = linspace(-pi/2,pi/2,40)'; Z = cos(X); stem3(Z)
stem3
plots elements of Z
against the same x value at equally space y values.
Create a 3-D stem plot of sine and cosine values between
and
with a matrix input.
figure X = linspace(-pi/2,pi/2,40); Z = [sin(X); cos(X)]; stem3(Z)
stem3
plots each row of Z
against the same y value at equally space x values.
Create a 3-D stem plot and specify the stem locations along a curve. Use view
to adjust the angle of the axes in the figure.
figure X = linspace(-5,5,60); Y = cos(X); Z = X.^2; stem3(X,Y,Z) view(-8,30)
X
and Y
determine the stem locations. Z
determines the marker heights.
Create a 3-D stem plot with matrix data and specify the stem locations in the xy-plane.
figure [X,Y] = meshgrid(0:.1:1); Z = exp(X+Y); stem3(X,Y,Z)
X
and Y
determine the stem locations. Z
determines the marker heights.
Create a 3-D stem plot of cosine values between
and
and fill in the markers.
X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'filled')
Create a 3-D stem plot of cosine values between
and
. Use a dashed line style for the stem, set the marker symbols to stars, and set the color to magenta.
figure
X = linspace(-pi,pi,40);
Z = cos(X);
stem3(Z,'--*m')
To specify only two of the three LineSpec
options, omit the third option from the character vector. For example, '*m'
sets the marker symbol and the color and uses the default line style.
Create a 3-D stem plot and specify the stem locations along a circle. Set the stem to a dotted line style, the marker symbols to stars, and the color to magenta.
figure
theta = linspace(0,2*pi);
X = cos(theta);
Y = sin(theta);
Z = theta;
stem3(X,Y,Z,':*m')
X
and Y
determine the stem locations. Z
determines the marker heights.
Create a 3-D stem plot of cosine values between
and
. Set the marker symbols to squares with green faces and magenta edges.
figure X = linspace(-pi,pi,40); Z = cos(X); stem3(Z,'Marker','s',... 'MarkerEdgeColor','m',... 'MarkerFaceColor','g')
Specify the axes for a 3-D stem plot.
Define vectors X
, Y
and Z
.
X = linspace(-2,2,50); Y = X.^3; Z = exp(X);
Create a figure with two subplots and return the handles to each axes, s(1)
and s(2)
. Plot a 3-D stem plot in the lower subplot by referring to its axes handle, s(2)
. For comparison, plot a 2-D stem plot in the upper subplot by referring to its axes handle, s(1)
.
figure s(1) = subplot(2,1,1); s(2) = subplot(2,1,2); stem(s(1),X,Z) stem3(s(2),X,Y,Z)
Create a 3-D stem plot and return the stem series object.
X = linspace(0,2);
Y = X.^3;
Z = exp(X).*cos(Y);
h = stem3(X,Y,Z,'filled');
Change the color to magenta and set the marker face color to yellow. Use view
to adjust the angle of the axes in the figure. Starting in R2014b, you can use dot notation to set properties. If you are using an earlier release, use the set
function instead.
h.Color = 'm'; h.MarkerFaceColor = 'y'; view(-10,35)
Z
— Data sequence to displayData sequence to display, specified as a vector or matrix. stem3
plots
each element in Z
as a stem extending from the xy-plane
and terminating at the data value.
If Z
is a row vector, stem3
plots
all elements against the same y value at equally
spaced x values.
If Z
is a column vector, stem3
plots
all elements against the same x value at equally
spaced y values.
If Z
is a matrix, stem3
plots
each row of Z
against the same y value
at equally spaced x values.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
X
— Locations to plot values of Z
Locations to plot values ofZ
, specified as
a vector or a matrix. Inputs X
, Y
and Z
must
be vectors or matrices of the same size.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
Y
— Locations to plot values of Z
Locations to plot values of Z
, specified
as a vector or a matrix. Inputs X
, Y
and Z
must
be vectors or matrices of the same size.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
LineSpec
— Line style, marker, and colorLine style, marker, and color, specified as a character vector
of symbols. For more information, see LineSpec
.
Example: ':*r'
Data Types: char
ax
— Axes objectAxes object. If you do not specify an axes, then stem
plots
into the current axes.
Specify optional comma-separated pairs of Name,Value
arguments.
Name
is the argument
name and Value
is the corresponding
value. Name
must appear
inside single quotes (' '
).
You can specify several name and value pair
arguments in any order as Name1,Value1,...,NameN,ValueN
.
'LineStyle',':','MarkerFaceColor','red'
plots
the stem as a dotted line and sets the marker face color to red.The properties listed here are only a subset. For a complete list, see Stem Series Properties.
'LineStyle'
— Line style'-'
(default) | '--'
| ':'
| '-.'
| 'none'
Line style, specified as one of the line styles listed in this table.
Line Style | Description | Resulting Line |
---|---|---|
'-' | Solid line |
|
'--' | Dashed line |
|
':' | Dotted line |
|
'-.' | Dash-dotted line |
|
'none' | No line | No line |
'LineWidth'
— Line width of stem and marker edge0.5
(default) | positive valueLine width of stem and marker edge, specified as a positive value in point units.
Example: 0.75
'Color'
— Stem color[0 0 0]
(default) | RGB triplet | character vector of color name | 'none'
Stem color, specified as an RGB triplet, a character vector
of a color name, or 'none'
. If you specify the Color
as 'none'
,
then the stems are invisible.
An RGB triplet is a three-element row vector whose elements
specify the intensities of the red, green, and blue components of
the color. The intensities must be in the range [0,1]
;
for example, [0.4 0.6 0.7]
. This table lists the
long and short color name options and the equivalent RGB triplet values.
Long Name | Short Name | RGB Triplet |
---|---|---|
'yellow' | 'y' | [1 1 0] |
'magenta' | 'm' | [1 0 1] |
'cyan' | 'c' | [0 1 1] |
'red' | 'r' | [1 0 0] |
'green' | 'g' | [0 1 0] |
'blue' | 'b' | [0 0 1] |
'white' | 'w' | [1 1 1] |
'black' | 'k' | [0 0 0] |
Example: 'blue'
Example: [0
0 1]
'Marker'
— Marker symbol'o'
(default) | '+'
| '*'
| '.'
| 'x'
| ...Marker symbol, specified as one of the markers listed in this table.
Value | Description |
---|---|
'o' | Circle |
'+' | Plus sign |
'*' | Asterisk |
'.' | Point |
'x' | Cross |
'square' or 's' | Square |
'diamond' or 'd' | Diamond |
'^' | Upward-pointing triangle |
'v' | Downward-pointing triangle |
'>' | Right-pointing triangle |
'<' | Left-pointing triangle |
'pentagram' or 'p' | Five-pointed star (pentagram) |
'hexagram' or 'h' | Six-pointed star (hexagram) |
'none' | No markers |
Example: '+'
Example: ‘diamond'
'MarkerSize'
— Marker size6
(default) | positive valueMarker size, specified as a positive value in points.
Example: 10
'MarkerEdgeColor'
— Marker outline color'auto'
(default) | 'none'
| RGB triplet | character vector of color nameMarker outline color, specified as one of these values:
'auto'
— Use the same color
specified in the Color
property.
'none'
— Use no color, which
makes unfilled markers invisible.
RGB triplet or character vector of a color name — Use the specified color.
An RGB triplet is a three-element row vector whose elements
specify the intensities of the red, green, and blue components of
the color. The intensities must be in the range [0,1]
;
for example, [0.4 0.6 0.7]
. This table lists the
long and short color name options and the equivalent RGB triplet values.
Long Name | Short Name | RGB Triplet |
---|---|---|
'yellow' | 'y' | [1 1 0] |
'magenta' | 'm' | [1 0 1] |
'cyan' | 'c' | [0 1 1] |
'red' | 'r' | [1 0 0] |
'green' | 'g' | [0 1 0] |
'blue' | 'b' | [0 0 1] |
'white' | 'w' | [1 1 1] |
'black' | 'k' | [0 0 0] |
Example: [0.5 0.5 0.5]
Example: 'blue'
'MarkerFaceColor'
— Marker fill color'none'
(default) | 'auto'
| RGB triplet | character vector of color nameMarker fill color, specified as one of these values:
'none'
— Use no color, which
makes the interior invisible.
'auto'
— Use the same color
as the Color
property
for the axes.
RGB triplet or character vector of a color name — Use the specified color.
An RGB triplet is a three-element row vector whose elements
specify the intensities of the red, green, and blue components of
the color. The intensities must be in the range [0,1]
;
for example, [0.4 0.6 0.7]
. This table lists the
long and short color name options and the equivalent RGB triplet values.
Long Name | Short Name | RGB Triplet |
---|---|---|
'yellow' | 'y' | [1 1 0] |
'magenta' | 'm' | [1 0 1] |
'cyan' | 'c' | [0 1 1] |
'red' | 'r' | [1 0 0] |
'green' | 'g' | [0 1 0] |
'blue' | 'b' | [0 0 1] |
'white' | 'w' | [1 1 1] |
'black' | 'k' | [0 0 0] |
Example: [0.3 0.2 0.1]
Example: 'green'
h
— Stem series objectStem series object, specified as a scalar. This is a unique identifier, which you can use to modify the properties of the stem series after it is created.