# gplotmatrix

Matrix of scatter plots by group

## Syntax

## Description

`gplotmatrix(`

creates a matrix of scatter plots and histograms of the data in `X`

,[],`group`

)`X`

,
grouped by the grouping variable in `group`

. Each off-diagonal plot in
the resulting figure is a scatter plot of a column of `X`

against
another column of `X`

. The software also plots the outlines of the
grouped histograms in the diagonal plots of the plot matrix. `X`

and
`group`

must have the same number of rows.

`gplotmatrix(`

creates a matrix of scatter plots. Each plot in the resulting figure is a scatter plot of
a column of `X`

,`Y`

,`group`

)`X`

against a column of `Y`

. For
example, if `X`

has *p* columns and
`Y`

has *q* columns, then the figure contains a
*q*-by-*p* matrix of scatter plots. All plots are
grouped by the grouping variable `group`

. The input arguments
`X`

, `Y`

, and `group`

must all
have the same number of rows.

`gplotmatrix(`

labels the `X`

,[],`group`

,`clr`

,`sym`

,`siz`

,`doleg`

,`dispopt`

,`xnam`

)*x*-axes and *y*-axes of the scatter
plots using the column names specified in `xnam`

. The input argument
`xnam`

must contain one name for each column of
`X`

. Set `dispopt`

to
`'variable'`

to display the variable names along the diagonal of the
scatter plot matrix.

`gplotmatrix(`

creates
the scatter plot matrix in the figure or panel specified by `parent`

,___)`parent`

.
Specify `parent`

as the first input argument followed by any of the
input argument combinations in the previous syntaxes.

## Examples

## Input Arguments

## Output Arguments

## See Also

**Introduced before R2006a**