symbols                 package:base                 R Documentation

_D_r_a_w _s_y_m_b_o_l_s _o_n _a _p_l_o_t

_D_e_s_c_r_i_p_t_i_o_n:

     This function draws symbols on a plot.  One of six symbols;
     circles, squares, rectangles, stars, thermometers, and boxplots,
     can be plotted at a specified set of x and y coordinates. 
     Specific aspects of the symbols, such as relative size, can be
     customized by additional parameters.

_U_s_a_g_e:

     symbols(x, y, circles, squares, rectangles, stars,
             thermometers, boxplots, inches=TRUE, add=FALSE,
             fg=1, bg=NA, xlab = "", ylab = "", xlim = NULL,
             ylim = NULL, ...)

_A_r_g_u_m_e_n_t_s:

       x: a vector giving the x coordinates of the symbols.

       y: a vector giving the y coordinates of the symbols.

 circles: a vector giving the radii of the circles.

 squares: a vector giving the length of the sides of the squares.

rectangles: a matrix with two columns.  The first column gives widths
          and the second the heights of rectangle symbols.

   stars: a matrix with three or more columns giving the lengths of the
          rays from the center of the stars.  `NA' values are replaced
          by zeroes.

thermometers: a matrix with three or four columns.  The first two
          columns give the width and height of the thermometer symbols.
          If there are three columns, the third is taken as a
          proportion. The thermometers are filled from their base to
          this proportion of their height.  If there are four columns,
          the third and fourth columns are taken as proportions.  The
          thermometers are filled between these two proportions of
          their heights.

boxplots: a matrix with five columns.  The first two columns give the
          width and height of the boxes and the third the proportion of
          the way up the box that the median line is drawn.  The last
          two columns give the lengths of the lower and upper whiskers.

  inches: If `inches' is `FALSE', the units are taken to be those of
          the x axis.  If `inches' is `TRUE', the symbols are scaled so
          that the largest symbol is one inch in height.  If a number
          is given the symbols are scaled to make largest symbol this
          height in inches.

     add: if `add' is `TRUE', the symbols are added to an existing
          plot, otherwise a new plot is created. If a new plot is
          created the axis labels default to `""'.

      fg: colors the symbols are to be drawn in (the default is the
          value of the `col' graphics parameter).

      bg: if specified, the symbols are filled with this color. The
          default is to leave the symbols unfilled. 

    xlab: the x label of the plot.

    ylab: the y label of the plot.

    xlim: numeric of length 2 giving the x limits for the plot.

    ylim: numeric of length 2 giving the y limits for the plot.

     ...: graphics parameters can also be passed to this function.

_D_e_t_a_i_l_s:

     Observations which have missing coordinates or missing size
     parameters are not plotted.  The exception to this is stars. In
     that case, the length of any rays which are `NA' is reset to zero.

_R_e_f_e_r_e_n_c_e_s:

     W. S. Cleveland (1985) The Elements of Graphing Data. Monterey,
     California: Wadsworth.

_E_x_a_m_p_l_e_s:

     x <- 1:10
     y <- runif(10)
     z <- runif(10)
     symbols(x, y, thermometers=cbind(.5, 1, z), inches=.5)

     data(trees)
     attach(trees)
     ## Girth is diameter in inches
     symbols(Height, Volume, circles=Girth/24, inches=FALSE,
             xlab="Height", ylab="Volume")
     detach()

