Bases: decida.PlotBase.PlotBase
plot histogram of vector values.
synopsis:
Histogramx plots a histogram of counts of a 1-dimensional array of values. For each data value, if it is within the range of a particular histogram bin, that bin’s count is incremented. The set of histogram bins are specified by configuration options, but can be changed by using the Edit->Settings dialog.
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, ?x1, x2, ...? columns
- example: [d1, “x x1 x2”, d2, “x x1 x2”]:
- x, x1, and x2 histograms will be plotted for each data object d1 and d2. Each histogram will also be plotted with color selected from the successive item in the list of specified colors configuration option. 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
- nbins (int, default=21)
number of histogram bins between binorigin and nbins*binsize.
- binsize (float, default=1.0)
size of each histogram bin.
- binorigin (float, default=0.0)
minimum of histogram bins.
- bar_width (float, default=1.0)
width of each histogram bar.
- bar_outline (str, default="black")
color or each histogram bar.
- 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_Histogramx_1):
from decida.Data import Data
from decida.Histogramx import Histogramx
d = Data()
d.read("smartspice_tr_binary.raw")
h=Histogramx(None, command=[d, "v(cint)"], nbins=51)
public methods:
- public methods from PlotBase (2-dimensinal plot base class)