Mplot

From Eigenvector Research Documentation Wiki
Revision as of 22:16, 9 June 2014 by imported>Donal (→‎Options)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Purpose

Automatic creation of subplots and plotting.

Synopsis

[rows,cols] = mplot(n,options)
[rows,cols] = mplot([rows cols],options)
[rows,cols] = mplot(rows,cols,options)
[rows,cols] = mplot(y,options)
[rows,cols] = mplot(x,y,options)

Description

Inputs can be one of four forms:

(1) the number of subplots requested n, "best fit" onto the figure

(2) the number of rows and columns for the subplot array [rows cols]

(3) or data to plot y with or without reference data for the x-axis x. Each column of y is plotted in a single subplot on the figure.

Outputs are the number of rows rows and columns cols used for the subplots.

Examples

Example 1. To automatically create a "best fit" of four empty subplots

mplot(4)

Example 2. To automatically create four subplots in a 4 x 1 arrangement

mplot([4 1])

Example 3. To automatically plot three random columns, each in its own subplot

mplot(rand(100,3))

Options

  • center: [ {'no'} | 'yes' ] governs centering of "left-over" plots at bottom of figure (when an uneven number of plots are to be fit onto the screen,
  • axismode : [ {} | 'tight' ] governs axis settings,
  • plots : [ 'none' | {'final'} ] governs creation of axes. If set to 'none', no axes are created and mplot only returns the rows and columns which would be used if axes were created.

Algorithm

When mplot is doing the "best fit", it attempts to keep the number of rows and columns as close as possible in size (Except for n=3 which is done as a 3x1 figure). Thus, the plot progression is: 1x1, 2x1, 3x1, 2x2, 3x2, 3x3, 4x3, etc.

See Also

plotgui, subplot