splom                package:lattice                R Documentation

_S_c_a_t_t_e_r _P_l_o_t _M_a_t_r_i_c_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     Draw Conditional Scatter Plot Matrices and Parallel Coordinate
     Plots

_U_s_a_g_e:

     splom(formula,
           data,
           aspect = 1,
           between = list(x = 0.5, y = 0.5),
           panel = if (is.null(groups)) "panel.splom" else "panel.superpose",
           superpanel = "panel.pairs",
           pscales = 5,
           varnames, ...)
     parallel(formula,
              data = list(x = 0.5, y = 0.5),
              between,
              panel = "panel.parallel",
              varnames,
              ...)

_A_r_g_u_m_e_n_t_s:

 formula: a formula describing the structure of the plot, which should
          be of the form '~ x | g1 * g2 * ...', where 'x' is a data
          frame or a matrix. Each of 'g1,g2,...' must be either factors
          or shingles. The conditioning variables 'g1,g2,...' may be
          omitted, in which case the leading '~' may also be omitted. 

    data: a data frame containing values for any variables in the
          formula. By default the environment where the function  was
          called from is used. 

  aspect: aspect ratio of each panel (and subpanel), square by default
          for 'splom'. 

 between: to avoid confusion between panels and subpanels, the default
          is to show the panels of a splom plot with space between
          them. 

   panel: function that is used to plot the data on each subpanel of a
          splom display. Usual interpretation for 'densityplot'. 

superpanel: function that sets up the splom display, by default as a
          scatterplot matrix. 

 pscales: a numeric value or a list, meant to be a less functional
          substitute for the 'scales' argument in 'xyplot' etc. This
          argument is passed to the 'superpanel' function, and is
          handled by the default superpanel function 'panel.pairs'. The
          help page for the latter documents this argument in more
          detail. 

varnames: character vector giving the names of the p variables in x. By
          default, the column names of x. 

     ...: other arguments

_D_e_t_a_i_l_s:

     'splom' produces Scatter Plot Matrices. The role usually played by
     'panel' is taken over by 'superpanel', which determines how the
     columns of 'x' are to be arranged for pairwise plots. The only
     available option currently is 'panel.pairs'.

     Many of the finer customizations usually done via arguments to
     high level function like 'xyplot' are instead done by
     'panel.pairs' for 'splom'. These include control of axis limits,
     tick locations and prepanel calcultions. If you are trying to
     fine-tune your 'splom' plot, definitely look at the 'panel.pairs'
     help page. The 'scales' argument is usually not very useful in
     'splom' (see the examples for a legitimate use, though), and
     trying to change it may have undesired effects.

     'parallel' draws Parallel Coordinate Plots. (Difficult to
     describe, see example.)

     These and all other high level Trellis functions have several
     arguments in common. These are extensively documented only in the
     help page for 'xyplot', which should be consulted to learn more
     detailed usage.

_V_a_l_u_e:

     An object of class ``trellis''. The `update' method can be used to
     update components of the object and the `print' method (usually
     called by default) will plot it on an appropriate plotting device.

_A_u_t_h_o_r(_s):

     Deepayan Sarkar deepayan@stat.wisc.edu

_S_e_e _A_l_s_o:

     'xyplot', 'Lattice'

_E_x_a_m_p_l_e_s:

     data(iris)
     super.sym <- trellis.par.get("superpose.symbol")
     splom(~iris[1:4], groups = Species, data = iris,
           panel = panel.superpose,
           key = list(title = "Three Varieties of Iris",
                      columns = 3, 
                      points = list(pch = super.sym$pch[1:3],
                      col = super.sym$col[1:3]),
                      text = list(c("Setosa", "Versicolor", "Virginica"))))
     splom(~iris[1:3]|Species, data = iris, 
           layout=c(2,2), pscales = 0,
           varnames = c("Sepal\nLength", "Sepal\nWidth", "Petal\nLength"),
           page = function(...) {
               ltext(x = seq(.6, .8, len = 4), 
                     y = seq(.9, .6, len = 4), 
                     lab = c("Three", "Varieties", "of", "Iris"),
                     cex = 2)
           })

