Package 'sjPlot'

Numeric, optional. If specified, a chi-squared distribution with deg.f degrees of freedom is plotted and a shaded area at chi2 value position is plotted that indicates whether or not the specified value is significant or not. If both chi2 and p are not specified, a distribution without shaded area is plotted.

Numeric. The degrees of freedom for the chi-squared distribution. Needs to be specified.

Numeric, optional. If specified, a chi-squared distribution with deg.f degrees of freedom is plotted and a shaded area at the position where the specified p-level starts is plotted. If both chi2 and p are not specified, a distribution without shaded area is plotted.

Numeric, optional. Specifies the maximum x-axis-value. If not specified, the x-axis ranges to a value where a p-level of 0.00001 is reached.

user defined color for geoms. See 'Details' in plot_grpfrq.

Specifies the alpha-level of the shaded area. Default is 0.7, range between 0 to 1.

Numeric, optional. If specified, an F distribution with deg.f1 and deg.f2 degrees of freedom is plotted and a shaded area at f value position is plotted that indicates whether or not the specified value is significant or not. If both f and p are not specified, a distribution without shaded area is plotted.

Numeric. The first degrees of freedom for the F distribution. Needs to be specified.

Numeric. The second degrees of freedom for the F distribution. Needs to be specified.

Numeric, optional. If specified, a F distribution with deg.f1 and deg.f2 degrees of freedom is plotted and a shaded area at the position where the specified p-level starts is plotted. If both f and p are not specified, a distribution without shaded area is plotted.

Numeric, optional. Specifies the maximum x-axis-value. If not specified, the x-axis ranges to a value where a p-level of 0.00001 is reached.

user defined color for geoms. See 'Details' in plot_grpfrq.

Specifies the alpha-level of the shaded area. Default is 0.7, range between 0 to 1.

Numeric, optional. If specified, a normal distribution with mean and sd is plotted and a shaded area at norm value position is plotted that indicates whether or not the specified value is significant or not. If both norm and p are not specified, a distribution without shaded area is plotted.

Numeric. Mean value for normal distribution. By default 0.

Numeric. Standard deviation for normal distribution. By default 1.

Numeric, optional. If specified, a normal distribution with mean and sd is plotted and a shaded area at the position where the specified p-level starts is plotted. If both norm and p are not specified, a distribution without shaded area is plotted.

Numeric, optional. Specifies the maximum x-axis-value. If not specified, the x-axis ranges to a value where a p-level of 0.00001 is reached.

user defined color for geoms. See 'Details' in plot_grpfrq.

Specifies the alpha-level of the shaded area. Default is 0.7, range between 0 to 1.

Numeric, optional. If specified, a t-distribution with deg.f degrees of freedom is plotted and a shaded area at t value position is plotted that indicates whether or not the specified value is significant or not. If both t and p are not specified, a distribution without shaded area is plotted.

Numeric. The degrees of freedom for the t-distribution. Needs to be specified.

Numeric, optional. If specified, a t-distribution with deg.f degrees of freedom is plotted and a shaded area at the position where the specified p-level starts is plotted. If both t and p are not specified, a distribution without shaded area is plotted.

Numeric, optional. Specifies the maximum x-axis-value. If not specified, the x-axis ranges to a value where a p-level of 0.00001 is reached.

user defined color for geoms. See 'Details' in plot_grpfrq.

Specifies the alpha-level of the shaded area. Default is 0.7, range between 0 to 1.

A data frame, or a grouped data frame.

Optional, unquoted names of variables that should be selected for further processing. Required, if data is a data frame (and no vector) and only selected variables from data should be processed. You may also use functions like : or tidyselect's select_helpers.

Character vector, used as plot title. By default, response_labels is called to retrieve the label of the dependent variable, which will be used as title. Use title = "" to remove title.

Vector of weights that will be applied to weight all cases. Must be a vector of same length as the input vector. Default is NULL, so no weights are used.

Suffix (as string) for the title, if weight.by is specified, e.g. title.wtd.suffix=" (weighted)". Default is NULL, so title will not have a suffix when cases are weighted.

Determines whether categories should be sorted according to their frequencies or not. Default is "none", so categories are not sorted by frequency. Use "asc" or "desc" for sorting categories ascending or descending order.

Specifies the plot type. May be abbreviated.

"bar"

for simple bars (default)

"dot"

for a dot plot

"histogram"

for a histogram (does not apply to grouped frequencies)

"line"

for a line-styled histogram with filled area

"density"

for a density plot (does not apply to grouped frequencies)

"boxplot"

for box plot

"violin"

for violin plots

size resp. width of the geoms (bar width, line thickness or point size, depending on plot type and function). Note that bar and bin widths mostly need smaller values than dot sizes.

User defined color for geoms, e.g. geom.colors = "#0080ff".

Color of confidence interval bars (error bars). Only applies to type = "bar". In case of dot plots, error bars will have same colors as dots (see geom.colors).

Character vector of length one or two (depending on the plot function and type), used as title(s) for the x and y axis. If not specified, a default labelling is chosen. Note: Some plot types do not support this argument. In such cases, use the return value and add axis titles manually with labs, e.g.: $plot.list[[1]] + labs(x = ...)

character vector with labels used as axis labels. Optional argument, since in most cases, axis labels are set automatically.

Numeric vector of length two, defining lower and upper axis limits of the x scale. By default, this argument is set to NULL, i.e. the x-axis fits to the required range of the data.

numeric vector of length two, defining lower and upper axis limits of the y scale. By default, this argument is set to NULL, i.e. the y-axis fits to the required range of the data.

Numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

numeric; sets the distance between breaks for the axis, i.e. at every grid.breaks'th position a major grid is being printed.

logical, if TRUE, the plot grid is expanded, i.e. there is a small margin between axes and plotting region. Default is FALSE.

Logical, whether values should be plotted or not.

logical, if TRUE, adds total number of cases for each group or category to the labels.

logical, if TRUE (default), percentage values are plotted to each bar If FALSE, percentage values are removed.

logical, whether category, count or percentage values for the axis should be printed or not.

Logical, if TRUE), adds notches to the box plot, which are used to compare groups; if the notches of two boxes do not overlap, medians are considered to be significantly different.

logical, if TRUE, NA's (missing values) are added to the output.

Logical, if TRUE, a vertical line in histograms is drawn to indicate the mean value of the variables. Only applies to histogram-charts.

Logical, if TRUE (default), the mean value is printed to the vertical line that indicates the variable's mean. Only applies to histogram-charts.

Logical, if TRUE, the standard deviation is annotated as shaded rectangle around the mean intercept line. Only applies to histogram-charts.

Logical, if TRUE and the variable's values are labeled, values / factor levels with no occurrence in the data are omitted from the output. If FALSE, labeled values that have no observations are still printed in the table (with frequency 0).

Numeric value, indicating the linetype of the mean intercept line. Only applies to histogram-charts and when show.mean = TRUE.

Numeric, size of the mean intercept line. Only applies to histogram-charts and when show.mean = TRUE.

width of the inner box plot that is plotted inside of violin plots. Only applies if type = "violin". Default value is 0.15

size of mean dot insie a violin or box plot. Applies only when type = "violin" or "boxplot".

Logical, if TRUE, a normal curve, which is adjusted to the data, is plotted over the histogram or density plot. Default is FALSE. Only applies when histograms or density plots are plotted (see type).

Color of the normal curve line. Only applies if normal.curve = TRUE.

Numeric, size of the normal curve line. Only applies if normal.curve = TRUE.

Transparancy level (alpha value) of the normal curve. Only applies if normal.curve = TRUE.

numeric value, indicating the minimum amount of unique values in the count variable, at which automatic grouping into smaller units is done (see group_var). Default value for auto.group is NULL, i.e. auto-grouping is off. See group_var for examples on grouping.

