Next: guilistxml() Up: Graphical Interface Help File Previous: guihelp()   Contents

guihist()

Usage:
guihist()



Keywords:
guihist brings up a dialog box to collect information that
will be used to construct a histogram command.  The dialog is a
"tabbed" dialog, meaning that the information is collected on
multiple panels that the user accesses via tabs.

The "Basic" tab collects the standard information for a basic
histogram without any bells and whistles.  At the bottom of the
panel, you choose the variable to appear in the histogram.  

The elements at the top of the Basic tab control how the
histogram looks.  On the left, you can choose between density
(default) or frequency or relative frequency histograms.  On
the right, you set the bins.  You may let MacAnova choose the
bins, or you can choose the number of bins and let MacAnova
choose their locations.  The two remaining options allow you
to specify the bin locations.  The anchor/width specification
will produce adjacent bins with your chosen width, with one
bin edge placed at the anchor point.  Both the anchor and the
width must be numeric values.  The final choice is to enter
an expression that will evaluate to a vector of bin edges.
It is usually an error to have data outside the bins, but you
may choose to let that happen by checking the "Data outside bins"
box.  Finally, you choose the endpoint convention.  By default,
the right hand endpoint is in the interval, but you may choose
to have the left hand endpoint in the interval by choosing that
option.

The "Appearance" tab collects information that affects the overall
appearance of the plot.  First, you can choose that the plot appear
in a new window (default), or you can choose the number of the
graph window where you would like it to appear. A window number of
0 indicates the most recently used graph window. Next, you can set
the width and height of the plot.  On the screen, these are in
units of pixels.  When printing using PostScript, these are in
units of points (approximately 1/72 of an inch).  

The second major set of choices are for labels.  You can add a title
and/or labels for the vertical and horizontal axes.

Finally, you can set where the border box and axis ticks will be
drawn.  By default, ticks and borders are drawn on all four sides.

The "Axes" tab allows you to control the appearance of the axes.
First, you can choose to have a logarithmic scale by clicking the
check box.  Next, you may specify your own minimum and maximum values
in each direction. Third, you may decide whether the x=0 or y=0 lines
are drawn on the plot.  Finally, you may set the appearance of the
ticks and labels.  Tick locations should be either a variable name
or an expression that evaluates to a vector of real values.  If
this is NULL, no ticks will be drawn.  Tick labels should be character
vectors with the same number of elements as the tick locations.
Finally, tick lengths should be real scalars >= -1.  Values less than
0 are outside the frame; values greater than zero are inside the
frame.  Values greater than 2 draw a grid all the way across the
plot.  The default value is -.5.

If know the MacAnova commands, you may type in your options
directly on the "Direct Options" tab.


Gary Oehlert 2005-08-12