rug                 package:graphics                 R Documentation

_A_d_d _a _R_u_g _t_o _a _P_l_o_t

_D_e_s_c_r_i_p_t_i_o_n:

     Adds a _rug_ representation (1-d plot) of the data to the plot.

_U_s_a_g_e:

     rug(x, ticksize = 0.03, side = 1, lwd = 0.5, col = par("fg"),
         quiet = getOption("warn") < 0, ...)

_A_r_g_u_m_e_n_t_s:

       x: A numeric vector

ticksize: The length of the ticks making up the 'rug'. Positive lengths
          give inwards ticks.

    side: On which side of the plot box the rug will be plotted.
          Normally 1 (bottom) or 3 (top).

     lwd: The line width of the ticks.  Some devices will round the
          default width up to '1'.

     col: The colour the ticks are plotted in.

   quiet: logical indicating if there should be a warning about clipped
          values.

     ...: further arguments, passed to 'axis', such as 'line' or 'pos'
          for specifying the location of the rug.

_D_e_t_a_i_l_s:

     Because of the way 'rug' is implemented, only values of 'x' that
     fall within the plot region are included.  There will be a warning
     if any finite values are omitted, but non-finite values are
     omitted silently.

     Prior to R 2.8.0 'rug' re-drew the axis like: it no longer does
     so.

_R_e_f_e_r_e_n_c_e_s:

     Chambers, J. M. and Hastie, T. J. (1992) _Statistical Models in
     S._ Wadsworth & Brooks/Cole.

_S_e_e _A_l_s_o:

     'jitter' which you may want for ties in 'x'.

_E_x_a_m_p_l_e_s:

     require(stats)# both 'density' and its default method
     with(faithful, {
         plot(density(eruptions, bw = 0.15))
         rug(eruptions)
         rug(jitter(eruptions, amount = 0.01), side = 3, col = "light blue")
     })