Table of Contents


NAME

data:histogram - plot a histogram (Decida Procedure)

USAGE

          data:histogram d args

ARGUMENTS

d data object with columns to be plotted.
args x column label(s) to be plotted, or OPTIONS.

OPTIONS

-frame <frame-name> Name of frame widget to pack plot window in. Can also be ".". If this is not specified, top-level is created.
-binsize <value> Size of bin for histogram. Default is approximately 1/50 of the limits of the first specified column.
-binorigin <value> Origin of bins for histogram. Default is approximately the minimum of the first specified column.
-title <title> Title of plot.
-xtitle <label> X-axis label.
-ytitle <label> Y-axis label.
-colors <list> List of colors for color menu.
-nextdata <data name> Change to new data object, for column names.
-post <file> PostScript plot file is written.
-noview Don't display plot.
-show <0,1> Display plot if 1.
-big Configure for big fonts (for tiled postcript).
-backcolor <color> Set background color of plot
-forecolor <color> Set background color of area surrounding plot
-hardcopy Change background colors to white and set relief to flat
* Other options are interpreted as columns to be plotted.

GLOBALS

env(DISP_MODE) = (XWINDOW|TERMINAL|BATCH) Display mode.
env(DecidaPlotWait) if YES|yes, then wait for single plot to be closed before returning
env(DecidaPlotWindow) if non-null, {.*} place plot in named window so it can be packed
DecidaPlot Registry of plots, and plot information.
psfont PostScript font mapping array (defined in init.tcl)

RESULTS

histogram megawidget is displayed.

EXAMPLE-CALL

             data d
             d read-inline {{X 1.5 2.2 3.2 4.1 .2 5 .2 3.2}}
             d histogram X -binsize .2

MOUSE

button 1: zoom-in Pressing down button 1 starts a zoom-in operation. Holding button 1 down and moving to new location displays a zoom-in box with endpoints at original location and current location. Releasing button 1 changes axes limits of graph to those of the zoom-in box.
button 2: restore Pressing down button 2 returns axes limits to the original ones.
button 3: statistics report Pressing down button 3 starts a limiting operation for statistics. Holding down, moving, then releasing define the limits of the defined region. After release, a report of the statistics of the columns which are within the region is generated.

EXAMPLE-STATISTICS-REPORT

            Vfb:
                   limited:           entire:
              avg:  -0.8251            -0.8251
              std:  0.0197501          0.0197452
              var:  0.000390068        0.000389872
              pts:  2000               2000
              min:  -0.916061          -0.898109
              max:  3.29741            -0.751243

AUTHORS

Richard Booth, Michael McLennan, George Howlett

Table of Contents