XYplotx

_images/XYplotx.jpg
class decida.XYplotx.XYplotx(parent=None, **kwargs)

Bases: decida.PlotBase.PlotBase

synopsis:

Plot y vector(s) versus x vector.

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 specified, or 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)

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 float, default = [0.01])

list of symbol sizes for curves. Used to specify curve symbol sizes in scripted “command” option.

wlines (list of int, 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