hexplom {hexbin} | R Documentation

## Scatter Plot Matrices

### Description

Draw Conditional Scatter Plot Matrices and Parallel Coordinate Plots

### Usage

    hexplom(x, ...)

    ## S3 method for class 'formula':
    hexplom(x,
                 data = parent.frame(),
                 auto.key = FALSE,
                 aspect = 1,
                 between = list(x = 0.5, y = 0.5),
                 panel = panel.hexplom,
                 prepanel = NULL,
                 scales = list(),
                 strip = TRUE,
                 groups = NULL,
                 xlab = "Scatter Plot Matrix",
                 xlim,
                 ylab = NULL,
                 ylim,
                 superpanel = "panel.pairs",
                 pscales = 5,
                 varnames,
                 drop.unused.levels = lattice.getOption("drop.unused.levels"),
                 ...,
                 default.scales = list(draw = FALSE, relation = "same",axs = "i"),
                 subset = TRUE)
    ## S3 method for class 'data.frame':
    hexplom(x, data = NULL, ...)

### Arguments

`x` | The object on which method dispatch is carried out. For the `"formula"` method, a formula describing the structure of the plot, which should be of the form `~ x | g1 * g2 * ...`, where `x` is a data frame or matrix. Each of `g1,g2,...` must be either factors or shingles. The conditioning variables `g1, g2, ...` may be omitted. For the `data.frame` methods, a data frame.
`data` | For the `formula` methods, an optional data frame in which variables in the formula (as well as `groups` and `subset`, if any) are to be evaluated. By default, the environment where the function was called from is used.
`aspect` | aspect ratio of each panel (and subpanel), square by default for `hexplom`.
`between` | to avoid confusion between panels and subpanels, the default is to show the panels of a hexplom plot with space between them.
`panel` | Usual interpretation for `parallel`, namely the function that creates the display within each panel. For `hexplom`, the terminology is slightly complicated. The role played by the panel function in most other high-level functions is played here by the `superpanel` function, which is responsible for the display for each conditional data subset. `panel` is simply an argument to the default `superpanel` function `panel.pairs`, and is passed on to it unchanged. It is used there to create each pairwise display. See `panel.pairs` for more useful options.
`superpanel` | function that sets up the hexplom 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.
`auto.key, prepanel, scales, strip, groups, xlab, xlim, ylab, ylim, drop.unused.levels, default.scales, subset` | See `xyplot`
`...` | Further arguments. See corresponding entry in `xyplot` for non-trivial details.

### Details

`hexplom` produces pairwise Plot Matrices with hexagon bins. 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 `hexplom`. These include control of axis limits, tick locations and prepanel calcultions. If you are trying to fine-tune your `hexplom` plot, definitely look at the `panel.pairs` help page. The `scales` argument is usually not very useful in `hexplom`, and trying to change it may have undesired effects.

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.

### Value

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.

### Author(s)

Deepayan Sarkar Deepayan.Sarkar@R-project.org, Nicholas Lewin-Koh nikko@hailmail.net

### See Also

`splom`, `xyplot`, `Lattice`, `panel.pairs`

### Examples

      ## Simple hexplom
      data(NHANES)
      hexplom(~NHANES[,7:14],xbins=15)
      ## With colors and conditioning
      hexplom(~NHANES[,9:13]|Sex,data=NHANES,xbins=15,colramp=magent)
      ## With custom panel function
      hexplom(~NHANES[,9:13],data=NHANES,xbins=20,colramp=BTY,
               superpanel=hppan<-function(z,...){
                            panel.pairs(z,upper.panel=panel.hexboxplot,...)})

[Package hexbin version 1.14.0 Index]