userfriendlyscience (version 0.7.2)

scatterMatrix: scatterMatrix

Description

scatterMatrix produced a matrix with jittered scatterplots, histograms, and correlation coefficients.

Usage

scatterMatrix(dat, items=NULL, plotSize=180, sizeMultiplier = 1,
              axisLabels = "none", powerHist=TRUE, ...)

Arguments

dat

A dataframe containing the items in the scale. All variables in this dataframe will be used if items is NULL.

items

If not NULL, this should be a character vector with the names of the variables in the dataframe that represent items in the scale.

plotSize

Size of the final plot in millimeters.

sizeMultiplier

Allows more flexible control over the size of the plot elements

axisLabels

Passed to ggpairs function to set axisLabels.

powerHist

Whether to use the default ggpairs histogram on the diagonal of the scattermatrix, or whether to use the powerHist version.

...

Additional arguments are passed on to powerHist.

Value

An object with the input and several output variables. Most notably:

output$scatterMatrix

A scattermatrix with histograms on the diagonal and correlation coefficients in the upper right half.

Examples

# NOT RUN {
### Note: the 'not run' is simply because running takes a lot of time,
###       but these examples are all safe to run!
# }
# NOT RUN {
### Generate a datafile to use
exampleData <- data.frame(item1=rnorm(100));
exampleData$item2 <- exampleData$item1+rnorm(100);
exampleData$item3 <- exampleData$item1+rnorm(100);
exampleData$item4 <- exampleData$item2+rnorm(100);
exampleData$item5 <- exampleData$item2+rnorm(100);

### Use all items
scatterMatrix(dat=exampleData);
# }