stem3

Syntax

h = stem3(x, y, z)

h = stem3(x, y, z, fmt)

h = stem3(z, fmt)

h = stem3(... property, value, ...)

h = stem3(hAxes, ...)

Inputs

x,y,z

Range of the x and y axes.

Type: double | integer

Dimension: vector | matrix

fmt

The formatting string for the curve. It can be any combination for the following strings:

1. line style: '-'.
2. line color: 'r', 'g', 'b', 'c', 'y', 'm', 'w', 'b'.
3. marker style: 's', 'o', 'd', 'x', 'v', '^', '+', '*', '.'.

Type: string

Dimension: scalar

property

Properties that control the appearance or behavior of the graphics object.

Type: string

Dimension: scalar

value

Value of the properties.

Type: double | integer | string

Dimension: scalar | vector

hAxes

Axis handle.

Type: double

Dimension: scalar

Outputs

h

The handle of the 3D stem graphics object.

Examples

Simple stem3 example:

clf;
h = stem3(1:10,rand(1,10),1:10);

Figure 1. Stem3 example

stem3 example with format and property options:

clf;
h = stem3(1:10,rand(1,10),1:10,'^k','markersize',20);

Figure 2. Stem3 with format and properties set

Single vector input example:

clf;
h = stem3(cos(1:0.2:10));

Figure 3. Stem3 - single vector input

Single matrix input example:

clf;
[x,y] = meshgrid(1:5);
z = abs(sin(x+y));
h = stem3(z,'marker','.');

Figure 4. Stem3 - single matrix input

Comments

If there is no axis, one will be created first. If x and y are omitted, the index of z is used as data to associate with the the x and y axis. Stem3 takes optional arguments to control the stem style. It can be either a format string, property/value pair(s), or both. If the first argument of stem3() is an axis handle, the 3D stem will be created in that axis.