

bxp {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 `box-
     plot(..)', but can be invoked directly.

_U_s_a_g_e_:

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

_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 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(`...').

_V_a_l_u_e_:

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

_E_x_a_m_p_l_e_s_:

     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)

