`ribbon`

Draws the columns of a matrix as 3-D ribbons.

Syntax

ribbon(Y)

Draws one ribbon for each column of Y, side by side along the y axis.

ribbon(X, Y)

Uses X for the positions along the ribbons.

ribbon(X, Y, width)

Sets the ribbon width, 0.75 by default.

h = ribbon(___)

Also returns the surface handles.

Description

A ribbon is a line plot thickened into a strip, so several data series can be compared in depth without hiding each other as much as overlapping lines would. The ribbons are colored by height.

Input arguments

X: Positions along the ribbons.
Y: Data, one ribbon per column.
width: Width of each ribbon.

Output arguments

h: Array of surface handles, one per column.

Example

Four series

h = ribbon(magic(4));
numel(h)

Output

ans = 4

ribbon