h = multiwaveplot(...)
Multiwaveplot draws a series of stacked waves (one on top of the other) contained in the rows of an input 2-D matrix. Each wave has a designated row on the plot; the first row is plotted at the bottom of the plot.
multiwaveplot(wave) draws a series of waves contained in the rows of wave.
multiwaveplot(x,y,wave) plot the waves against the data in x and y, such that x specifies the common x data, and y determines the vertical position of each row. Hence, length(x)==size(wave,2) and length(y)==size(wave,1).
multiwaveplot(...,gain) scales the height of each wave according to gain. With gain=1 (default), the height of the tallest wave will be limited so as not to encroach on the adjacent wave; all other waves are scaled accordingly. This can be overridden by specifying gain > 1.
multiwaveplot(...,mode) plots the data with the specified mode. The default mode depends on gain: for gain <= 1, mode defaults to 'plot' and plots lines for each row of wave; for gain > 1, mode defaults to 'fill' and instead plots white patch objects for each row of wave, covering the area under each wave, such that waves with a lower row index mask those with a higher row index. This behaviour can be overridden by specifying MODE as a string (either 'plot' or 'fill').
h = multiwaveplot(...) returns a vector of handles to patch (for mode = 'fill') or lineseries (for mode = 'plot') graphics objects, one handle per wave.
See also FILL, PATCH, PLOT, IMAGESC.