panel.superpose           package:lattice           R Documentation

_P_a_n_e_l _F_u_n_c_t_i_o_n _f_o_r _D_i_s_p_l_a_y _M_a_r_k_e_d _b_y _g_r_o_u_p_s

_D_e_s_c_r_i_p_t_i_o_n:

     These are panel functions for Trellis displays useful when a
     grouping variable is specified for use within panels. The 'x' (and
     'y' where appropriate) variables are plotted with different
     graphical parameters for each distinct value of the grouping
     variable.

_U_s_a_g_e:

     panel.superpose(x, y = NULL, subscripts, groups,
                     panel.groups = "panel.xyplot",
                     col, col.line, col.symbol,
                     pch, cex, fill, font,
                     fontface, fontfamily,
                     lty, lwd, alpha,
                     type = "p",
                     ...,
                     distribute.type = FALSE)
     panel.superpose.2(..., distribute.type = TRUE)

_A_r_g_u_m_e_n_t_s:

     x,y: coordinates of the points to be displayed

panel.groups: the panel function to be used for each group of points.
          Defaults to 'panel.xyplot' (behaviour in S).

          To be able to distinguish between different levels of the
          originating group inside 'panel.groups', it will be supplied
          a special argument called 'group.number' which will hold the
          numeric code corresponding to the current level of 'groups'.
          No special care needs to be taken when writing a
          'panel.groups' function if this feature is not used. 

subscripts: subscripts giving indices in original data frame 

  groups: a grouping variable. Different graphical parameters will be
          used to plot the subsets of observations given by each
          distinct value of 'groups'. The default graphical parameters
          are obtained from 'superpose.symbol' and 'superpose.line'
          using 'trellis.par.get' wherever appropriate 

    type: usually a character vector specifying what should be drawn
          for each group, passed on to the 'panel.groups' function,
          which must know what to do with it.  By default, this is
          'panel.xyplot', whose help page describes the admissible
          values.

          The functions 'panel.superpose' and 'panel.superpose.2'
          differ only in the default value of 'distribute.type', which
          controls the way the 'type' argument is interpreted.  If
          'distribute.type = FALSE', then the interpretation is the
          same as for 'panel.xyplot' for each of the unique groups.  In
          other words, if 'type' is a vector, all the individual
          components are honoured concurrently.  If 'distribute.type =
          TRUE', 'type' is replicated to be as long as the number of
          unique values in 'groups', and one component used for the
          points corresponding to the each different group.  Even in
          this case, it is possible to request multiple types per
          group, specifying 'type' as a list, each component being the
          desired 'type' vector for the corresponding group.

          If 'distribute.type = FALSE', any occurrence of '"g"' in
          'type' causes a grid to be drawn, and all such occurrences
          are removed before 'type' is passed on to 'panel.groups'. 

col, col.line, col.symbol, pch, cex, fill, font, fontface,
fontfamily, lty, lwd, alpha: 
          graphical parameters, replicated to be as long as the number
          of groups.  These are eventually passed down to
          'panel.groups', but as scalars rather than vectors.  When
          'panel.groups' is called for the i-th level of 'groups', the
          corresponding element of each graphical parameter is passed
          to it. 

     ...: Extra arguments.  Passed down to 'panel.superpose' from
          'panel.superpose.2', and to 'panel.groups' from
          'panel.superpose'. 

distribute.type: logical controlling interpretation of the 'type'
          argument.   

_D_e_t_a_i_l_s:

     'panel.superpose' and 'panel.superpose.2' differ essentially in
     how 'type' is interpreted by default.  The default behaviour in
     'panel.superpose' is the opposite of that in S, which is the same
     as that of 'panel.superpose.2'.

_A_u_t_h_o_r(_s):

     Deepayan Sarkar Deepayan.Sarkar@R-project.org ('panel.superpose.2'
     originally contributed by Neil Klepeis)

_S_e_e _A_l_s_o:

     Different functions when used as 'panel.groups' gives different
     types of plots, for example 'panel.xyplot', 'panel.dotplot' and
     'panel.linejoin' (This can be used to produce interaction plots).

     See 'Lattice' for an overview of the package.