logical, if TRUE, the x and y axis are swapped.

character vector, indicating the vertical position of value labels. Allowed are same values as for vjust aesthetics from ggplot2: "left", "center", "right", "bottom", "middle", "top" and new options like "inward" and "outward", which align text towards and away from the center of the plot respectively.

character vector, indicating the horizontal position of value labels. Allowed are same values as for vjust aesthetics from ggplot2: "left", "center", "right", "bottom", "middle", "top" and new options like "inward" and "outward", which align text towards and away from the center of the plot respectively.

numeric, offset for text labels when their alignment is adjusted to the top/bottom of the geom (see hjust and vjust).

A data frame, or a grouped data frame.

Categorical variable, where the proportion of each category in x for the highest category of y will be printed along the x-axis.

Categorical or numeric variable. If not a binary variable, y will be recoded into a binary variable, dichtomized at the highest category and all remaining categories.

Grouping variable, which will define the y-axis

May be a character vector of color values in hex-format, valid color value names (see demo("colors")) or a name of a pre-defined color palette. Following options are valid for the colors argument:

• If not specified, a default color brewer palette will be used, which is suitable for the plot style.

• If "gs", a greyscale will be used.

• If "bw", and plot-type is a line-plot, the plot is black/white and uses different line types to distinguish groups (see this package-vignette).

• If colors is any valid color brewer palette name, the related palette will be used. Use RColorBrewer::display.brewer.all() to view all available palette names.

• There are some pre-defined color palettes in this package, see sjPlot-themes for details.

• Else specify own color values or names as vector (e.g. colors = "#00ff00" or colors = c("firebrick", "blue")).

size resp. width of the geoms (bar width, line thickness or point size, depending on plot type and function). Note that bar and bin widths mostly need smaller values than dot sizes.

Optional color vector, fill-color for non-filled shapes

Numeric vector with shape styles, used to map the different categories of x.

Character vector, used as plot title. By default, response_labels is called to retrieve the label of the dependent variable, which will be used as title. Use title = "" to remove title.

character vector with labels used as axis labels. Optional argument, since in most cases, axis labels are set automatically.

character vector of length one or two, defining the title(s) for the x-axis and y-axis.

Character vector, used as legend title for plots that have a legend.

character vector with labels for the guide/legend.

Numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend's title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend labels are displayed in one line and when a line break is inserted.

Numeric vector of length 2, defining the range of the plot axis. Depending on plot type, may effect either x- or y-axis, or both. For multiple plot outputs (e.g., from type = "eff" or type = "slope" in plot_model), axis.lim may also be a list of vectors of length 2, defining axis limits for each plot (only if non-faceted).

numeric; sets the distance between breaks for the axis, i.e. at every grid.breaks'th position a major grid is being printed.

Logical, if TRUE, a total summary line for all aggregated grp is added.

Logical, if TRUE and show.total = TRUE, the total-row in the figure will be highlighted with a slightly shaded background.

Logical, adds significance levels to values, or value and variable labels.

logical, if TRUE, adds total number of cases for each group or category to the labels.

A list of ggplot-objects. See 'Details'.

A numeric vector of length 4, indicating the top, right, bottom and left margin for each plot, in centimetres.

Add tags to your subfigures. Can be TRUE (letter tags) or character vector containing tags labels.

Vector of counts, for which frequencies or means will be plotted or printed.

Factor with the cross-classifying variable, where var.cnt is grouped into the categories represented by var.grp.

Specifies the plot type. May be abbreviated.

"bar"

for simple bars (default)

"dot"

for a dot plot

"histogram"

for a histogram (does not apply to grouped frequencies)

"line"

for a line-styled histogram with filled area

"density"

for a density plot (does not apply to grouped frequencies)

"boxplot"

for box plot

"violin"

for violin plots

Indicates whether bars should be positioned side-by-side (default), or stacked (bar.pos = "stack"). May be abbreviated.

Vector of weights that will be applied to weight all cases. Must be a vector of same length as the input vector. Default is NULL, so no weights are used.

An interaction variable which can be used for box plots. Divides each category indicated by var.grp into the factors of intr.var, so that each category of var.grp is subgrouped into intr.var's categories. Only applies when type = "boxplot" or type = "violin".

character vector, used as plot title. Depending on plot type and function, will be set automatically. If title = "", no title is printed. For effect-plots, may also be a character vector of length > 1, to define titles for each sub-plot or facet.

Suffix (as string) for the title, if weight.by is specified, e.g. title.wtd.suffix=" (weighted)". Default is NULL, so title will not have a suffix when cases are weighted.

character vector, used as title for the plot legend.

character vector of length one or two, defining the title(s) for the x-axis and y-axis.

character vector with labels used as axis labels. Optional argument, since in most cases, axis labels are set automatically.

character vector with labels for the guide/legend.

a character vector with labels for the x-axis breaks when having interaction variables included. These labels replace the axis.labels. Only applies, when using box or violin plots (i.e. type = "boxplot" or "violin") and intr.var is not NULL.

numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend's title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend labels are displayed in one line and when a line break is inserted.

size resp. width of the geoms (bar width, line thickness or point size, depending on plot type and function). Note that bar and bin widths mostly need smaller values than dot sizes.

the spacing between geoms (i.e. bar spacing)

user defined color for geoms. See 'Details' in plot_grpfrq.

Logical, whether values should be plotted or not.

logical, if TRUE, adds total number of cases for each group or category to the labels.

logical, if TRUE (default), percentage values are plotted to each bar If FALSE, percentage values are removed.

logical, whether category, count or percentage values for the axis should be printed or not.

Logical, if TRUE), adds notches to the box plot, which are used to compare groups; if the notches of two boxes do not overlap, medians are considered to be significantly different.

logical, if TRUE, the count within each group is added to the category labels (e.g. "Cat 1 (n=87)"). Default value is FALSE.

logical, if TRUE, and depending on plot type and function, a legend is added to the plot.

logical, if TRUE, NA's (missing values) are added to the output.

logical, if TRUE (default), a summary with chi-squared statistics (see chisq.test), Cramer's V or Phi-value etc. is shown. If a cell contains expected values lower than five (or lower than 10 if df is 1), the Fisher's exact test (see fisher.test) is computed instead of chi-squared test. If the table's matrix is larger than 2x2, Fisher's exact test with Monte Carlo simulation is computed.

Logical, if TRUE and the variable's values are labeled, values / factor levels with no occurrence in the data are omitted from the output. If FALSE, labeled values that have no observations are still printed in the table (with frequency 0).

numeric value, indicating the minimum amount of unique values in the count variable, at which automatic grouping into smaller units is done (see group_var). Default value for auto.group is NULL, i.e. auto-grouping is off. See group_var for examples on grouping.

numeric vector of length two, defining lower and upper axis limits of the y scale. By default, this argument is set to NULL, i.e. the y-axis fits to the required range of the data.

numeric; sets the distance between breaks for the axis, i.e. at every grid.breaks'th position a major grid is being printed.

logical, if TRUE, the plot grid is expanded, i.e. there is a small margin between axes and plotting region. Default is FALSE.

width of the inner box plot that is plotted inside of violin plots. Only applies if type = "violin". Default value is 0.15

size of mean dot insie a violin or box plot. Applies only when type = "violin" or "boxplot".

prints a smooth line curve. Only applies, when argument type = "line".

logical, if TRUE, the groups of dots in a dot-plot are highlighted with a shaded rectangle.

position of the model summary which is printed when show.summary is TRUE. Default is "r", i.e. it's printed to the upper right corner. Use "l" for upper left corner.

TRUE to arrange the lay out of of multiple plots in a grid of an integrated single plot. This argument calls facet_wrap or facet_grid to arrange plots. Use plot_grid to plot multiple plot-objects as an arranged grid with grid.arrange.

