diamondPlot

Basic diamond plot construction function

This function constructs a diamond plot using ggDiamondLayer. It's normally not necessary to call this function directly: instead, use meansDiamondPlot, meanSDtoDiamondPlot, and factorLoadingDiamondCIplot.

Keywords
hplot
Usage
diamondPlot(data, ciCols = 1:3, colorCol = NULL, otherAxisCol = NULL, yValues = NULL, yLabels = NULL, ylab = NULL, autoSize = NULL, fixedSize = 0.15, xlab = "Effect Size Estimate", theme = theme_bw(), color = "black", ...)
Arguments
data
A dataframe (or matrix) containing lower bounds, centers (e.g. means), and upper bounds of intervals (e.g. confidence intervals).
ciCols
The columns in the dataframe with the lower bounds, centers (e.g. means), and upper bounds (in that order).
colorCol
The column in the dataframe containing the colors for each diamond, or a vector with colors (with as many elements as the dataframe has rows).
otherAxisCol
The column in the dataframe containing the values that determine where on the Y axis the diamond should be placed. If this is not available in the dataframe, specify it manually using yValues.
yValues
The values that determine where on the Y axis the diamond should be placed (can also be a column in the dataframe; in that case, use otherAxisCol.
yLabels
The labels to use for for each diamond (placed on the Y axis).
ylab
The label of the Y axis.
autoSize
Whether to make the height of each diamond conditional upon its length (the width of the confidence interval).
fixedSize
If not using relative heights, fixedSize determines the height to use.
xlab
The label of the X axis.
theme
The theme to use.
color
Color to use if colors are specified for each diamond.
...
Additional arguments will be passed to ggDiamondLayer.
Value

A ggplot plot with a ggDiamondLayer is returned.

See Also

meansDiamondPlot, meanSDtoDiamondPlot, factorLoadingDiamondCIplot, ggDiamondLayer

Aliases
  • diamondPlot
Examples
tmpDf <- data.frame(lo = c(1, 2, 3),
                    mean = c(1.5, 3, 5),
                    hi = c(2, 4, 10),
                    color = c('green', 'red', 'blue'));
                    
### A simple diamond plot
diamondPlot(tmpDf);

### A diamond plot using the specified colours
diamondPlot(tmpDf, colorCol = 4);

### A diamond plot using automatically generated colours
### using a gradient
diamondPlot(tmpDf, generateColors=c('green', 'red'));

### A diamond plot using automatically generated colours
### using a gradient, specifying the minimum and maximum
### possible values that can be attained
diamondPlot(tmpDf, generateColors=c('green', 'red'),
            fullColorRange=c(1, 10));

Documentation reproduced from package userfriendlyscience, version 0.5-2, License: GPL (>= 2)

Community examples

Looks like there are no examples yet.