LTPDA Toolbox™ | contents | ![]() ![]() |
IPLOT provides an intelligent plotting tool for LTPDA. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% DESCRIPTION: IPLOT provides an intelligent plotting tool for LTPDA. CALL: hfig = iplot (a,pl) [hfig, hax] = iplot (a,pl) [hfig, hax, hli] = iplot (a,pl) INPUTS: pl - a parameter list a - input analysis object OUTPUTS: hfig - handles to figures hax - handles to axes hli - handles to lines AO Plot Info ------------ If an input AO has a filled plotinfo plist, then the options contained in therein will overide any other options. The recognised keys are: 'linestyle', 'linewidth', 'color', 'marker', 'legend_on' The possible values are all those accepted by plot. Notes on Parameters ------------------- Many of the properties take cell-array values. If the length of the cell array is shorter than the number of lines to plot, the remaining lines will be plotted with the default options. If the cell array is of length 2 and the first cell contains the string 'all', then the second cell is used to set the propery of all lines. Error parameters: If you give more than one input AO then you must specify the following parameter values in a cell-array, one cell for each input AO. Leave the cell empty to plot no errors. Each error can be a value or a vector the same length as the data vector. If you give and upper limit but not lower limit, then the errors are assumed to be symmetric (and vice versa) EXAMPLES: 1) Plot two time-series AOs with different colors, line styles, and widths pl = plist('Linecolors', {'g', 'k'}, 'LineStyles', {'None', '--'}, 'LineWidths', {1, 4}); iplot(tsao1, tsao2, pl); 2) Plot two time-series AOs in subplots. Also override the second legend text and the first line style. pl = plist('Arrangement', 'subplots', 'LineStyles', {'--'}, 'Legends', {'', 'My Sine Wave'}); iplot(tsao1, tsao2, pl); 3) Plot two frequency-series AOs on subplots with the same Y-scales and Y-ranges pl1 = plist('Yscales', {'All', 'lin'}); pl2 = plist('arrangement', 'subplots', 'YRanges', {'All', [1e-6 100]}); iplot(fsd1, fsd2, pl1, pl2) Parameters Description VERSION: $Id: iplot.m,v 1.144 2012/01/11 15:49:53 mauro Exp $ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Method Details | |
---|---|
Access | public |
Defining Class | ao |
Sealed | 0 |
Static | 0 |
Sets for this method … |
---|
Time-series Plot |
Frequency-series Plot |
Y Data Plot |
X-Y Data Plot |
3D Plot |
Time-series Plot |
|||
---|---|---|---|
no description | |||
Key | Default Value | Options | Description |
FIGURE | [] | none | The handle of the figure to plot in to. This will be ignored if the AOs to plot are inconsistent, containing different class of data (such as tsdata and fsdata), or if the 'arrangement' parameter is passed as 'single'. |
COLORS | {[0 0 1], [1 0 0], [0 1 0], [0 0 0], [0 1 1], [1 0 1], [0.56499999999999995 0.247 0.66700000000000004], [0.72199999999999998 0.41999999999999998 0.27400000000000002 ...], [0.65900000000000003 0.54100000000000004 0], [1 0.60399999999999998 0.20799999999999999], [0.502 0.502 0.502], [0.73299999999999998 0.82399999999999995 0.08200000000000000 ...], [0.318 0.55700000000000005 0.67500000000000004], [0.80000000000000004 0.20000000000000001 0.20000000000000001 ...], [0.20000000000000001 0.20000000000000001 0.80000000000000004 ...], [0.20000000000000001 0.90000000000000002 0.20000000000000001 ...], [0.37 0.90000000000000002 0.82999999999999996], [0.88800000000000001 0.16300000000000001 0.90000000000000002 ...], [0 0 0], [0 0.81176470588235294 1], [1 0.50196078431372548 0], [0.5607843137254902 0 0], [1 0.81176470588235294 0], [0.90000000000000002 0.26600000000000001 0.59299999999999997 ...]} | none | A list of colors which will be cycled through for each line in a plot. |
ARRANGEMENT | 'stacked' |
|
Select the plot layout:
|
FUNCTION | 'plot' |
|
Specify the plot function:
|
LINECOLORS | '' | none | A cell-array of color definitions, one for each trace. Give an empty string to use the default color. |
LINESTYLES | '' | none | A cell-array of line styles, one for each trace. Give an empty string to use the default style. |
MARKERS | '' | none | A cell-array of markers, one for each trace. |
LINEWIDTHS | '' | none | A cell-array of line widths, one for each trace. Give an empty string to use the default line width. |
LEGENDS | '' | none | Give a cell-array of strings to be used for the plot legends. If a cell contains an empty string, the default legend string is built. If a single string 'off' is given instead of a cell-array, then the legends are all switched off. |
LEGENDLOCATION | 'NorthEast' |
|
Choose the legend location. |
LEGENDFONTSIZE | 14 | none | Choose the legend font size. |
XERRL | [] | none | Lower bound error values for the X data points. |
XERRU | [] | none | Upper bound error values for the X data points. |
YERRL | [] | none | Lower bound error values for the Y data points. |
YERRU | [] | none | Upper bound error values for the Y data points. |
XSCALES | '' | none | A cell-array specifying the scale to be used on each x-axis. For example, {'lin', 'log'} |
YSCALES | '' | none | A cell-array specifying the scale to be used on each y-axis. For example, {'lin', 'log'} |
XRANGES | '' | none | A cell-array specifying the ranges to be displayed on each x-axis. For example, {[0 1], [-4 4]}. |
YRANGES | '' | none | A cell-array specifying the ranges to be displayed on each y-axis. For example, {[0 1], [-4 4]}. |
LATEXLABELS | 0 |
|
Use latex interpreter for axis labels. |
YMATHS | '' | none | Specify math operations to perform on the data vector 'y'. [DEPRECATED] For example, plist('Ymaths', 'sqrt(y)'). |
AUTOERRORS | 0 |
|
If the AO contains errors, they will be plotted. You can avoid plotting the errors by setting this to false. |
XLABELS | 'Time' | none | Specify the labels to be used on the x-axes. The units are added from the data object 'xunits' property. |
YLABELS | 'Amplitude' | none | Specify the labels to be used on the y-axes. The units are added from the data object 'yunits' property. |
XUNITS | 's' |
|
Specify the units of time on the x-axis as
|
Frequency-series Plot |
|||
---|---|---|---|
no description | |||
Key | Default Value | Options | Description |
FIGURE | [] | none | The handle of the figure to plot in to. This will be ignored if the AOs to plot are inconsistent, containing different class of data (such as tsdata and fsdata), or if the 'arrangement' parameter is passed as 'single'. |
COLORS | {[0 0 1], [1 0 0], [0 1 0], [0 0 0], [0 1 1], [1 0 1], [0.56499999999999995 0.247 0.66700000000000004], [0.72199999999999998 0.41999999999999998 0.27400000000000002 ...], [0.65900000000000003 0.54100000000000004 0], [1 0.60399999999999998 0.20799999999999999], [0.502 0.502 0.502], [0.73299999999999998 0.82399999999999995 0.08200000000000000 ...], [0.318 0.55700000000000005 0.67500000000000004], [0.80000000000000004 0.20000000000000001 0.20000000000000001 ...], [0.20000000000000001 0.20000000000000001 0.80000000000000004 ...], [0.20000000000000001 0.90000000000000002 0.20000000000000001 ...], [0.37 0.90000000000000002 0.82999999999999996], [0.88800000000000001 0.16300000000000001 0.90000000000000002 ...], [0 0 0], [0 0.81176470588235294 1], [1 0.50196078431372548 0], [0.5607843137254902 0 0], [1 0.81176470588235294 0], [0.90000000000000002 0.26600000000000001 0.59299999999999997 ...]} | none | A list of colors which will be cycled through for each line in a plot. |
ARRANGEMENT | 'stacked' |
|
Select the plot layout:
|
FUNCTION | 'plot' |
|
Specify the plot function:
|
LINECOLORS | '' | none | A cell-array of color definitions, one for each trace. Give an empty string to use the default color. |
LINESTYLES | '' | none | A cell-array of line styles, one for each trace. Give an empty string to use the default style. |
MARKERS | '' | none | A cell-array of markers, one for each trace. |
LINEWIDTHS | '' | none | A cell-array of line widths, one for each trace. Give an empty string to use the default line width. |
LEGENDS | '' | none | Give a cell-array of strings to be used for the plot legends. If a cell contains an empty string, the default legend string is built. If a single string 'off' is given instead of a cell-array, then the legends are all switched off. |
LEGENDLOCATION | 'NorthEast' |
|
Choose the legend location. |
LEGENDFONTSIZE | 14 | none | Choose the legend font size. |
XERRL | [] | none | Lower bound error values for the X data points. |
XERRU | [] | none | Upper bound error values for the X data points. |
YERRL | [] | none | Lower bound error values for the Y data points. |
YERRU | [] | none | Upper bound error values for the Y data points. |
XSCALES | '' | none | A cell-array specifying the scale to be used on each x-axis. For example, {'lin', 'log'} |
YSCALES | '' | none | A cell-array specifying the scale to be used on each y-axis. For example, {'lin', 'log'} |
XRANGES | '' | none | A cell-array specifying the ranges to be displayed on each x-axis. For example, {[0 1], [-4 4]}. |
YRANGES | '' | none | A cell-array specifying the ranges to be displayed on each y-axis. For example, {[0 1], [-4 4]}. |
LATEXLABELS | 0 |
|
Use latex interpreter for axis labels. |
YMATHS | '' | none | Specify math operations to perform on the data vector 'y'. [DEPRECATED] For example, plist('Ymaths', 'sqrt(y)'). |
AUTOERRORS | 0 |
|
If the AO contains errors, they will be plotted. You can avoid plotting the errors by setting this to false. |
COMPLEXPLOTTYPE | 'absdeg' |
|
Specify how to plot complex data. Choose from:
|
XLABELS | 'Frequency' | none | Specify the labels to be used on the x-axes. The units are added from the data object 'xunits' property. |
YLABELS | '' | none | Specify the labels to be used on the y-axes. The units are added from the data object 'yunits' property. |
XMATHS | '' | none | Specify math operations to perform on the data vector 'x'. [DEPRECATED] For example, plist('Xmaths', 'abs(x)'). |
Y Data Plot |
|||
---|---|---|---|
no description | |||
Key | Default Value | Options | Description |
FIGURE | [] | none | The handle of the figure to plot in to. This will be ignored if the AOs to plot are inconsistent, containing different class of data (such as tsdata and fsdata), or if the 'arrangement' parameter is passed as 'single'. |
COLORS | {[0 0 1], [1 0 0], [0 1 0], [0 0 0], [0 1 1], [1 0 1], [0.56499999999999995 0.247 0.66700000000000004], [0.72199999999999998 0.41999999999999998 0.27400000000000002 ...], [0.65900000000000003 0.54100000000000004 0], [1 0.60399999999999998 0.20799999999999999], [0.502 0.502 0.502], [0.73299999999999998 0.82399999999999995 0.08200000000000000 ...], [0.318 0.55700000000000005 0.67500000000000004], [0.80000000000000004 0.20000000000000001 0.20000000000000001 ...], [0.20000000000000001 0.20000000000000001 0.80000000000000004 ...], [0.20000000000000001 0.90000000000000002 0.20000000000000001 ...], [0.37 0.90000000000000002 0.82999999999999996], [0.88800000000000001 0.16300000000000001 0.90000000000000002 ...], [0 0 0], [0 0.81176470588235294 1], [1 0.50196078431372548 0], [0.5607843137254902 0 0], [1 0.81176470588235294 0], [0.90000000000000002 0.26600000000000001 0.59299999999999997 ...]} | none | A list of colors which will be cycled through for each line in a plot. |
ARRANGEMENT | 'stacked' |
|
Select the plot layout:
|
FUNCTION | 'plot' |
|
Specify the plot function:
|
LINECOLORS | '' | none | A cell-array of color definitions, one for each trace. Give an empty string to use the default color. |
LINESTYLES | '' | none | A cell-array of line styles, one for each trace. Give an empty string to use the default style. |
MARKERS | '' | none | A cell-array of markers, one for each trace. |
LINEWIDTHS | '' | none | A cell-array of line widths, one for each trace. Give an empty string to use the default line width. |
LEGENDS | '' | none | Give a cell-array of strings to be used for the plot legends. If a cell contains an empty string, the default legend string is built. If a single string 'off' is given instead of a cell-array, then the legends are all switched off. |
LEGENDLOCATION | 'NorthEast' |
|
Choose the legend location. |
LEGENDFONTSIZE | 14 | none | Choose the legend font size. |
XERRL | [] | none | Lower bound error values for the X data points. |
XERRU | [] | none | Upper bound error values for the X data points. |
YERRL | [] | none | Lower bound error values for the Y data points. |
YERRU | [] | none | Upper bound error values for the Y data points. |
XSCALES | '' | none | A cell-array specifying the scale to be used on each x-axis. For example, {'lin', 'log'} |
YSCALES | '' | none | A cell-array specifying the scale to be used on each y-axis. For example, {'lin', 'log'} |
XRANGES | '' | none | A cell-array specifying the ranges to be displayed on each x-axis. For example, {[0 1], [-4 4]}. |
YRANGES | '' | none | A cell-array specifying the ranges to be displayed on each y-axis. For example, {[0 1], [-4 4]}. |
LATEXLABELS | 0 |
|
Use latex interpreter for axis labels. |
YMATHS | '' | none | Specify math operations to perform on the data vector 'y'. [DEPRECATED] For example, plist('Ymaths', 'sqrt(y)'). |
AUTOERRORS | 0 |
|
If the AO contains errors, they will be plotted. You can avoid plotting the errors by setting this to false. |
XLABELS | 'Sample' | none | Specify the labels to be used on the x-axes. The units are added from the data object 'xunits' property. |
YLABELS | 'Value' | none | Specify the labels to be used on the y-axes. The units are added from the data object 'yunits' property. |
X-Y Data Plot |
|||
---|---|---|---|
no description | |||
Key | Default Value | Options | Description |
FIGURE | [] | none | The handle of the figure to plot in to. This will be ignored if the AOs to plot are inconsistent, containing different class of data (such as tsdata and fsdata), or if the 'arrangement' parameter is passed as 'single'. |
COLORS | {[0 0 1], [1 0 0], [0 1 0], [0 0 0], [0 1 1], [1 0 1], [0.56499999999999995 0.247 0.66700000000000004], [0.72199999999999998 0.41999999999999998 0.27400000000000002 ...], [0.65900000000000003 0.54100000000000004 0], [1 0.60399999999999998 0.20799999999999999], [0.502 0.502 0.502], [0.73299999999999998 0.82399999999999995 0.08200000000000000 ...], [0.318 0.55700000000000005 0.67500000000000004], [0.80000000000000004 0.20000000000000001 0.20000000000000001 ...], [0.20000000000000001 0.20000000000000001 0.80000000000000004 ...], [0.20000000000000001 0.90000000000000002 0.20000000000000001 ...], [0.37 0.90000000000000002 0.82999999999999996], [0.88800000000000001 0.16300000000000001 0.90000000000000002 ...], [0 0 0], [0 0.81176470588235294 1], [1 0.50196078431372548 0], [0.5607843137254902 0 0], [1 0.81176470588235294 0], [0.90000000000000002 0.26600000000000001 0.59299999999999997 ...]} | none | A list of colors which will be cycled through for each line in a plot. |
ARRANGEMENT | 'stacked' |
|
Select the plot layout:
|
FUNCTION | 'plot' |
|
Specify the plot function:
|
LINECOLORS | '' | none | A cell-array of color definitions, one for each trace. Give an empty string to use the default color. |
LINESTYLES | '' | none | A cell-array of line styles, one for each trace. Give an empty string to use the default style. |
MARKERS | '' | none | A cell-array of markers, one for each trace. |
LINEWIDTHS | '' | none | A cell-array of line widths, one for each trace. Give an empty string to use the default line width. |
LEGENDS | '' | none | Give a cell-array of strings to be used for the plot legends. If a cell contains an empty string, the default legend string is built. If a single string 'off' is given instead of a cell-array, then the legends are all switched off. |
LEGENDLOCATION | 'NorthEast' |
|
Choose the legend location. |
LEGENDFONTSIZE | 14 | none | Choose the legend font size. |
XERRL | [] | none | Lower bound error values for the X data points. |
XERRU | [] | none | Upper bound error values for the X data points. |
YERRL | [] | none | Lower bound error values for the Y data points. |
YERRU | [] | none | Upper bound error values for the Y data points. |
XSCALES | '' | none | A cell-array specifying the scale to be used on each x-axis. For example, {'lin', 'log'} |
YSCALES | '' | none | A cell-array specifying the scale to be used on each y-axis. For example, {'lin', 'log'} |
XRANGES | '' | none | A cell-array specifying the ranges to be displayed on each x-axis. For example, {[0 1], [-4 4]}. |
YRANGES | '' | none | A cell-array specifying the ranges to be displayed on each y-axis. For example, {[0 1], [-4 4]}. |
LATEXLABELS | 0 |
|
Use latex interpreter for axis labels. |
YMATHS | '' | none | Specify math operations to perform on the data vector 'y'. [DEPRECATED] For example, plist('Ymaths', 'sqrt(y)'). |
AUTOERRORS | 0 |
|
If the AO contains errors, they will be plotted. You can avoid plotting the errors by setting this to false. |
XLABELS | 'X-data' | none | Specify the labels to be used on the x-axes. The units are added from the data object 'xunits' property. |
YLABELS | 'Y-data' | none | Specify the labels to be used on the y-axes. The units are added from the data object 'yunits' property. |
XMATHS | '' | none | Specify math operations to perform on the data vector 'x'. [DEPRECATED] For example, plist('Xmaths', 'abs(x)'). |
3D Plot |
|||
---|---|---|---|
no description | |||
Key | Default Value | Options | Description |
FIGURE | [] | none | The handle of the figure to plot in to. This will be ignored if the AOs to plot are inconsistent, containing different class of data (such as tsdata and fsdata), or if the 'arrangement' parameter is passed as 'single'. |
COLORS | {[0 0 1], [1 0 0], [0 1 0], [0 0 0], [0 1 1], [1 0 1], [0.56499999999999995 0.247 0.66700000000000004], [0.72199999999999998 0.41999999999999998 0.27400000000000002 ...], [0.65900000000000003 0.54100000000000004 0], [1 0.60399999999999998 0.20799999999999999], [0.502 0.502 0.502], [0.73299999999999998 0.82399999999999995 0.08200000000000000 ...], [0.318 0.55700000000000005 0.67500000000000004], [0.80000000000000004 0.20000000000000001 0.20000000000000001 ...], [0.20000000000000001 0.20000000000000001 0.80000000000000004 ...], [0.20000000000000001 0.90000000000000002 0.20000000000000001 ...], [0.37 0.90000000000000002 0.82999999999999996], [0.88800000000000001 0.16300000000000001 0.90000000000000002 ...], [0 0 0], [0 0.81176470588235294 1], [1 0.50196078431372548 0], [0.5607843137254902 0 0], [1 0.81176470588235294 0], [0.90000000000000002 0.26600000000000001 0.59299999999999997 ...]} | none | A list of colors which will be cycled through for each line in a plot. |
ARRANGEMENT | 'single' | none | Select the plot layout:
|
FUNCTION | 'plot' |
|
Specify the plot function:
|
LEGENDS | '' | none | Give a cell-array of strings to be used for the plot legends. If a cell contains an empty string, the default legend string is built. If a single string 'off' is given instead of a cell-array, then the legends are all switched off. |
LEGENDLOCATION | 'NorthEast' |
|
Choose the legend location. |
LEGENDFONTSIZE | 14 | none | Choose the legend font size. |
XERRL | [] | none | Lower bound error values for the X data points. |
XERRU | [] | none | Upper bound error values for the X data points. |
YERRL | [] | none | Lower bound error values for the Y data points. |
YERRU | [] | none | Upper bound error values for the Y data points. |
XSCALES | '' | none | A cell-array specifying the scale to be used on each x-axis. For example, {'lin', 'log'} |
YSCALES | '' | none | A cell-array specifying the scale to be used on each y-axis. For example, {'lin', 'log'} |
XRANGES | '' | none | A cell-array specifying the ranges to be displayed on each x-axis. For example, {[0 1], [-4 4]}. |
YRANGES | '' | none | A cell-array specifying the ranges to be displayed on each y-axis. For example, {[0 1], [-4 4]}. |
LATEXLABELS | 0 |
|
Use latex interpreter for axis labels. |
YMATHS | '' | none | Specify math operations to perform on the data vector 'y'. [DEPRECATED] For example, plist('Ymaths', 'sqrt(y)'). |
AUTOERRORS | 0 |
|
If the AO contains errors, they will be plotted. You can avoid plotting the errors by setting this to false. |
XLABELS | 'Time' | none | Specify the labels to be used on the x-axes. The units are added from the data object 'xunits' property. |
YLABELS | 'Frequency' | none | Specify the labels to be used on the y-axes. The units are added from the data object 'yunits' property. |
ZLABELS | 'Amplitude' | none | Specify the labels to be used on the z-axes. The units are added from the data object 'zunits' property. |
XMATHS | '' | none | Specify math operations to perform on the data vector 'x'. [DEPRECATED] For example, plist('Xmaths', 'abs(x)'). |
ZMATHS | '' | none | Specify math operations to perform on the data vector 'z'. [DEPRECATED] For example, plist('Zmaths', 'abs(z)'). |
ZSCALES | '' | none | A cell-array specifying the scale to be used on each z-axis. For example, {'lin', 'log'} |
ZRANGES | '' | none | A cell-array specifying the ranges to be displayed on each z-axis. For example, {[0 1], [-4 4]}. |
INVERTY | 1 |
|
Invert the y-axis or not. |
Some information of the method ao/iplot are listed below: | |
---|---|
Class name | ao |
Method name | iplot |
Category | Output |
CVS Version | $Id: iplot.m,v 1.144 2012/01/11 15:49:53 mauro Exp $ |
Min input args | 1 |
Max input args | -1 |
Min output args | 0 |
Max output args | -1 |
![]() |
Method: ao/gnuplot | Method: ao/report | ![]() |
©LTP Team