

   BBooxx PPlloottss ffrroomm SSuummmmaarriieess

        bxp(z, notch = FALSE, width = NULL, varwidth = FALSE, notch.frac = 0.5,
            border = par("fg"), col = NULL, log = "", pars = NULL, ...)

   AArrgguummeennttss::

          z: a list containing data summaries to be used in
             constructing the plots.  These are usually the
             result of a call to `boxplot', but can be gener-
             ated in any fashion.

      notch: if `notch' is `TRUE', a notch is drawn in each
             side of the boxes.  If the notches of two plots do
             not overlap then the medians are significantly
             different at the 5 percent level.

      width: a vector giving the relative widths of the boxes
             making up the plot.

   varwidth: if `varwidth' is `TRUE', the boxes are drawn with
             widths proportional to the square-roots of the
             number of observations in the groups.

   notch.frac: numeric in (0,1). When `notch=TRUE', the frac-
             tion of the box width that the notches should use.

     border: character, the color of the box borders. Is recy-
             cled for multiple boxes.

        col: character; the color within the box. Is recycled
             for multiple boxes

        log: character, indicating if any axis should be drawn
             in logarithmic scale, as in `plot.default'.

   pars,...: Graphical parameters can be passed as arguments to
             this function, either as a list (`pars') or nor-
             mally(`...').

   DDeessccrriippttiioonn::

        `bxp(..)' draws box plots based on the given summaries
        in `z'.  It is usually called from within `box-
        plot(..)', but can be invoked directly.

   VVaalluuee::

        An invisible vector with the x-coordinates of box cen-
        ters, useful for adding to the plot.

   EExxaammpplleess::

        str(bx.p <- boxplot(split(rnorm(100), gl(5,20)), plot = FALSE))
        op <- par(mfrow= c(2,2))
        bxp(bx.p)
        bxp(bx.p, notch = TRUE)
        bxp(bx.p, notch = TRUE, col= 'lightblue')
        bxp(bx.p, notch = TRUE, col= 'lightblue', border='red', log = 'x')
        par(op)

