bpplot                 package:Hmisc                 R Documentation

_B_o_x-_p_e_r_c_e_n_t_i_l_e _p_l_o_t_s

_D_e_s_c_r_i_p_t_i_o_n:

     Producess side-by-side box-percentile plots from several vectors
     or a list of vectors.

_U_s_a_g_e:

     bpplot(..., name=TRUE, main="Box-Percentile Plot", 
            xlab="", ylab="", srtx=0)

_A_r_g_u_m_e_n_t_s:

     ...: vectors or lists containing  numeric components (e.g., the
          output of 'split'). 

    name: character vector of names for the groups.   Default is 'TRUE'
          to put names on the x-axis.  Such names are taken from the 
          data vectors or the 'names' attribute of the first argument
          if it is a list. Set 'name' to 'FALSE' to suppress names. If
          a character vector is supplied the names in the vector are
          used to label the groups. 

    main: main title for the plot. 

    xlab: x axis label. 

    ylab: y axis label. 

    srtx: rotation angle for x-axis labels.  Default is zero. 

_V_a_l_u_e:

     There are no returned values

_S_i_d_e _E_f_f_e_c_t_s:

     A plot is created on the current graphics device.

_B_A_C_K_G_R_O_U_N_D:

     Box-percentile plots are similiar to boxplots, except
     box-percentile plots supply more information about the univariate
     distributions.  At any height the width of the irregular "box" is
     proportional to the percentile of that height, up to the 50th
     percentile, and above the 50th percentile the width is
     proportional to 100 minus the percentile.  Thus, the width at any
     given height is proportional to the percent of observations that
     are more  extreme in that direction.  As in boxplots, the median,
     25th and 75th  percentiles are marked with line segments across
     the box.

_A_u_t_h_o_r(_s):

     Jeffrey Banfield 
      umsfjban@bill.oscs.montana.edu 
      Modified by F. Harrell 30Jun97

_R_e_f_e_r_e_n_c_e_s:

     Esty, W. W. and Banfield, J. D. (1992) "The Box-Percentile Plot,"
     Technical Report (May 15, 1992), Department of Mathematical
     Sciences, Montana State University.

_S_e_e _A_l_s_o:

     'panel.bpplot', 'boxplot', 'ecdf', 'bwplot'

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

     set.seed(1)
     x1 <- rnorm(500)
     x2 <- runif(500, -2, 2)
     x3 <- abs(rnorm(500))-2
     bpplot(x1, x2, x3)
     g <- sample(1:2, 500, replace=TRUE)
     bpplot(split(x2, g), name=c('Group 1','Group 2'))
     rm(x1,x2,x3,g)

