Path: Common/Graphics
% Easily build a versatile 2D plot page consisting of any number of plots.
Data is indexed into a subplot grid and labels are applied automatically.
The data series must be in rows. Any of the inputs, except y, may be
omitted or [].
The elements of iY indicate what rows of the y matrix should be plotted on
each subplot. If iY is not entered the number of y-axis labels will determine
the number of plots on the page. The number of rows of x must equal the number
of x labels. If you enter only one row of x it will be used for all plots
without the need to enter iX. Otherwise, the elements of iX indicate
which rows of the x matrix should be used for each subplot.
For example, to plot a position in a (3,n) matrix:
Plot2D( t, r, 'Time', {'X','Y','Z'}, 'Position Vector' )
or even just
Plot2D( t, r )
To plot this position overlaid with a target,
Plot2D(t,[r;rT],'Time',{'X','Y','Z'},'Position Vector',[],{'[1 4]','[2 5]','[3 6]'})
This function has a built-in demo with 4 subplots showing indexing. Type
Plot2D for the demo.
--------------------------------------------------------------------------
Form:
[h, hA] = Plot2D( x, y, xL, yL, figTitle, plotType, iY, iX, nCols, pThresh, figBackColor, leg )
--------------------------------------------------------------------------
------
Inputs
------
x (m,:) x values
y (n,:) y values
xL (m,:) or {m} x-axis label(s)
yL (n,:) or {n} y-axis label(s)
figTitle (:) Figure title
plotType (n,4) or {n} Type of axes 'xlog', 'ylog', 'log', 'lin'. 'lin' is the default.
iY (n,:) or {n} Index. Indexes Y data to plots. Each row or cell gives the indexes
of the data that go on that plot. This is a string,
either '[1 2 3 4]', '1:3', or an array.
iX (n,1) Index. Indexes X data to plots. Each row gives the indexes
of the x data that goes with that plot.
nCol (1,1) Number of columns.
pThresh (1,1) Minimum plot resolution. Set to 2.220446049250313e-10 for PowerPC
Prevents a MATLAB warning that appears in V5.x.
figBackColor (1) Flag for fig background color (0 - grey, 1 - white)
leg {} Add legends for each plot {{'a', 'b', 'c'},{'x','y'}}
-------
Outputs
-------
h (1,1) Figure handle
hA (:) Data structure of handles to line objects
.h
--------------------------------------------------------------------------
Common: General/CellToMat Common: General/MatToCell Common: General/Watermark Common: Graphics/PltStyle
Back to the Common Module page