awvPlotList
awvPlotList(
w_windowID
l_yListList
l_xList
[ ?expr l_exprList ]
[ ?index l_waveIndexList ]
[ ?color l_colorList ]
[ ?lineType l_lineTypeList ]
[ ?lineStyle l_lineStyleList ]
[ ?lineThickness l_lineThicknessList ]
[ ?showSymbols l_showList ]
[ ?dataSymbol l_symbolList ]
[ ?barBase t_barBase ]
[ ?barWidth t_barWidth ]
[ ?barShift t_barShift ]
[ ?subwindow x_subwindow ]
[ ?yNumber l_yNumberList ]
[ ?stripNumber l_stripNumberList ]
)
=> t / nil
Description
Plots the y-axis values specified in l_yListList against the x-axis values specified in l_xList and displays the resulting waveforms in a subwindow.
Arguments
|
w_windowID
|
Waveform window ID.
|
|
l_yListList
|
A list of lists that specifies y-axis values. Each list must have the same number of items.
|
|
l_xList
|
A list that specifies x-axis values. Number of items in this list must be equal to the number of items in each list specified by l_yListList.
|
|
?expr l_exprList
|
|
|
List of waveform names to be displayed in the trace legend.
|
|
?index l_waveIndexList
|
|
|
List of index numbers identifying the waveforms.
If you do not specify index numbers for the waveforms in l_waveIndexList, the lowest unused numbers in the subwindow are assigned.
|
|
?color l_colorList
|
|
|
List of colors for the waveforms. Available colors are defined in your technology file. Valid values are from y1 through y66.
If you do not specify this argument, default colors are used.
|
|
?lineType l_lineTypeList
|
|
|
List specifying the type of line to be used for the waveforms.
Valid values are line, bar, scatterPlot, poleZero.
If you do not specify this argument, default value line is used.
|
|
?lineStyle l_lineStyleList
|
|
|
List specifying the line style to used for the waveforms.
Valid values are solid, dash, dot, dashDot, and dashDotDot.
If you do not specify this argument, default value solid is used.
|
|
?lineThickness l_lineThicknessList
|
|
|
List specifying the line thickness of the waveforms.
Valid values are fine, medium, thick, and extraThick.
If you do not specify this argument, default value fine is used.
|
|
?showSymbols l_showList
|
|
|
List of flags that specify whether to show the symbols on the waveforms. Valid values are t and nil.
The default value is nil, which means that symbols are not displayed on the waveforms.
The number of flags in the l_showList must match the number of symbols in the l_symbolList.
|
|
?dataSymbol l_symbolList
|
|
|
List of symbols to be displayed for data points on the waveforms.
To use a symbol, specify an integer or a single character corresponding to the symbol.
|
|
?barBase t_barBase
|
|
|
Base of the bar.
|
|
?barWidth t_barWidth
|
|
|
Width of the bar.
This argument takes integer values. The default value is 1.
|
|
?barShift t_barShift
|
|
|
Specifies whether to shift the bar ahead or backwards when the ?lineType argument is set to bar. This argument takes integer values.
Positive integer shifts the bar backwards and negative integer shifts the bar forward.
The default value is 0, which indicates that bar is not shifted.
|
|
?subwindow x_subwindow
|
|
|
Identification number of the subwindow, which is found in the top-right corner of the subwindow.
If you do not specify this argument, the current subwindow is used.
|
|
?yNumber l_yNumberList
|
|
|
List of integers identifying the y axis. Valid values are from 1 through 4.
|
|
?stripNumber l_stripNumberList
|
|
|
List of integers identifying the strips.
|
Value Returned
|
t
|
Specified y-axis values are plotted against the specified x-axis values and the corresponding waveforms are displayed in the specified window.
|
|
nil
|
Waveforms cannot be plotted because of an error.
|
Examples
The following example creates a Waveform window and returns the ID of the window.
awvCreatePlotWindow()
=> window:3
The following example plots the y-axis values (1, 2, 3) and (2, 3, 4) against the x-axis values (1, 2, 3) as waveforms with names expr1 and expr2. The waveforms expr1 and expr2 are identified with the index numbers 1 and 2, respectively.
awvPlotList(window(3) list(list(1 2 3) list(2 3 4)) list(1 2 3) ?expr list("expr1" "expr2") ?index list(1 2) ?color list("y1" "y66") ?lineType list("line" "line") ?lineStyle list("dashDotDot" "solid") ?lineThickness list("extraThick" "fine") ?showSymbols list(t t) ?dataSymbol list(4 5))
=> t
Note that expr1 uses a symbol corresponding to integer 4, which is a circle. expr2 uses a symbol corresponding to integer 5, which is a square.
Return to top
