do3d                  package:made4                  R Documentation

_G_e_n_e_r_a_t_e _3_D _g_r_a_p_h(_s) _u_s_i_n_g _s_c_a_t_t_e_r_p_l_o_t_3_d

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

     'do3d' is a wrapper for scatterplot3d. do3d will draw a single 3D
     xyz plot and will plot each group of points in a different colour,
     given a factor. 

     'rotate3d' calls 'do3d' to draw multiple 3D plots in which each
     plot is  marginally rotated on the x-y axis.

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

     do3d(dataset, x = 1, y = 2, z = 3, angle = 40, classvec = NULL, classcol
     = NULL, col = NULL, cex.lab=0.3, pch=19, cex.symbols=1, ...)
     rotate3d(dataset, x = 1, y = 2, z = 3, beg = 180, end = 360, step = 12, 
     savefiles = FALSE, classvec = NULL, classcol = NULL, col = NULL, ...)

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

 dataset: XYZ coordinates to be plotted. A 'matrix' or 'data.frame' 
          with 3 or more columns. Usually results from multivariate
          analysis, such as the $co or $li coordinates from a  PCA
          'dudi.pca', or COA  'dudi.coa' or the $ls, $co coordinates
          from 'bga'. 

       x: Numeric, the column number for the x-axis, the default is 1
          (that is dataset[,1])

       y: Numeric, the column number for the y-axis, the default is 2
          (that is dataset[,2])

       z: Numeric, the column number for the z-axis, the default is 3
          (that is dataset[,3])

   angle: Numeric, the angle between x and y axis. Note the result
          depends on scaling. See  'scatterplot3d'  

classvec: A 'factor' or 'vector' which describes the classes in dataset 

classcol: A 'factor' or 'vector' which list the colours for each of the
          classes in the dataset. By default NULL. When NULL, 'getcol'
          is used to obtain an optimum set of colours of the classes in
          classvec.

 cex.lab: Numeric. The magnification to be used for the axis annotation
           relative to the current default text and symbol size.
          Default is 0.3

     pch: Integer specifying a symbol or single character to be used
          when  plotting points. The default is pch=  19

cex.symbols: Numeric. The magnification to be used for the symbols 
          relative to the current default text size. Default is 1

     col: A character indicating a colour. To be used if all points are
          to be one colour. If classvec, classcol and col are all NULL.
          all points will be drawn in red by default.

     beg: Numeric. The starting angle between the x and y axis for
          rotate3d. Rotate3d will draw plots in which they are rotated
          from angle beg to angle end

     end: Numeric. The final angle between the x and y axis for
          'rotate3d'. Rotate3d will draw plots in which they are
          rotated from angle 'beg' to angle 'end' 

    step: Numeric. Increment of the sequence between the starting angle
          beg and the final angle end. 

savefiles: Logical, indicating whether the plot should be saved as a
          pdf file. The default is FALSE 

     ...: further arguments passed to or from other methods 

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

     Produces plots of the xyz coordinates.

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

     Aedin Culhane

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

     See Also 'scatterplot3d'

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

     data(khan)
     if (require(ade4, quiet = TRUE)) {
     khan.coa<-dudi.coa(khan$train, scannf=FALSE, nf=5)
     }
     par(mfrow=c(2,1))
     do3d(khan.coa$co, classvec=khan$train.classes)
     do3d(khan.coa$co, col="blue")
     rotate3d(khan.coa$co,classvec=khan$train.classes)
     khan.bga<-bga(khan$train, khan$train.classes)
     plot.new()
     par(bg="black")
     do3d(khan.bga$bet$ls, classvec=khan$train.classes)

