home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / NEXTSTEP / UNIX / Educational / R-0.49-MI / R-0.49-I / help / base / boxplot < prev    next >
Encoding:
Text File  |  1997-04-23  |  3.3 KB  |  87 lines
  1.     
  2.     _B_o_x _P_l_o_t_s
  3.     
  4.          boxplot(..., range=1.5, width, varwidth=FALSE,
  5.                  notch=FALSE, names, data, plot=TRUE, col=NULL,
  6.                  border=par("fg"))
  7.     
  8.     _A_r_g_u_m_e_n_t_s:
  9.     
  10.              ... : the data from which the boxplots are to be
  11.                    produced.  The data can be specified as
  12.                    separate vectors, each corresponding to a
  13.                    component boxplot, or as a single list con-
  14.                    taining such vectors.  Alternatively a sym-
  15.                    bolic specification of the form x ~ g can be
  16.                    given, indicating the the observations in the
  17.                    vector x are to be grouped according to the
  18.                    levels of the factor g.  In this case the
  19.                    argument data can be used to provide values
  20.                    for the variables in the specification.  NAs
  21.                    are allowed in the data.
  22.     
  23.            range : this determines how far the plot whiskers
  24.                    extend out from the box.  If range is posi-
  25.                    tive, the whiskers extend to the most extreme
  26.                    data point which is no more than range times
  27.                    the interquartile range from the box.  A
  28.                    value of zero causes the whiskers to extend
  29.                    to the data extremes.
  30.     
  31.            width : a vector giving the relative widths of the
  32.                    boxes making up the plot.
  33.     
  34.         varwidth : if varwidth is TRUE, the boxes are drawn with
  35.                    widths proportional to the square-roots of
  36.                    the number of observations in the groups.
  37.     
  38.            notch : if notch is TRUE, a notch is drawn in each
  39.                    side of the boxes.  If the notches of two
  40.                    plots do not overlap then the medians are
  41.                    significantly different at the 5 percent
  42.                    level.
  43.     
  44.             name : group labels which while be printed under
  45.                    each boxplot.
  46.     
  47.             plot : if plot is TRUE (the default) then a boxplot
  48.                    is produced.  If not, the summaries which the
  49.                    boxplots are based on are returned.
  50.     
  51.           border : an optional vector of colors for the outlines
  52.                    of the boxplots.  The values in border are
  53.                    recycled if the length of border is less than
  54.                    the number of plots.
  55.     
  56.              col : if col is non-null it is assumed to contain
  57.                    colors to be used to col the bodies of the
  58.                    box plots.
  59.     
  60.              ... : graphical parameters can also be passed as
  61.                    arguments to boxplot.
  62.     
  63.     _V_a_l_u_e_s:
  64.     
  65.          This function is usually invoked for its side effect
  66.          which is to produce box-and-whisker plots of the given
  67.          values.  However, it also returns a list with one com-
  68.          ponent corresponding to each plot.  The components are
  69.          themselves lists with named components as follows:
  70.     
  71.       stats : a vector containing the extreme of the lower
  72.               whisker, the lower hinge, the median, the upper
  73.               hinge and the extreme of the upper whisker.
  74.     
  75.           n : the number of observations in the sample.
  76.     
  77.        conf : the lower and upper extremes of the notch.
  78.     
  79.         out : the values of any data points which lie beyond the
  80.               extremes of the whiskers.
  81.     
  82.     _E_x_a_m_p_l_e_s:
  83.     
  84.          data(insects)
  85.          boxplot(count~spray, data=insects, col="lightgray")
  86.     
  87.