stairs
Stairstep graph.
📝Syntax
stairs(Y)
stairs(X, Y)
stairs(..., LineSpec)
stairs(..., Name, Value)
stairs(ax, ...)
h = stairs(...)
[xb, yb] = stairs(...)
📥Input Arguments
Parameter Description
X x values.
Y y values.
LineSpec Line style, marker and/or color: character vector or scalar string.
propertyName a scalar string or row vector character.
propertyValue a value.
ax Axes object.
📤Output Arguments
Parameter Description
h line object.
xb x values for use with plot
yb y values for use with plot
📄Description

Stairstep graphs are a valuable tool for creating time-history plots of digitally sampled data.

stairs(Y) function is used to generate such graphs by plotting the elements of the vector Y.

If Y is a matrix, it draws one line for each column, with the color of the lines determined by the ColorOrder property of the axes.

In the case of a vector Y, the x-axis scale spans from 1 to the length of Y, while for a matrix Y, the x-axis scale ranges from 1 to the number of rows in Y.

stairs(X, Y) allows you to plot the elements in Y at specific locations defined by the vector X.

It's important to note that the elements in X must be in a monotonic order to create a valid stairstep graph.

💡Examples
f = figure();
f = figure();
x1 = linspace(0,2*pi)';
x2 = linspace(0,pi)';
X = [x1,x2];
Y = [sin(5*x1),exp(x2).*sin(5*x2)];
ax = gca();
stairs(ax, X,Y)
Example illustration
X = linspace(0,1,45)';
Y = [cos(3*X), exp(X).*sin(9*X)];
h = stairs(X,Y);
h(1).Marker = 'o';
h(1).MarkerSize = 5;
h(2).Marker = '+';
h(2).MarkerFaceColor = 'm';
Example illustration
🔗See Also
plot
🕔Version History
Version Description
1.0.0 initial version
Edit this page on GitHub