# R: Panel Function for Display Marked by groups

panel.superpose {lattice} | R Documentation

## Panel Function for Display Marked by groups

### Description

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.

### Usage

    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)

### Arguments

`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.

### Details

`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`.

### Author(s)

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

### See Also

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.

[Package lattice version 0.16-5 Index]