bxp                   package:base                   R Documentation

_B_o_x _P_l_o_t_s _f_r_o_m _S_u_m_m_a_r_i_e_s

_D_e_s_c_r_i_p_t_i_o_n:

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

_U_s_a_g_e:

     bxp(z, notch = FALSE, width = NULL, varwidth = FALSE, notch.frac = 0.5,
         boxwex = 0.8, border = par("fg"), col = NULL, log = "",
         pars = NULL, frame.plot = axes, horizontal = FALSE, add = FALSE, ...)

_A_r_g_u_m_e_n_t_s:

       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 generated 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.

  boxwex: a scale factor to be applied to all boxes.  When there are
          only a few groups, the appearance of the plot can be improved
          by making the boxes narrower.

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

  border: character, the color of the box borders. Is recycled 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'.

frame.plot: logical, indicating if a ``frame'' (`box()') should be
          drawn; defaults to `TRUE', unless `axes = FALSE' is
          specified.

horizontal: logical indicating if the  boxplots should be horizontal;
          default `FALSE' means vertical boxes.

     add: logical, if true add boxplot to current plot.

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

_V_a_l_u_e:

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

_E_x_a_m_p_l_e_s:

     str(bx.p <- boxplot(split(rnorm(100), gl(5,20))))
     op <- par(mfrow= c(2,2))
     bxp(bx.p, xaxt = "n")
     bxp(bx.p, notch = TRUE, axes = FALSE)
     bxp(bx.p, notch = TRUE, col= 'lightblue', frame = FALSE)
     bxp(bx.p, notch = TRUE, col= 'lightblue', border='red',
         log = "x", ylim = c(-1,4), main = "bxp(*, log='x', ylim=*)")
     par(op)

