mplot creates a figure with a list box and axes. The list box contains references to plot instructions to sketch data on the axes. Plot instructions are added to the list box with successive calls to the function mplot.
A plot instruction is either a function handle that takes at least a single argument, which is an axes handle; or a series of additional arguments passed to mplot, which are delegated unchanged to the built-in plot function.
When an item is selected in the list box, the corresponding instructions are used to plot data on the right-hand side axes. This means either calling the user-defined function with the axes handle as the first parameter, or the built-in plot function with all the additional arguments. When an item is double-clicked, a new figure window opens and data are plotted on a new pair of axes. This is useful when the axes are to be saved or exported.
% creates an empty mplot figure if current figure is not already one
fig = mplot;
% returns the current figure handle in fig if it is an mplot figure, creating a new figure if needed
fig = mplot('new')
% unconditionally creates an empty mplot figure and returns its handle in fig
x = 1:100; y = rand(1,100); mplot(x, y, 'kx');
% adds a new plot to the currently active mplot figure; whenever the corresponding list item is clicked, plot(x,y,'kx') is executed
x = 1:100; y = rand(1,100); mplot(fig, x, y, 'kx');
% uses the specified mplot figure instead of the currently active one
x = 1:100; y = rand(1,100); mplot('my caption', x, y, 'kx');
% assigns the given caption to the newly added plot
fun = @(ax) plot(ax, x, y, 'k.'); mplot(fun);
% adds a new plot instruction given by a user function