Next: guifilepath() Up: Graphical Interface Help File Previous: guianova()   Contents

guiboxplot()

Usage:
guiboxplot() does boxplots via dialogs



Keywords:
guiboxplot brings up a dialog box to collect information that
will be used to construct a boxplot 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
boxplot without any bells and whistles.  At the bottom of the
panel, you choose the variable or variables to appear in the 
boxplot.  If you choose multiple vector variables, each variable 
will determine one box.  If you choose a matix variable, each 
column will determine one box.  At the top of the panel, you can
choose a "split-by" variable.  If you have chosen a single vector
variable at the bottom of the panel, you can choose a "split-by"
variable to divide the single variable into groups.  This split-by
variable must have the same number of elements as the plotted
variable, and a separate box will be constructed for each unique
value of the split-by variable, with elements of the response
variable divided according to their corresonding split value.  
See split(). You must type the name of the split variable (or an
expression that computes an appropriate split variable) into the
dialog element.

The remainder of the elements on the Basic tab control how the
boxplots look.  You can choose vertical (default) or horizontal
boxes.  You can choose to show outliers (default) or to simply
have the whiskers extend to the extremes.  If you show the outliers,
you can control the symbols used to display them.  You may also
enter variables or expressions to control the location and width
of the boxes.  The location expression should evaluate to a real
vector with length equal to the number of boxes.  The width
expression can be a real scalar or a vector with length equal to
the number of boxes.  

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 you know the MacAnova commands, you may type in your options
directly on the "Direct Options" tab.


Gary Oehlert 2006-01-30