logical, if TRUE, the x and y axis are swapped.

numeric, offset for text labels when their alignment is adjusted to the top/bottom of the geom (see hjust and vjust).

character vector, indicating the vertical position of value labels. Allowed are same values as for vjust aesthetics from ggplot2: "left", "center", "right", "bottom", "middle", "top" and new options like "inward" and "outward", which align text towards and away from the center of the plot respectively.

character vector, indicating the horizontal position of value labels. Allowed are same values as for vjust aesthetics from ggplot2: "left", "center", "right", "bottom", "middle", "top" and new options like "inward" and "outward", which align text towards and away from the center of the plot respectively.

A data frame, used to split the data into k training-test-pairs.

A model formula, used to fit linear models (lm) over all k training data sets. Use fit to specify a fitted model (also other models than linear models), which will be used to compute cross validation. If fit is not missing, formula will be ignored.

Number of folds.

Model object, which will be used to compute cross validation. If fit is not missing, formula will be ignored. Currently, only linear, poisson and negative binomial regression models are supported.

Data frame, or a grouped data frame, with each column representing one item.

(optional) Must be a vector of same length as ncol(items), where each item in this vector represents the group number of the related columns of items. See 'Examples'.

(optional, only used if groups are supplied) Titles for each factor group that will be used as table caption for each component-table. Must be a character vector of same length as length(unique(groups)). Default is "auto", which means that each table has a standard caption Component x. Use NULL to use names as supplied to groups and use FALSE to suppress table captions.

character vector, used as plot title. Depending on plot type and function, will be set automatically. If title = "", no title is printed. For effect-plots, may also be a character vector of length > 1, to define titles for each sub-plot or facet.

character vector, used as title for the plot legend.

character vector with labels for the guide/legend.

character vector of length one or two, defining the title(s) for the x-axis and y-axis.

character vector with labels used as axis labels. Optional argument, since in most cases, axis labels are set automatically.

optional, amount of categories of items (e.g. "strongly disagree", "disagree", "agree" and "strongly agree" would be catcount = 4). Note that this argument only applies to "valid" answers, i.e. if you have an additional neutral category (see cat.neutral) like "don't know", this won't count for catcount (e.g. "strongly disagree", "disagree", "agree", "strongly agree" and neutral category "don't know" would still mean that catcount = 4). See 'Note'.

If there's a neutral category (like "don't know" etc.), specify the index number (value) for this category. Else, set cat.neutral = NULL (default). The proportions of neutral category answers are plotted as grey bars on the left side of the figure.

Indicates whether the items of items should be ordered by total sum of positive or negative answers.

"pos.asc"

to order ascending by sum of positive answers

"pos.desc"

to order descending by sum of positive answers

"neg.asc"

for sorting ascending negative answers

"neg.desc"

for sorting descending negative answers

NULL

(default) for no sorting

Vector of weights that will be applied to weight all cases. Must be a vector of same length as the input vector. Default is NULL, so no weights are used.

Suffix (as string) for the title, if weight.by is specified, e.g. title.wtd.suffix=" (weighted)". Default is NULL, so title will not have a suffix when cases are weighted.

numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend's title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend labels are displayed in one line and when a line break is inserted.

size resp. width of the geoms (bar width, line thickness or point size, depending on plot type and function). Note that bar and bin widths mostly need smaller values than dot sizes.

user defined color for geoms. See 'Details' in plot_grpfrq.

Color of the neutral category, if plotted (see cat.neutral).

Color of the vertical intercept line that divides positive and negative values.

logical, if TRUE, the color scale from geom.colors will be reversed, so positive and negative values switch colors.

Determines style and position of percentage value labels on the bars:

"show"

(default) shows percentage value labels in the middle of each category bar

"hide"

hides the value labels, so no percentage values on the bars are printed

"sum.inside"

shows the sums of percentage values for both negative and positive values and prints them inside the end of each bar

"sum.outside"

shows the sums of percentage values for both negative and positive values and prints them outside the end of each bar

logical, if TRUE, adds total number of cases for each group or category to the labels.

logical, if TRUE, and depending on plot type and function, a legend is added to the plot.

logical, if TRUE, %-signs for value labels are shown.

Numeric, limits of the x-axis-range, as proportion of 100. Default is 1, so the x-scale ranges from zero to 100% on both sides from the center. Can alternatively be supplied as a vector of 2 positive numbers (e.g. grid.range = c(1, .8)) to set the left and right limit separately. You can use values beyond 1 (100%) in case bar labels are not printed because they exceed the axis range. E.g. grid.range = 1.4 will set the axis from -140 to +140%, however, only (valid) axis labels from -100 to +100% are printed. Neutral categories are adjusted to the most left limit.

numeric; sets the distance between breaks for the axis, i.e. at every grid.breaks'th position a major grid is being printed.

logical, if TRUE, the plot grid is expanded, i.e. there is a small margin between axes and plotting region. Default is FALSE.

Numeric, amount of digits after decimal point when rounding estimates or values.

logical, if TRUE, the ordering of the categories is reversed, so positive and negative values switch position.

logical, if TRUE, the x and y axis are swapped.

(optional, only used if groups are supplied) logical, if groups should be sorted according to the values supplied to groups. Defaults to TRUE.

(optional, only used if groups are supplied) Defines the legend position. Possible values are c("bottom", "top", "both", "all", "none"). If the is only one group or this option is set to "all" legends will be printed as defined with set_theme.

(optional, only used if groups are supplied) This option can be used to adjust the height of the subplots. The bars in subplots can have different heights due to a differing number of items or due to legend placement. This can be adjusted here. Takes a vector of numbers, one for each plot. Values are evaluated relative to each other.

(optional, only used if groups are supplied) List of options to be passed to guide_legend. The most notable options are byrow=T (default), this will order the categories row wise. And with group.legend.options = list(nrow = 1) all categories can be forced to be on a single row.

(optional, only used if groups are supplied) List of label options to be passed to plot_grid.

A regression model object. Depending on the type, many kinds of models are supported, e.g. from packages like stats, lme4, nlme, rstanarm, survey, glmmTMB, MASS, brms etc.

Type of plot. There are three groups of plot-types:

Coefficients (related vignette)

type = "est"

Forest-plot of estimates. If the fitted model only contains one predictor, slope-line is plotted.

type = "re"

For mixed effects models, plots the random effects.

type = "std"

Forest-plot of standardized coefficients.

type = "std2"

Forest-plot of standardized coefficients, however, standardization is done by dividing by two SD (see 'Details').

Marginal Effects (related vignette)

type = "pred"

Predicted values (marginal effects) for specific model terms. See ggpredict for details.

type = "eff"

Similar to type = "pred", however, discrete predictors are held constant at their proportions (not reference level). See ggeffect for details.

type = "emm"

Similar to type = "eff", see ggemmeans for details.

type = "int"

Marginal effects of interaction terms in model.

Model diagnostics

type = "slope"

Slope of coefficients for each single predictor, against the response (linear relationship between each model term and response). See 'Details'.

type = "resid"

Slope of coefficients for each single predictor, against the residuals (linear relationship between each model term and residuals). See 'Details'.

type = "diag"

Check model assumptions. See 'Details'.

Note: For mixed models, the diagnostic plots like linear relationship or check for Homoscedasticity, do not take the uncertainty of random effects into account, but is only based on the fixed effects part of the model.

A character vector, naming a function that will be applied on estimates and confidence intervals. By default, transform will automatically use "exp" as transformation for applicable classes of model (e.g. logistic or poisson regression). Estimates of linear models remain untransformed. Use NULL if you want the raw, non-transformed estimates.

Character vector with the names of those terms from model that should be plotted. This argument depends on the plot-type:

Coefficients

