stairs

Generate a stair step plot.

Syntax

stairs(y)

stairs(x, y)

stairs(..., fmt)

stairs(..., property, value, ...)

stairs(hAxes, ...)

h = stairs(...)

[xout, yout] = stairs(...)

Inputs

x, y
Input values. If x is not given then the indices of y are used.
Dimension: vector | matrix
fmt
Formatting string of the curve.
Dimension: string
property
Any valid property for a line graphic object.
Dimension: string
value
Value of the property.
Dimension: double | integer | string
hAxes
Handle of an existing axis object.
Dimension: double

Outputs

h
Handle of the line graphics object.
xout
Generated x data.
yout
Generated y data.

Example 1

Simple stairs step plot.


figure;
h = stairs(1:10);
Figure 1. stairs figure 1


Example 2

Set x values and a line style.


figure;
h = stairs([1:2:10 11:14],  [1:5 4:-1:1], 'r--');
      
Figure 2. stairs figure 2


Example 3

X, y are matrices.


figure;
x = [1:10; 3:12; 5:14]';
y = ones(10,3).*[1:10]';
h = stairs(x, y);
      
Figure 3. stairs figure 3


Example 4

Get generated x, y values without creating a plot.


[xout, yout] = stairs(1:2:20, 1:10);
      

Comments

If no output or one output argument is given then the stairs command will plot a line in the current axes. If an axes doesn't exist, then one will be created. If two output argumnets are given, then the generated x, y values will be returned and the plot will not be created.