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.

     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.

     Because of the way colours are done the axis itself is redrawn in
     the same colour, 'lty' and 'lwd' as the ticks.  You can replot the
     box if you don't like this feature.

_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")
     })