Select terms that should be plotted. All other term are removed from the output. Note that the term names must match the names of the model's coefficients. For factors, this means that the variable name is suffixed with the related factor level, and each category counts as one term. E.g. rm.terms = "t_name [2,3]" would remove the terms "t_name2" and "t_name3" (assuming that the variable t_name is categorical and has at least the factor levels 2 and 3). Another example for the iris-dataset: terms = "Species" would not work, instead you would write terms = "Species [versicolor,virginica]" to remove these two levels, or terms = "Speciesversicolor" if you just want to remove the level versicolor from the plot.

Marginal Effects

Here terms indicates for which terms marginal effects should be displayed. At least one term is required to calculate effects, maximum length is three terms, where the second and third term indicate the groups, i.e. predictions of first term are grouped by the levels of the second (and third) term. terms may also indicate higher order terms (e.g. interaction terms). Indicating levels in square brackets allows for selecting only specific groups. Term name and levels in brackets must be separated by a whitespace character, e.g. terms = c("age", "education [1,3]"). It is also possible to specify a range of numeric values for the predictions with a colon, for instance terms = c("education [1,3]", "age [30:50]"). Furthermore, it is possible to specify a function name. Values for predictions will then be transformed, e.g. terms = "income [exp]". This is useful when model predictors were transformed for fitting the model and should be back-transformed to the original scale for predictions. Finally, numeric vectors for which no specific values are given, a "pretty range" is calculated, to avoid memory allocation problems for vectors with many unique values. If a numeric vector is specified as second or third term (i.e. if this vector represents a grouping structure), representative values (see values_at) are chosen. If all values for a numeric vector should be used to compute predictions, you may use e.g. terms = "age [all]". For more details, see ggpredict.

Determines in which way estimates are sorted in the plot:

• If NULL (default), no sorting is done and estimates are sorted in the same order as they appear in the model formula.

• If TRUE, estimates are sorted in descending order, with highest estimate at the top.

• If sort.est = "sort.all", estimates are re-sorted for each coefficient (only applies if type = "re" and grid = FALSE), i.e. the estimates of the random effects for each predictor are sorted and plotted to an own plot.

• If type = "re", specify a predictor's / coefficient's name to sort estimates according to this random effect.

Character vector with names that indicate which terms should be removed from the plot. Counterpart to terms. rm.terms = "t_name" would remove the term t_name. Default is NULL, i.e. all terms are used. For factors, levels that should be removed from the plot need to be explicitely indicated in square brackets, and match the model's coefficient names, e.g. rm.terms = "t_name [2,3]" would remove the terms "t_name2" and "t_name3" (assuming that the variable t_name was categorical and has at least the factor levels 2 and 3). Another example for the iris dataset would be rm.terms = "Species [versicolor,virginica]". Note that the rm.terms-argument does not apply to Marginal Effects plots.

Numeric vector with group indices, to group coefficients. Each group of coefficients gets its own color (see 'Examples').

Numeric vector, indicating in which order the coefficients should be plotted. See examples in this package-vignette.

Character, only applies for Marginal Effects plots with mixed effects models. Indicates whether predicted values should be conditioned on random effects (pred.type = "re") or fixed effects only (pred.type = "fe", the default). For details, see documentation of the type-argument in ggpredict.

Indicates which values of the moderator variable should be used when plotting interaction terms (i.e. type = "int").

"minmax"

(default) minimum and maximum values (lower and upper bounds) of the moderator are used to plot the interaction between independent variable and moderator(s).

"meansd"

uses the mean value of the moderator as well as one standard deviation below and above mean value to plot the effect of the moderator on the independent variable (following the convention suggested by Cohen and Cohen and popularized by Aiken and West (1991), i.e. using the mean, the value one standard deviation above, and the value one standard deviation below the mean as values of the moderator, see Grace-Martin K: 3 Tips to Make Interpreting Moderation Effects Easier).

"zeromax"

is similar to the "minmax" option, however, 0 is always used as minimum value for the moderator. This may be useful for predictors that don't have an empirical zero-value, but absence of moderation should be simulated by using 0 as minimum.

"quart"

calculates and uses the quartiles (lower, median and upper) of the moderator value.

"all"

uses all values of the moderator variable.

Numeric vector. If type = "re" and fitted model has more than one random intercept, ri.nr indicates which random effects of which random intercept (or: which list elements of ranef) will be plotted. Default is NULL, so all random effects will be plotted.

Character vector, used as plot title. By default, response_labels is called to retrieve the label of the dependent variable, which will be used as title. Use title = "" to remove title.

Character vector of length one or two (depending on the plot function and type), used as title(s) for the x and y axis. If not specified, a default labelling is chosen. Note: Some plot types may not support this argument sufficiently. In such cases, use the returned ggplot-object and add axis titles manually with labs. Use axis.title = "" to remove axis titles.

