Description Usage Arguments Value Author(s) See Also Examples
Bar charts for categorical data with statistical details included in the plot as a subtitle.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15  ggbarstats(data, main, condition = NULL, counts = NULL, ratio = NULL,
paired = FALSE, labels.legend = NULL, results.subtitle = TRUE,
stat.title = NULL, sample.size.label = TRUE, label.separator = " ",
label.text.size = 4, label.fill.color = "white",
label.fill.alpha = 1, bar.outline.color = "black",
bf.message = TRUE, sampling.plan = "indepMulti",
fixed.margin = "rows", prior.concentration = 1, title = NULL,
subtitle = NULL, caption = NULL, legend.position = "right",
x.axis.orientation = NULL, conf.level = 0.95, nboot = 100,
simulate.p.value = FALSE, B = 2000, legend.title = NULL,
xlab = NULL, ylab = "Percent", k = 2, perc.k = 0,
bar.label = "percentage", data.label = NULL, bar.proptest = TRUE,
ggtheme = ggplot2::theme_bw(), ggstatsplot.layer = TRUE,
package = "RColorBrewer", palette = "Dark2", direction = 1,
ggplot.component = NULL, return = "plot", messages = TRUE)

data 
A dataframe (or a tibble) from which variables specified are to be taken. A matrix or tables will not be accepted. 
main 
The variable to use as the rows in the contingency table. 
condition 
The variable to use as the columns in the contingency table. 
counts 
A string naming a variable in data containing counts, or 
ratio 
A vector of numbers: the expected proportions for the proportion
test. Default is 
paired 
Logical indicating whether data came from a withinsubjects
design study (Default: 
labels.legend 
A character vector with custom labels for levels of
the 
results.subtitle 
Decides whether the results of statistical tests are
to be displayed as a subtitle (Default: 
stat.title 
Title for the effect being investigated with the chisquare
test. The default is 
sample.size.label 
Logical that decides whether sample size information
should be displayed for each level of the grouping variable 
label.separator 
If 
label.text.size 
Numeric that decides text size for slice/bar labels
(Default: 
label.fill.color 
Character that specifies fill color for slice/bar
labels (Default: 
label.fill.alpha 
Numeric that specifies fill color transparency or

bar.outline.color 
Character specifying color for bars (default:

bf.message 
Logical that decides whether to display a caption with
results from bayes factor test in favor of the null hypothesis (default:

sampling.plan 
Character describing the sampling plan. Possible options
are 
fixed.margin 
For the independent multinomial sampling plan, which
margin is fixed ( 
prior.concentration 
Specifies the prior concentration parameter, set
to 
title 
The text for the plot title. 
subtitle 
The text for the plot subtitle. Will work only if

caption 
The text for the plot caption. 
legend.position 
The position of the legend

x.axis.orientation 
The orientation of the 
conf.level 
Scalar between 0 and 1. If unspecified, the defaults return

nboot 
Number of bootstrap samples for computing confidence interval
for the effect size (Default: 
simulate.p.value 
a logical indicating whether to compute pvalues by Monte Carlo simulation. 
B 
an integer specifying the number of replicates used in the Monte Carlo test. 
legend.title 
Title text for the legend. 
xlab 
Custom text for the 
ylab 
Custom text for the 
k 
Number of digits after decimal point (should be an integer)
(Default: 
perc.k 
Numeric that decides number of decimal places for percentage
labels (Default: 
bar.label, data.label 
Character decides what information needs to be
displayed on the label in each pie slice. Possible options are

bar.proptest 
Decides whether proportion test for 
ggtheme 
A function, 
ggstatsplot.layer 
Logical that decides whether 
package 
Name of package from which the palette is desired as string or symbol. 
palette 
If a character string (e.g., 
direction 
Either 
ggplot.component 
A 
return 
Character that describes what is to be returned: can be

messages 
Decides whether messages references, notes, and warnings are
to be displayed (Default: 
Unlike a number of statistical softwares, ggstatsplot
doesn't
provide the option for Yates' correction for the Pearson's chisquared
statistic. This is due to compelling amount of MonteCarlo simulation
research which suggests that the Yates' correction is overly conservative,
even in small sample sizes. As such it is recommended that it should not
ever be applied in practice (Camilli & Hopkins, 1978, 1979; Feinberg, 1980;
Larntz, 1978; Thompson, 1988).
For more about how the effect size measures and their confidence intervals
are computed, see ?rcompanion::cohenG
, ?rcompanion::cramerV
, and
?rcompanion::cramerVFit
.
Chuck Powell, Indrajeet Patil
grouped_ggbarstats
, ggpiestats
,
grouped_ggpiestats
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22  # for reproducibility
set.seed(123)
# simple function call with the defaults (with condition)
ggstatsplot::ggbarstats(
data = datasets::mtcars,
main = vs,
condition = cyl,
nboot = 10,
labels.legend = c("0 = Vshaped", "1 = straight"),
legend.title = "Engine"
)
# simple function call with the defaults (with count data)
library(jmv)
ggstatsplot::ggbarstats(
data = as.data.frame(HairEyeColor),
main = Eye,
condition = Hair,
counts = Freq
)

Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.