panel.pairs             package:lattice             R Documentation

_D_e_f_a_u_l_t _S_u_p_e_r_p_a_n_e_l _F_u_n_c_t_i_o_n _f_o_r _s_p_l_o_m

_D_e_s_c_r_i_p_t_i_o_n:

     This is the default superpanel function for 'splom'.

_U_s_a_g_e:

     panel.pairs(z,
                 panel = "panel.splom",
                 lower.panel = panel,
                 upper.panel = panel,
                 diag.panel = "diag.panel.splom",
                 as.matrix = FALSE,
                 groups = NULL,
                 panel.subscripts,
                 subscripts,
                 pscales = 5,
                 prepanel.limits = function(x) if (is.factor(x)) levels(x) else
                 extend.limits(range(as.numeric(x), na.rm = TRUE)),
                 ...)
     diag.panel.splom(varname, limits, at, lab, draw = TRUE, ...)

_A_r_g_u_m_e_n_t_s:

       z: The data frame used for the plot.

panel, lower.panel, upper.panel: The panel function used to display
          each pair of variables. If specified, 'lower.panel' and
          'upper.panel' are used for panels below and above the
          diagonal respectively. 

diag.panel: The panel function used for the diagonals. See arguments to
          'diag.panel.splom' to know what arguments this function is
          passed when called. 

as.matrix: logical. If 'TRUE', the layout of the panels will have
          origin on the top left instead of bottom left (similar to
          'pairs'). This is in essence the same functionality as
          provided by 'as.table' for the panel layout 

  groups: Grouping variable, if any 

panel.subscripts: logical specifying whether the panel function accepts
          an argument named 'subscripts'. 

subscripts: The indices of the rows of 'z' that are to be displayed in
          this (super)panel. 

 pscales: Controls axis labels, passed down from 'splom'. If pscales is
          a single number, it indicates the approximate number of
          equally-spaced ticks that should appear on each axis. If
          pscales is a list, it should have p components, each of which
          is itself a list with the following valid components:

          at: a numeric vector specifying tick locations

          labels: character vector labels to go with at

          limits: numeric 2-vector specifying axis limits (should be
          made more flexible at some point to handle factors)

          These are specifications on a per-variable basis, and used on
          all four sides in  the diagonal cells used for labelling.

          Factor variables are labelled with the factor names. Use
          pscales=0 to supress the axes entirely. 

prepanel.limits: The `regular' high level lattice plots such as
          'xyplot' use the 'prepanel' function for deciding on axis
          limits from data. This function serves a similar function,
          and works on a per-variable basis, by calculating the limits,
          which can be overridden by the corresponding 'limits'
          component in the 'pscales' list. 

 varname: (scalar) character string or expression that is to be written
          centred within the panel 

  limits: numeric of length 2, or, vector of characters, specifying the
          scale for that panel (used to calculate tick locations when
          missing) 

      at: locations of tick marks

     lab: optional labels for tick marks

    draw: logical, specifying whether to draw the tick marks and
          labels. If 'FALSE', only variable names are written 

     ...: extra arguments, typically graphical parameters to control
          appearance of axes and variable names in the diagonal panels.
          The actual list of possible arguments is rather large, see
          the formal arguments to 'panel.pairs' and 'panel.diag.splom'
          (using 'formals') for all the possibilities. 

_D_e_t_a_i_l_s:

     This is the function that is actually passed in as the 'panel'
     function in a trellis object produced by splom (taking the `panel'
     function as its argument).

_A_u_t_h_o_r(_s):

     Deepayan Sarkar Deepayan.Sarkar@R-project.org

_S_e_e _A_l_s_o:

     'splom'

