BEST (version 0.5.4)

plotAll: A series of plots displaying the results of 'BEST' analysis.

Description

Displays a series of plots showing the posterior probability distributions of the parameters of interest.

Usage

plotAll(BESTobj, credMass = 0.95,
  ROPEm = NULL, ROPEsd = NULL, ROPEeff = NULL,
  compValm = 0, compValsd = NULL, compValeff = 0,
  showCurve = FALSE, 
  mainColor="skyblue", dataColor="red", comparisonColor="darkgreen",
  ROPEColor = "darkred",...)

Arguments

BESTobj

an object of class BEST, as produced by the function BESTmcmc.

credMass

the probability mass to include in credible intervals, or NULL to suppress plotting of the credible interval.

ROPEm

a two element vector, such as c(-1, 1), specifying the limit of the ROPE on the difference of means (for 2 groups) or the mean (for 1 group).

ROPEsd

a two element vector, such as c(-1, 1), specifying the limit of the ROPE on the (difference of) standard deviations.

ROPEeff

a two element vector, such as c(-1, 1), specifying the limit of the ROPE on the effect size.

showCurve

logical: if TRUE, the posterior density will be represented by a kernel density function instead of a histogram.

compValm

a value for comparison with the (difference of) means.

compValsd

a value for comparison with the (difference of) standard deviations.

compValeff

a value for comparison with the effect size.

mainColor

an optional color name such as "skyblue" or a RGB specification such as "#87CEEB" that controls the color of the histograms and posterior prediction lines.

dataColor

an optional color name such as "red" or a RGB specification such as "#FF0000" that controls the color of the data histogram.

comparisonColor

an optional color name such as "darkgreen" or a RGB specification such as "#013220" that controls the color used to display compVal.

ROPEColor

an optional color name such as "darkred" or a RGB specification such as "#8B0000" that controls the color used to display the ROPE.

...

other graphical parameters (currently ignored).

Value

Returns NULL invisibly. Used for the side effect.

Details

The display has a series of panels displaying the posterior distributions of each of the parameters (and differences between groups) together with summary statistics; see plotPost for details. Also a chart showing approx. 30 plots of posterior predictive distributions, together with histograms of the original data.

References

Kruschke, J. K. 2013. Bayesian estimation supersedes the t test. Journal of Experimental Psychology: General 142(2):573-603. doi: 10.1037/a0029146

See Also

plot for plots of individual parameters, summary for values of the corresponding summary statistics and pairs for a scatterplot matrix plot and correlation coefficients.

Examples

# NOT RUN {
# See examples in BEST-package.
# }