Character vector with labels for the model terms, used as axis labels. By default, term_labels is called to retrieve the labels of the coefficients, which will be used as axis labels. Use axis.labels = "" or auto.label = FALSE to use the variable names as labels instead. If axis.labels is a named vector, axis labels (by default, the names of the model's coefficients) will be matched with the names of axis.label. This ensures that labels always match the related axis value, no matter in which way axis labels are sorted.

Character vector, used as legend title for plots that have a legend.

Numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

Numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

Numeric vector of length 2, defining the range of the plot axis. Depending on plot-type, may effect either x- or y-axis. For Marginal Effects plots, axis.lim may also be a list of two vectors of length 2, defining axis limits for both the x and y axis.

Numeric value or vector; if grid.breaks is a single value, sets the distance between breaks for the axis at every grid.breaks'th position, where a major grid line is plotted. If grid.breaks is a vector, values will be used to define the axis positions of the major grid lines.

Numeric, the level of the confidence intervals (error bars). Use ci.lvl = NA to remove error bars. For stanreg-models, ci.lvl defines the (outer) probability for the credible interval that is plotted (see ci). By default, stanreg-models are printed with two intervals: the "inner" interval, which defaults to the 50%-CI; and the "outer" interval, which defaults to the 89%-CI. ci.lvl affects only the outer interval in such cases. See prob.inner and prob.outer under the ...-argument for more details.

Logical, if TRUE, the standard errors are also printed. If robust standard errors are required, use arguments vcov.fun, vcov.type and vcov.args (see standard_error for details), or use argument robust as shortcut. se overrides ci.lvl: if not NULL, arguments ci.lvl and transform will be ignored. Currently, se only applies to Coefficients plots.

Deprecated. Please use vcov.fun directly to specify the estimation of the variance-covariance matrix.

Variance-covariance matrix used to compute uncertainty estimates (e.g., for robust standard errors). This argument accepts a covariance matrix, a function which returns a covariance matrix, or a string which identifies the function to be used to compute the covariance matrix. See model_parameters().

Deprecated. The type-argument is now included in vcov.args.

List of arguments to be passed to the function identified by the vcov.fun argument. This function is typically supplied by the sandwich or clubSandwich packages. Please refer to their documentation (e.g., ?sandwich::vcovHAC) to see the list of available arguments.

May be a character vector of color values in hex-format, valid color value names (see demo("colors")) or a name of a pre-defined color palette. Following options are valid for the colors argument:

• If not specified, a default color brewer palette will be used, which is suitable for the plot style.

• If "gs", a greyscale will be used.

• If "bw", and plot-type is a line-plot, the plot is black/white and uses different line types to distinguish groups (see this package-vignette).

• If colors is any valid color brewer palette name, the related palette will be used. Use RColorBrewer::display.brewer.all() to view all available palette names.

• There are some pre-defined color palettes in this package, see sjPlot-themes for details.

• Else specify own color values or names as vector (e.g. colors = "#00ff00" or colors = c("firebrick", "blue")).

Logical, if TRUE, the intercept of the fitted model is also plotted. Default is FALSE. If transform = "exp", please note that due to exponential transformation of estimates, the intercept in some cases is non-finite and the plot can not be created.

Logical, whether values should be plotted or not.

Logical, adds asterisks that indicate the significance level of estimates to the value labels.

Logical, for Marginal Effects plots, also plots the raw data points.

For Marginal Effects plots, shows or hides the legend.

Logical, if TRUE, shows the zero-inflation part of hurdle- or zero-inflated models.

Numeric, offset for text labels to adjust their position relative to the dots or lines.

Numeric, indicates the size of value labels. Can be used for all plot types where the argument show.values is applicable, e.g. value.size = 4.

Numeric, between 0 and 1. If show.data = TRUE, you can add a small amount of random variation to the location of each data point. jitter then indicates the width, i.e. how much of a bin's width will be occupied by the jittered values.

Numeric, amount of digits after decimal point when rounding estimates or values.

Numeric, size of the dots that indicate the point estimates.

Numeric, size of the lines that indicate the error bars.

Color of the vertical "zero effect" line. Default color is inherited from the current theme.

Numeric vector of length 3, indicating the treshold for annotating p-values with asterisks. Only applies if p.style = "asterisk".

Character specifying method to be used to calculate p-values. Defaults to "profile" for glm/polr models, otherwise "wald".

Character vector, if not NULL, indicates the method to adjust p-values. See p.adjust for details.

Logical, if TRUE, multiple plots are plotted as grid layout.

Desired target case. Labels will automatically converted into the specified character case. See snakecase::to_any_case() for more details on this argument. By default, if case is not specified, it will be set to "parsed", unless prefix.labels is not "none". If prefix.labels is either "label" (or "l") or "varname" (or "v") and case is not specified, it will be set to NULL - this is a more convenient default when prefixing labels.

Logical, if TRUE (the default), and data is labelled, term_labels is called to retrieve the labels of the coefficients, which will be used as predictor labels. If data is not labelled, format_parameters() is used to create pretty labels. If auto.label = FALSE, original variable names and value labels (factor levels) are used.

Indicates whether the value labels of categorical variables should be prefixed, e.g. with the variable name or variable label. See argument prefix in term_labels for details.

For Stan-models (fitted with the rstanarm- or brms-package), the Bayesian point estimate is, by default, the median of the posterior distribution. Use bpe to define other functions to calculate the Bayesian point estimate. bpe needs to be a character naming the specific function, which is passed to the fun-argument in typical_value. So, bpe = "mean" would calculate the mean value of the posterior distribution.

For Stan-models (fitted with the rstanarm- or brms-package), the Bayesian point estimate is indicated as a small, vertical line by default. Use bpe.style = "dot" to plot a dot instead of a line for the point estimate.

Character vector, indicating the color of the Bayesian point estimate. Setting bpe.color = NULL will inherit the color from the mapped aesthetic to match it with the geom's color.

Character vector, defining whether inner and outer intervals for Bayesion models are shown in boxplot-style ("whisker") or in bars with different alpha-levels ("bar").

Logical, whether the response variable will also be standardized if standardized coefficients are requested. Setting both std.response = TRUE and show.std = TRUE will behave as if the complete data was standardized before fitting the model.

Other arguments, passed down to various functions. Here is a list of supported arguments and their description in detail.

prob.inner and prob.outer

For Stan-models (fitted with the rstanarm- or brms-package) and coefficients plot-types, you can specify numeric values between 0 and 1 for prob.inner and prob.outer, which will then be used as inner and outer probabilities for the uncertainty intervals (HDI). By default, the inner probability is 0.5 and the outer probability is 0.89 (unless ci.lvl is specified - in this case, ci.lvl is used as outer probability).

size.inner

For Stan-models and Coefficients plot-types, you can specify the width of the bar for the inner probabilities. Default is 0.1. Setting size.inner = 0 removes the inner probability regions.

width, alpha, and scale

Passed down to geom_errorbar() or geom_density_ridges(), for forest or diagnostic plots.

width, alpha, dot.alpha, dodge and log.y

Passed down to plot.ggeffects for Marginal Effects plots.

show.loess

Logical, for diagnostic plot-types "slope" and "resid", adds (or hides) a loess-smoothed line to the plot.

Marginal Effects plot-types

When plotting marginal effects, arguments are also passed down to ggpredict, ggeffect or plot.ggeffects.

Case conversion of labels

For case conversion of labels (see argument case), arguments sep_in and sep_out will be passed down to snakecase::to_any_case(). This only applies to automatically retrieved term labels, not if term labels are provided by the axis.labels-argument.

One or more regression models, including glm's or mixed models. May also be a list with fitted models. See 'Examples'.

A character vector, naming a function that will be applied on estimates and confidence intervals. By default, transform will automatically use "exp" as transformation for applicable classes of model (e.g. logistic or poisson regression). Estimates of linear models remain untransformed. Use NULL if you want the raw, non-transformed estimates.

Choose whether standardized coefficients should be used for plotting. Default is no standardization (std.est = NULL). May be "std" for standardized beta values or "std2", where standardization is done by rescaling estimates by dividing them by two sd.

Logical, whether the response variable will also be standardized if standardized coefficients are requested. Setting both std.response = TRUE and show.std = TRUE will behave as if the complete data was standardized before fitting the model.

Character vector with names that indicate which terms should be removed from the plot. Counterpart to terms. rm.terms = "t_name" would remove the term t_name. Default is NULL, i.e. all terms are used. For factors, levels that should be removed from the plot need to be explicitely indicated in square brackets, and match the model's coefficient names, e.g. rm.terms = "t_name [2,3]" would remove the terms "t_name2" and "t_name3" (assuming that the variable t_name was categorical and has at least the factor levels 2 and 3). Another example for the iris dataset would be rm.terms = "Species [versicolor,virginica]". Note that the rm.terms-argument does not apply to Marginal Effects plots.

Character vector, used as plot title. By default, response_labels is called to retrieve the label of the dependent variable, which will be used as title. Use title = "" to remove title.

Character vector, used to indicate the different models in the plot's legend. If not specified, the labels of the dependent variables for each model are used.

Character vector, used as legend title for plots that have a legend.

Character vector, used as title of the plot legend that indicates the p-values. Default is "p-level". Only applies if p.shape = TRUE.

Character vector with labels for the model terms, used as axis labels. By default, term_labels is called to retrieve the labels of the coefficients, which will be used as axis labels. Use axis.labels = "" or auto.label = FALSE to use the variable names as labels instead. If axis.labels is a named vector, axis labels (by default, the names of the model's coefficients) will be matched with the names of axis.label. This ensures that labels always match the related axis value, no matter in which way axis labels are sorted.

Character vector of length one or two (depending on the plot function and type), used as title(s) for the x and y axis. If not specified, a default labelling is chosen. Note: Some plot types may not support this argument sufficiently. In such cases, use the returned ggplot-object and add axis titles manually with labs. Use axis.title = "" to remove axis titles.

Numeric vector of length 2, defining the range of the plot axis. Depending on plot-type, may effect either x- or y-axis. For Marginal Effects plots, axis.lim may also be a list of two vectors of length 2, defining axis limits for both the x and y axis.

Numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

Numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend's title are displayed in one line and when a line break is inserted.

Numeric value or vector; if grid.breaks is a single value, sets the distance between breaks for the axis at every grid.breaks'th position, where a major grid line is plotted. If grid.breaks is a vector, values will be used to define the axis positions of the major grid lines.

Numeric, size of the dots that indicate the point estimates.

Numeric, size of the lines that indicate the error bars.

Numeric, indicates the size of value labels. Can be used for all plot types where the argument show.values is applicable, e.g. value.size = 4.

Numeric, spacing between the dots and error bars of the plotted fitted models. Default is 0.3.

May be a character vector of color values in hex-format, valid color value names (see demo("colors")) or a name of a pre-defined color palette. Following options are valid for the colors argument:

• If not specified, a default color brewer palette will be used, which is suitable for the plot style.

• If "gs", a greyscale will be used.

• If "bw", and plot-type is a line-plot, the plot is black/white and uses different line types to distinguish groups (see this package-vignette).

• If colors is any valid color brewer palette name, the related palette will be used. Use RColorBrewer::display.brewer.all() to view all available palette names.

• There are some pre-defined color palettes in this package, see sjPlot-themes for details.

• Else specify own color values or names as vector (e.g. colors = "#00ff00" or colors = c("firebrick", "blue")).

Logical, whether values should be plotted or not.

For Marginal Effects plots, shows or hides the legend.

Logical, if TRUE, the intercept of the fitted model is also plotted. Default is FALSE. If transform = "exp", please note that due to exponential transformation of estimates, the intercept in some cases is non-finite and the plot can not be created.

Logical, adds asterisks that indicate the significance level of estimates to the value labels.

Logical, if TRUE, significant levels are distinguished by different point shapes and a related legend is plotted. Default is FALSE.

Numeric vector of length 3, indicating the treshold for annotating p-values with asterisks. Only applies if p.style = "asterisk".

Character vector, if not NULL, indicates the method to adjust p-values. See p.adjust for details.

Numeric, the level of the confidence intervals (error bars). Use ci.lvl = NA to remove error bars. For stanreg-models, ci.lvl defines the (outer) probability for the credible interval that is plotted (see ci). By default, stanreg-models are printed with two intervals: the "inner" interval, which defaults to the 50%-CI; and the "outer" interval, which defaults to the 89%-CI. ci.lvl affects only the outer interval in such cases. See prob.inner and prob.outer under the ...-argument for more details.

Deprecated. Please use vcov.fun directly to specify the estimation of the variance-covariance matrix.

Variance-covariance matrix used to compute uncertainty estimates (e.g., for robust standard errors). This argument accepts a covariance matrix, a function which returns a covariance matrix, or a string which identifies the function to be used to compute the covariance matrix. See model_parameters().

Deprecated. The type-argument is now included in vcov.args.

List of arguments to be passed to the function identified by the vcov.fun argument. This function is typically supplied by the sandwich or clubSandwich packages. Please refer to their documentation (e.g., ?sandwich::vcovHAC) to see the list of available arguments.

Color of the vertical "zero effect" line. Default color is inherited from the current theme.

Numeric, amount of digits after decimal point when rounding estimates or values.

Logical, if TRUE, multiple plots are plotted as grid layout.

Logical, if TRUE (the default), and data is labelled, term_labels is called to retrieve the labels of the coefficients, which will be used as predictor labels. If data is not labelled, format_parameters() is used to create pretty labels. If auto.label = FALSE, original variable names and value labels (factor levels) are used.

Indicates whether the value labels of categorical variables should be prefixed, e.g. with the variable name or variable label. See argument prefix in term_labels for details.

Fitted linear (mixed) regression model (including objects of class gls or plm).

size resp. width of the geoms (bar width, line thickness or point size, depending on plot type and function). Note that bar and bin widths mostly need smaller values than dot sizes.

Numeric vector with indices (order equals to row index of coef(fit)) or character vector with coefficient names that indicate which estimates should be removed from the table output. The first estimate is the intercept, followed by the model predictors. The intercept cannot be removed from the table output! remove.estimates = c(2:4) would remove the 2nd to the 4th estimate (1st to 3rd predictor after intercept) from the output. remove.estimates = "est_name" would remove the estimate est_name. Default is NULL, i.e. all estimates are printed.

Logical, if TRUE, a line connecting predicted and residual values is plotted. Set this argument to FALSE, if plot-building is too time consuming.

Logical, if TRUE, residual values are plotted.

Logical, if TRUE, predicted values are plotted.

Logical, if TRUE), adds notches to the box plot, which are used to compare groups; if the notches of two boxes do not overlap, medians are considered to be significantly different.

A data frame, or a grouped data frame.

Name of the variable for the x-axis.

Name of the variable for the y-axis.

Optional, name of the grouping-variable. If not missing, the scatter plot will be grouped. See 'Examples'.

Character vector, used as plot title. By default, response_labels is called to retrieve the label of the dependent variable, which will be used as title. Use title = "" to remove title.

Character vector, used as legend title for plots that have a legend.

character vector with labels for the guide/legend.

Character vector with names for each coordinate pair given by x and y, so text labels are added to the plot. Must be of same length as x and y. If dot.labels has a different length, data points will be trimmed to match dot.labels. If dot.labels = NULL (default), no labels are printed.

character vector of length one or two, defining the title(s) for the x-axis and y-axis.

Numeric, size of the dots that indicate the point estimates.

Size of text labels if argument dot.labels is used.

May be a character vector of color values in hex-format, valid color value names (see demo("colors")) or a name of a pre-defined color palette. Following options are valid for the colors argument:

• If not specified, a default color brewer palette will be used, which is suitable for the plot style.

• If "gs", a greyscale will be used.

• If "bw", and plot-type is a line-plot, the plot is black/white and uses different line types to distinguish groups (see this package-vignette).

• If colors is any valid color brewer palette name, the related palette will be used. Use RColorBrewer::display.brewer.all() to view all available palette names.

• There are some pre-defined color palettes in this package, see sjPlot-themes for details.

• Else specify own color values or names as vector (e.g. colors = "#00ff00" or colors = c("firebrick", "blue")).

Specifies the method to add a fitted line accross the data points. Possible values are for instance "lm", "glm", "loess" or "auto". If NULL, no line is plotted. fit.line adds a fitted line for the complete data, while fit.grps adds a fitted line for each subgroup of grp.

Logical, if TRUE, a marginal rug plot is displayed in the graph.

For Marginal Effects plots, shows or hides the legend.

Logical, if TRUE), adds notches to the box plot, which are used to compare groups; if the notches of two boxes do not overlap, medians are considered to be significantly different.

Numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend's title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend labels are displayed in one line and when a line break is inserted.

Numeric, between 0 and 1. If show.data = TRUE, you can add a small amount of random variation to the location of each data point. jitter then indicates the width, i.e. how much of a bin's width will be occupied by the jittered values.

Logical, if TRUE, overlapping points at same coordinates will be becomme larger, so point size indicates amount of overlapping.

Logical, if TRUE, multiple plots are plotted as grid layout.

Data frame, or a grouped data frame, with each column representing one item.

character vector, used as plot title. Depending on plot type and function, will be set automatically. If title = "", no title is printed. For effect-plots, may also be a character vector of length > 1, to define titles for each sub-plot or facet.

character vector, used as title for the plot legend.

character vector with labels for the guide/legend.

character vector of length one or two, defining the title(s) for the x-axis and y-axis.

character vector with labels used as axis labels. Optional argument, since in most cases, axis labels are set automatically.

Vector of weights that will be applied to weight all cases. Must be a vector of same length as the input vector. Default is NULL, so no weights are used.

Indicates whether the items should be ordered by by highest count of first or last category of items.

"first.asc"

to order ascending by lowest count of first category,

"first.desc"

to order descending by lowest count of first category,

"last.asc"

to order ascending by lowest count of last category,

"last.desc"

to order descending by lowest count of last category,

NULL

(default) for no sorting.

numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend's title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend labels are displayed in one line and when a line break is inserted.

size resp. width of the geoms (bar width, line thickness or point size, depending on plot type and function). Note that bar and bin widths mostly need smaller values than dot sizes.

user defined color for geoms. See 'Details' in plot_grpfrq.

