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, font,
                     fontface, fontfamily,
                     lty, lwd, alpha,
                     type = "p",
                     ...)
     panel.superpose.2(x, y = NULL, subscripts, groups,
                       panel.groups = "panel.xyplot",
                       col, col.line, col.symbol,
                       pch, cex, font, 
                       fontface, fontfamily, 
                       lty, lwd, alpha,
                       type = "p",
                       ...)

_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) 

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 two functions 'panel.superpose' and 'panel.superpose.2'
          differ only in the way the 'type' argument is interpreted. 
          For the former, 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.  For the latter, '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 plot.

          In 'panel.superpose', 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, font, fontface, fontfamily,
lty, lwd, alpha: graph
          ical parameters, replicated to be as long as the number of
          groups, and eventually ultimately passed down to
          'panel.groups'. 

     ...: other arguments, passed down to 'panel.groups'.  

_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).

