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 / dotplot < prev    next >
Encoding:
Text File  |  1997-04-23  |  2.0 KB  |  62 lines
  1.     
  2.     _C_l_e_v_e_l_a_n_d _D_o_t_c_h_a_r_t_s
  3.     
  4.          dotplot(x, labels=NULL, groups=NULL, gdata=NULL,
  5.                  color, gcolor, pch=11, gpch=11, cex, ...)
  6.     
  7.     _A_r_g_u_m_e_n_t_s:
  8.     
  9.                x : either a vector or matrix of numeric values
  10.                    (NAs are allowed).  If x is a matrix the
  11.                    overall plot consists of juxtaposed dotplots
  12.                    for each row.
  13.     
  14.           labels : a vector of labels for each point.  For vec-
  15.                    tors the default is to use names(x) and for
  16.                    matrices the row labels dimnames(x)[[1]].
  17.     
  18.            group : an optional factor indicating how the ele-
  19.                    ments of x are grouped.  If x is a matrix,
  20.                    the groups will default to the columns of x.
  21.     
  22.            gdata : data values for the groups.  This is typi-
  23.                    cally a summary such as the median or mean of
  24.                    each group.
  25.     
  26.            color : the color to be used for points an labels.
  27.     
  28.           gcolor : the color to be used for group labels and
  29.                    values.
  30.     
  31.              pch : the plotting character or symbol to be used.
  32.     
  33.             gpch : the plotting character or symbol to be usea
  34.                    for group values.
  35.     
  36.              cex : the character size to be used.  Setting cex
  37.                    to value smaller than one can be a useful way
  38.                    of avoiding label overlap.
  39.     
  40.              ... : graphical parameters can also be specified as
  41.                    arguments.
  42.     
  43.     _V_a_l_u_e:
  44.     
  45.          This function is invoked for its side effect, which is
  46.          to produce two variants of dotplots as described in
  47.          Cleveland's graphics book.
  48.     
  49.          Dotcharts are a reasonable substitute for barcharts.
  50.     
  51.     _R_e_f_e_r_e_n_c_e_s:
  52.     
  53.          Cleveland, W. S. (1985).  The Elements of Graphing
  54.          Data, Monterey, CA: Wadsworth.
  55.     
  56.     _E_x_a_m_p_l_e_s:
  57.     
  58.          data(deaths)
  59.          dotplot(deaths, main="Death Rates in Virginia - 1940")
  60.          dotplot(t(deaths), main="Death Rates in Virginia - 1940")
  61.     
  62.