Logical, whether percentage values should be plotted or not.

Logical, whether count values hould be plotted or not.

logical, if TRUE, adds total number of cases for each group or category to the labels.

Logical, if TRUE (default), the percentage values at the x-axis are shown.

logical, if TRUE, and depending on plot type and function, a legend is added to the plot.

numeric; sets the distance between breaks for the axis, i.e. at every grid.breaks'th position a major grid is being printed.

logical, if TRUE, the plot grid is expanded, i.e. there is a small margin between axes and plotting region. Default is FALSE.

Numeric, amount of digits after decimal point when rounding estimates or values.

character vector, indicating the vertical position of value labels. Allowed are same values as for vjust aesthetics from ggplot2: "left", "center", "right", "bottom", "middle", "top" and new options like "inward" and "outward", which align text towards and away from the center of the plot respectively.

logical, if TRUE, the x and y axis are swapped.

A vector of values (variable) describing the bars which make up the plot.

Grouping variable of same length as x, where x is grouped into the categories represented by grp.

Plot type. may be either "bar" (default) for bar charts, or "line" for line diagram.

Indicates which data of the proportional table should be plotted. Use "row" for calculating row percentages, "col" for column percentages and "cell" for cell percentages. If margin = "col", an additional bar with the total sum of each column can be added to the plot (see show.total).

Indicates whether bars should be positioned side-by-side (default), or stacked (bar.pos = "stack"). May be abbreviated.

character vector, used as plot title. Depending on plot type and function, will be set automatically. If title = "", no title is printed. For effect-plots, may also be a character vector of length > 1, to define titles for each sub-plot or facet.

Suffix (as string) for the title, if weight.by is specified, e.g. title.wtd.suffix=" (weighted)". Default is NULL, so title will not have a suffix when cases are weighted.

character vector of length one or two, defining the title(s) for the x-axis and y-axis.

character vector with labels used as axis labels. Optional argument, since in most cases, axis labels are set automatically.

character vector, used as title for the plot legend.

character vector with labels for the guide/legend.

Vector of weights that will be applied to weight all cases. Must be a vector of same length as the input vector. Default is NULL, so no weights are used.

Logical, if TRUE, order of categories (groups) is reversed.

Logical, whether values should be plotted or not.

logical, if TRUE, adds total number of cases for each group or category to the labels.

logical, if TRUE (default), percentage values are plotted to each bar If FALSE, percentage values are removed.

When margin = "col", an additional bar with the sum within each category and it's percentages will be added to each category.

logical, if TRUE, and depending on plot type and function, a legend is added to the plot.

logical, if TRUE (default), a summary with chi-squared statistics (see chisq.test), Cramer's V or Phi-value etc. is shown. If a cell contains expected values lower than five (or lower than 10 if df is 1), the Fisher's exact test (see fisher.test) is computed instead of chi-squared test. If the table's matrix is larger than 2x2, Fisher's exact test with Monte Carlo simulation is computed.

position of the model summary which is printed when show.summary is TRUE. Default is "r", i.e. it's printed to the upper right corner. Use "l" for upper left corner.

Logical, if TRUE and the variable's values are labeled, values / factor levels with no occurrence in the data are omitted from the output. If FALSE, labeled values that have no observations are still printed in the table (with frequency 0).

String for the legend label when a total-column is added. Only applies if show.total = TRUE. Default is "Total".

numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend's title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the legend labels are displayed in one line and when a line break is inserted.

size resp. width of the geoms (bar width, line thickness or point size, depending on plot type and function). Note that bar and bin widths mostly need smaller values than dot sizes.

the spacing between geoms (i.e. bar spacing)

user defined color for geoms. See 'Details' in plot_grpfrq.

Dot size, only applies, when argument type = "line".

prints a smooth line curve. Only applies, when argument type = "line".

numeric; sets the distance between breaks for the axis, i.e. at every grid.breaks'th position a major grid is being printed.

logical, if TRUE, the plot grid is expanded, i.e. there is a small margin between axes and plotting region. Default is FALSE.

numeric vector of length two, defining lower and upper axis limits of the y scale. By default, this argument is set to NULL, i.e. the y-axis fits to the required range of the data.

character vector, indicating the vertical position of value labels. Allowed are same values as for vjust aesthetics from ggplot2: "left", "center", "right", "bottom", "middle", "top" and new options like "inward" and "outward", which align text towards and away from the center of the plot respectively.

character vector, indicating the horizontal position of value labels. Allowed are same values as for vjust aesthetics from ggplot2: "left", "center", "right", "bottom", "middle", "top" and new options like "inward" and "outward", which align text towards and away from the center of the plot respectively.

numeric, offset for text labels when their alignment is adjusted to the top/bottom of the geom (see hjust and vjust).

logical, if TRUE, the x and y axis are swapped.

Name of the output file; filename must end with one of the following accepted file types: ".png", ".jpg", ".svg" or ".tif".

The plot that should be saved. By default, the last plot is saved.

Width of the figure, in centimetres.

Height of the figure, in centimetres.

Resolution in dpi (dots per inch). Ignored for vector formats, such as ".svg".

The default theme to use when saving the plot.

Color value for labels (axis, plot, etc.).

Fontsize of value labels inside plot area.

Fontsize of axis labels.

Fontsize of axis titles.

Fontsize of legend labels.

Fontsize of legend title.

Size of legend's item (legend key), in centimetres.

base theme where theme is built on. By default, all metrics from theme_gray() are used. See 'Details'.

base font family for the plot.

Color of plot title. Default is "black".

size of plot title. Default is 1.3.

alignment of plot title. Must be one of "left" (default), "center" or "right". You may use initial letter only.

numeric, vertical adjustment for plot title.

Color of geom outline. Only applies, if geom.outline.size is larger than 0.

size of bar outlines. Default is 0.1. Use size of 0 to remove geom outline.

size of outlines and median bar especially for boxplots. Default is 0.5. Use size of 0 to remove boxplot outline.

Color of outlines and median bar especially for boxplots. Only applies, if geom.boxoutline.size is larger than 0.

specifies the transparancy (alpha value) of geoms

linetype of line geoms. Default is 1 (solid line).

size (thickness) of error bars. Default is 0.8

linetype of error bars. Default is 1 (solid line).

Color of geom's value and annotation labels

size of geom's value and annotation labels

alpha level of geom's value and annotation labels

angle of geom's value and annotation labels

Color of x- and y-axis title labels

size of x- and y-axis title labels

numeric, vertical adjustment of x-axis-title.

numeric, vertical adjustment of y-axis-title.

angle for x-axis labels

angle for y-axis labels

angle for x- and y-axis labels. If set, overrides both axis.angle.x and axis.angle.y

Color for x-axis labels. If not specified, a default dark gray color palette will be used for the labels.

Color for y-axis labels. If not specified, a default dark gray color palette will be used for the labels.

Color for both x- and y-axis labels. If set, overrides both axis.textcolor.x and axis.textcolor.y

Color of x-axis border

Color of y-axis border

Color for both x- and y-axis borders. If set, overrides both axis.linecolor.x and axis.linecolor.y.

size (thickness) of axis lines. Only affected, if axis.linecolor is set.

size of x-axis labels

size of y-axis labels

size for both x- and y-axis labels. If set, overrides both axis.textsize.x and axis.textsize.y.

length of axis tick marks

Color of axis tick marks

margin between axis labels and tick marks

size of tick marks at x-axis.

size of tick marks at y-axis.

Color of the diagram's background

Color of whole diagram border (panel border)

Color of both diagram's border and background. If set, overrides both panel.bordercol and panel.backcol.

Color of the major grid lines of the diagram background

Color of the minor grid lines of the diagram background

Color for both minor and major grid lines of the diagram background. If set, overrides both panel.major.gridcol and panel.minor.gridcol.

