DescTools (version 0.99.14)

PlotMatrix: Scatterplot Matrix

Description

Plots a scatterplot matrix, for which the variables shown horizontally do not necessarily coincide with those shown vertically. If desired, the matrix is divided into several blocks such that it fills more than 1 plot page.

Usage

PlotMatrix(x, y = NULL, data = NULL, panel = l.panel,
  nrows = 0, ncols = nrows, save = TRUE,
  robrange. = FALSE, range. = NULL, pch = NULL, col = 1, 
  reference = 0, ltyref = 3, log = "", xaxs = "r", yaxs = "r",
  xaxmar = NULL, yaxmar = NULL, vnames = NULL,
  main = "", cex.points = NA, cex.lab = 0.7, cex.text = 1.3, cex.title = 1,
  bty = "o", oma = NULL, ...)

Arguments

x
data for columns (x axis), or formula defining column variables. If it is a formula containing a left hand side, the left side variables will be used last.
y
data or formula for rows (y axis). Defaults to x
data
data.frame containing the variables in case x or y is a formula
panel
a function that generates the marks of the individual panels, see Details. Defaults essentially to points or text depending on the argument pch
nrows
number of rows of panels on a page
ncols
number of columns of panels on a page
save
if y is not provided and save==TRUE, the first row and the last column are suppressed.
robrange.
if TRUE, robust plot ranges will be used
range.
plot ranges, given as a matrix with 2 rows (min, max) and colnames identifying the variables.
pch
plotting character. A vector of integers, characters or strings can also be given for the default panel function
col
color(s) to be used for plotting the observations
reference
coordinates for reference lines to be shown in the panels. A named vector can be used to define a value for each or any variable.
ltyref
line type for reference lines
log
specifies logarithmic scale of axes. "x" asks for log scale on horizontal axis, "y", on vertical axis, "xy", on both axes.
xaxs, yaxs
styles for x and y axis, see par
xaxmar, yaxmar
in which margin should the x- [y-] axis be labelled?
vnames
labels for the variables
main
main title for the plot (to be repeated on each plot page)
cex.points
character expansion for showing the observations
cex.lab, cex.text
character expansion for variable labels in the margin and in the "diagonal", respectively, relative to cex
cex.title
character expansion for the main title
bty
box type for each panel, see par
oma
width of outer margins, ee par
...
further arguments passed to the panel function

Value

  • none

Details

If x or y is a data.frame, it is converted to a numerical matrix.

The panel function can be user written. It needs $>=6$ arguments, which are given:

  • the values of the horizontal variable,
  • the values of the vertical variable,
  • the index of the variable shown horizontally, among theyvariables,
  • the index of the variable shown vertically, among thexvariables,
  • argumentpch, and
  • argumentcol

Since large scatterplot matrices lead to tiny panels, PlotMatrix splits the matrix into blocks of at most nrows rows and ncols columns. If these numbers are missing, they default to nrows=5 and ncols=6 for landscape pages, and to nrows=8 and ncols=5 for portrait pages.

See Also

pairs

Examples

Run this code
PlotMatrix(iris[,1:4], main="Iris", pch=as.numeric(iris[,"Species"]))

Run the code above in your browser using DataCamp Workspace