Bases: decida.PlotBase.PlotBase
plot y vector(s) versus x vector.
synopsis:
XYplotx plots one or more y_vs_x curves. The curves are specified by the command argument to the XYplotx instance call. The command specifies a list of pairs of Data object instances, and string of data-column names to plot. Curves attributes: color, symbol symbol-size and line-width can be changed after the plot has been created. Log/Lin axes check-boxes toggle the axes between logarithmic and linear. The plots can be annotated with lines, arrows, rectangles, and/or text.
constructor arguments:
- parent (Tkinter handle) (default=None)
handle of frame or other widget to pack plot in. if this is not specified, top-level is created.
- **kwargs (dict)
keyword=value specifications: options or configuration-options
options:
- command
list of pairs of data-object, string of x, y1, ?y2, ...? columns
- example: [d1, “x y1 y2”, d2, “x y1 y2”]:
- x, y1 and x, y2 curves will be plotted for each data object d1 and d2. Each curve will also be plotted with color, symbol, symbol-size, line-width, and trace-direction selected from the successive item in the respective list of specified configured options: colors, symbols, ssizes, wlines, traces. Selection wraps around if the respective list is shorter than the number of curves.
configuration options:
- verbose (bool, default=False)
enable/disable verbose mode
- title (str, default="")
main title
- xtitle (str, default="")
x-axis title
- ytitle (str, default="")
y-axis title
- plot_height (str, default="10i" for MacOS, else "6i")
Height of plot window (Tk inch or pixelspecification)
- plot_width (str, default="10i" for MacOS, else "6i")
Width of plot window (Tk inch or pixel specification)
- plot_background (str, default="GhostWhite")
Background color of plot window
- legend_background (str, default="AntiqueWhite2")
Background color of legend
- colors (list of str, default =
- "blue", "red", "green", "orange", "cyan",
- "brown", "black", "blue violet", "cadet blue",
- "dark cyan", "dark goldenrod", "dark green",
- "dark magenta", "dark olive green", "dark orange",
- "dark red", "dark slate blue", "dark slate gray",
- "dodger blue", "forest green", "steel blue", "sienna"
- )
list of colors for curves. Used to populate color menu, and to specify curve colors in scripted “command” option.
- symbols (list of str, default =
- "none", "dot", "square", "diamond",
- "triangle", "itriangle",
- "dash", "pipe", "plus", "cross",
- "spade", "heart", "diam", "club", "shamrock",
- "fleurdelis", "circle", "star"
- )
list of symbols for curves. Used to populate symbol menu, and to specify curve symbols in scripted “command” option.
- ssizes (list of floats, default = [0.01])
list of symbol sizes for curves. Used to specify curve symbol sizes in scripted “command” option.
- wlines (list of ints, default = [1])
list of line widths for curves. Used to specify curve line widths in scripted “command” option.
- traces (list, default = ["increasing"])
list of traces for curves. each trace can be one of: “increasing”, “decreasing”, or “both”. Used to specify curve trace directions in scripted “command” option.
- xaxis (str, default="lin")
linear or logarithmic axis: “lin” or “log”
- yaxis (str, default="lin")
linear or logarithmic axis: “lin” or “log”
- xmin (float, default=0.0)
xaxis minimum
- xmax (float, default=0.0)
xaxis maximum
- ymin (float, default=0.0)
yaxis minimum
- ymax (float, default=0.0)
yaxis maximum
- grid (bool, default=True)
if true, show grid on plot
- legend (bool, default=True)
if true, show legend on plot
- postscript (bool, default=False)
if true, generate a PostScript file.
- postscript_file (str, default="plot.ps")
name of PostScript file to plot to
- wait (bool, default=False)
wait in main-loop until window is destroyed.
- destroy (bool, default=False)
destroy main window after it has been displayed. useful for displaying, generating PostScript, then destroying window.
example (from test_XYplotx_6):
from decida.Data import Data
from decida.XYplotx import XYplotx
d = Data()
d.read("LTspice_ac_ascii.raw")
xyplot=XYplotx(None, command=[d, "frequency DB(V(vout1)) PH(V(vout1)) DB(V(vout2)) PH(V(vout2)) DB(V(vout3)) PH(V(vout3))"], title="AC analysis", xaxis="log", ymin=-60.0, ymax=0.0)
public methods:
- public methods from PlotBase (2-dimensinal plot base class)
- public methods from ItclObjectx