grid3d                  package:rgl                  R Documentation

_A_d_d _a _g_r_i_d _t_o _a _3_D _p_l_o_t

_D_e_s_c_r_i_p_t_i_o_n:

     This function adds a reference grid to an RGL plot.

_U_s_a_g_e:

     grid3d(side, at = NULL, col = "gray", lwd = 1, lty = 1, n = 5)

_A_r_g_u_m_e_n_t_s:

    side: Where to put the grid; see the Details section. 

      at: How to draw the grid; see the Details section. 

     col: The color of the grid lines. 

     lwd: The line width of the grid lines. 

     lty: The line type of the grid lines. 

       n: Suggested number of grid lines; see the Details section. 

_D_e_t_a_i_l_s:

     This function is similar to 'grid' in classic graphics, except
     that it draws a 3D grid in the plot.

     The grid is drawn in a plane perpendicular to the coordinate axes.
     The first letter of the 'side' argument specifies the direction of
     the plane: '"x"', '"y"' or '"z"' (or uppercase versions) to
     specify the coordinate which is constant on the plane.

     If 'at = NULL' (the default), the grid is drawn at the limit of 
     the box around the data.  If the second letter of the 'side'
     argument is '"-"' or is not present, it is the lower limit; if
     '"+"' then at the upper limit.  The grid lines are drawn at values
     chosen by 'pretty' with 'n' suggested locations. The default
     locations should match those chosen by 'axis3d' with 'nticks = n'.

     If 'at' is a numeric vector, the grid lines are drawn at those
     values.

     If 'at' is a list, then the '"x"' component is used to specify the
     x location, the '"y"' component specifies the y location, and the
     '"z"' component specifies the z location.  Missing components are
     handled using the default as for 'at = NULL'.

     Multiple grids may be drawn by specifying multiple values for
     'side' or for the component of 'at' that specifies the grid
     location.

_V_a_l_u_e:

     A vector or matrix of object ids is returned invisibly.

_A_u_t_h_o_r(_s):

     Ben Bolker and Duncan Murdoch

_S_e_e _A_l_s_o:

     'axis3d'

_E_x_a_m_p_l_e_s:

     x <- 1:10
     y <- 1:10
     z <- matrix(outer(x-5,y-5) + rnorm(100), 10, 10)
     open3d()
     persp3d(x, y, z, col="red", alpha=0.7, aspect=c(1,1,0.5))
     grid3d(c("x", "y+", "z"))