See panel.gridcol.

See panel.gridcol.

line type for major grid lines

line type for minor grid lines

Color of the plot's background

Color of whole plot's border (panel border)

Color of both plot's region border and background. If set, overrides both plot.backcol and plot.bordercol.

numeric vector of length 4, indicating the top, right, bottom and left margin of the plot region.

position of the legend, if a legend is drawn.

legend outside plot

Use "bottom", "top", "left" or "right" to position the legend above, below, on the left or right side of the diagram. Right positioning is default.

legend inside plot

If legend.inside = TRUE, legend can be placed inside plot. Use "top left", "top right", "bottom left" and "bottom right" to position legend in any of these corners, or a two-element numeric vector with values from 0-1. See also legend.inside.

justification of legend, relative to its position ("center" or two-element numeric vector with values from 0-1. By default (outside legend), justification is centered. If legend is inside and justification not specified, legend justification is set according to legend position.

logical, use TRUE to put legend inside the plotting area. See legend.pos.

text size of the legend. Default is 1. Relative size, so recommended values are from 0.3 to 2.5

Color of the legend labels

text size of the legend title

Color of the legend title

font face of the legend title. By default, "bold" face is used.

fill color of the legend's background. Default is "white", so no visible background is drawn.

Color of the legend's border. Default is "white", so no visible border is drawn.

size of legend's item (legend key), in centimetres.

fill color of the legend's item-background. Default is "grey90".

Color of the legend's item-border. Default is "white".

Dependent variable. Will be used with following formula: aov(var.dep ~ var.grp)

Factor with the cross-classifying variable, where var.dep is grouped into the categories represented by var.grp.

Logical, if TRUE, the values reported are the true group mean values. If FALSE (default), the values are reported in the standard way, i.e. the values indicate the difference of the group mean in relation to the intercept (reference group).

character vector, used as plot title. Depending on plot type and function, will be set automatically. If title = "", no title is printed. For effect-plots, may also be a character vector of length > 1, to define titles for each sub-plot or facet.

character vector with labels used as axis labels. Optional argument, since in most cases, axis labels are set automatically.

Logical, if TRUE, order of categories (groups) is reversed.

Character vector that indicates the reference group (intercept), that is appended to the value label of the grouping variable. Default is "(Intercept)".

Character vector of length one or two (depending on the plot function and type), used as title(s) for the x and y axis. If not specified, a default labelling is chosen. Note: Some plot types may not support this argument sufficiently. In such cases, use the returned ggplot-object and add axis titles manually with labs. Use axis.title = "" to remove axis titles.

Numeric vector of length 2, defining the range of the plot axis. Depending on plot type, may effect either x- or y-axis, or both. For multiple plot outputs (e.g., from type = "eff" or type = "slope" in plot_model), axis.lim may also be a list of vectors of length 2, defining axis limits for each plot (only if non-faceted).

user defined color for geoms. See 'Details' in plot_grpfrq.

size resp. width of the geoms (bar width, line thickness or point size, depending on plot type and function). Note that bar and bin widths mostly need smaller values than dot sizes.

numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

numeric; sets the distance between breaks for the axis, i.e. at every grid.breaks'th position a major grid is being printed.

Logical, whether values should be plotted or not.

Numeric, amount of digits after decimal point when rounding estimates or values.

numeric, offset for text labels when their alignment is adjusted to the top/bottom of the geom (see hjust and vjust).

Logical, adds significance levels to values, or value and variable labels.

logical, if TRUE (default), a summary with chi-squared statistics (see chisq.test), Cramer's V or Phi-value etc. is shown. If a cell contains expected values lower than five (or lower than 10 if df is 1), the Fisher's exact test (see fisher.test) is computed instead of chi-squared test. If the table's matrix is larger than 2x2, Fisher's exact test with Monte Carlo simulation is computed.

A data frame with (dichotomous) factor variables.

character vector, used as plot title. Depending on plot type and function, will be set automatically. If title = "", no title is printed. For effect-plots, may also be a character vector of length > 1, to define titles for each sub-plot or facet.

character vector with labels used as axis labels. Optional argument, since in most cases, axis labels are set automatically.

numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

logical, if TRUE, and depending on plot type and function, a legend is added to the plot.

character vector, used as title for the plot legend.

Matrix with correlation coefficients as returned by the cor-function, or a data.frame of variables where correlations between columns should be computed.

character vector, used as plot title. Depending on plot type and function, will be set automatically. If title = "", no title is printed. For effect-plots, may also be a character vector of length > 1, to define titles for each sub-plot or facet.

character vector with labels used as axis labels. Optional argument, since in most cases, axis labels are set automatically.

Logical, if TRUE (default), the axis labels are sorted according to the correlation strength. If FALSE, axis labels appear in order of how variables were included in the cor-computation or data frame.

Indicates how many decimal values after comma are printed when the values labels are shown. Default is 3. Only applies when show.values = TRUE.

Indicates how missing values are treated. May be either "listwise" (default) or "pairwise". May be abbreviated.

Indicates the correlation computation method. May be one of "pearson" (default), "spearman" or "kendall". May be abbreviated.

user defined color for geoms. See 'Details' in plot_grpfrq.

numeric, determines how many chars of the plot title are displayed in one line and when a line break is inserted.

numeric, determines how many chars of the value, variable or axis labels are displayed in one line and when a line break is inserted.

logical, if TRUE, and depending on plot type and function, a legend is added to the plot.

character vector, used as title for the plot legend.

Logical, whether values should be plotted or not.

Logical, adds significance levels to values, or value and variable labels.

Logical, if TRUE, the p-values are printed as numbers. If FALSE (default), asterisks are used.

A vector, representing the response variable of a linear (mixed) model; or a linear (mixed) model as returned by lm or lmer.

If x is a vector, poly.term should also be a vector, representing the polynomial term (independent variabl) in the model; if x is a fitted model, poly.term should be the polynomial term's name as character string. See 'Examples'.

Numeric, or numeric vector, indicating the degree of the polynomial. If poly.degree is a numeric vector, multiple polynomial curves for each degree are plotted. See 'Examples'.

Logical, if TRUE, poly.term will be scaled before linear regression is computed. Default is FALSE. Scaling the polynomial term may have an impact on the resulting p-values.

Linear function when modelling polynomial terms. Use fun = "lm" for linear models, or fun = "glm" for generalized linear models. When x is not a vector, but a fitted model object, the function is detected automatically. If x is a vector, fun defaults to "lm".

Character vector of length one or two (depending on the plot function and type), used as title(s) for the x and y axis. If not specified, a default labelling is chosen. Note: Some plot types may not support this argument sufficiently. In such cases, use the returned ggplot-object and add axis titles manually with labs. Use axis.title = "" to remove axis titles.

user defined color for geoms. See 'Details' in plot_grpfrq.

size resp. width of the geoms (bar width, line thickness or point size, depending on plot type and function). Note that bar and bin widths mostly need smaller values than dot sizes.

Logical, if TRUE, an additional loess-smoothed line is plotted.

Logical, if TRUE, a confidence region for the loess-smoothed line will be plotted.

Logical, if TRUE (default), p-values for polynomial terms are printed to the console.

Logical, if TRUE (default), adds a scatter plot of data points to the plot.

Alpha value of point-geoms in the scatter plots. Only applies, if show.scatter = TRUE.

Color of of point-geoms in the scatter plots. Only applies, if show.scatter = TRUE.

Color of the loess-smoothed line. Only applies, if show.loess = TRUE.

A data frame. May also be a grouped data frame (see 'Note' and 'Examples').

Names of variables that should be plotted, and also further arguments passed down to the sjPlot-functions. See 'Examples'.

Plotting function. Refers to the function name of sjPlot-functions. See 'Details' and 'Examples'.