grid                package:graphics                R Documentation

_A_d_d _G_r_i_d _t_o _a _P_l_o_t

_D_e_s_c_r_i_p_t_i_o_n:

     'grid' adds an 'nx' by 'ny' rectangular grid to an existing plot.

_U_s_a_g_e:

     grid(nx = NULL, ny = nx, col = "lightgray", lty = "dotted",
          lwd = par("lwd"), equilogs = TRUE)

_A_r_g_u_m_e_n_t_s:

   nx,ny: number of cells of the grid in x and y direction.  When
          'NULL', as per default, the grid aligns with the tick marks
          on the corresponding _default_ axis (i.e., tickmarks as
          computed by 'axTicks').  When 'NA', no grid lines are drawn
          in the corresponding direction.

     col: character or (integer) numeric; color of the grid lines.

     lty: character or (integer) numeric; line type of the grid lines.

     lwd: non-negative numeric giving line width of the grid lines.

equilogs: logical, only used when _log_ coordinates and alignment with
          the axis tick marks are active.  Setting 'equilogs = FALSE'
          in that case gives _non equidistant_ tick aligned grid lines.

_N_o_t_e:

     If more fine tuning is required, use 'abline(h = ., v = .)'
     directly.

_R_e_f_e_r_e_n_c_e_s:

     Murrell, P. (2005) _R Graphics_. Chapman & Hall/CRC Press.

_S_e_e _A_l_s_o:

     'plot', 'abline', 'lines', 'points'.

_E_x_a_m_p_l_e_s:

     plot(1:3)
     grid(NA, 5, lwd = 2) # grid only in y-direction

     ## maybe change the desired number of tick marks:  par(lab=c(mx,my,7))
     op <- par(mfcol = 1:2)
     with(iris,
          {
          plot(Sepal.Length, Sepal.Width, col = as.integer(Species),
               xlim = c(4, 8), ylim = c(2, 4.5), panel.first = grid(),
               main = "with(iris,  plot(...., panel.first = grid(), ..) )")
          plot(Sepal.Length, Sepal.Width, col = as.integer(Species),
               panel.first = grid(3, lty=1,lwd=2),
               main = "... panel.first = grid(3, lty=1,lwd=2), ..")
          }
         )
     par(op)

