Movatterモバイル変換

Numeric, optional. If specified, a chi-squared distribution withdeg.f degreesof freedom is plotted and a shaded area atchi2 value position is plotted thatindicates whether or not the specified value is significant or not.If bothchi2 andp are not specified, a distribution without shadedarea is plotted.

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

Numeric, optional. If specified, a chi-squared distribution withdeg.f degreesof freedom is plotted and a shaded area at the position where the specified p-levelstarts is plotted. If bothchi2 andp are not specified, a distributionwithout shaded area is plotted.

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

user defined color for geoms. See 'Details' inplot_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 withdeg.f1 anddeg.f2 degreesof freedom is plotted and a shaded area atf value position is plotted thatindicates whether or not the specified value is significant or not.If bothf andp are not specified, a distribution without shadedarea is plotted.

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

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

Numeric, optional. If specified, a F distribution withdeg.f1 anddeg.f2 degreesof freedom is plotted and a shaded area at the position where the specified p-levelstarts is plotted. If bothf andp are not specified, a distributionwithout shaded area is plotted.

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

user defined color for geoms. See 'Details' inplot_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 withmean andsdis plotted and a shaded area atnorm value position is plotted thatindicates whether or not the specified value is significant or not.If bothnorm andp are not specified, a distribution without shadedarea 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 withmean andsdis plotted and a shaded area at the position where the specified p-levelstarts is plotted. If bothnorm andp are not specified, a distributionwithout shaded area is plotted.

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

user defined color for geoms. See 'Details' inplot_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 withdeg.f degreesof freedom is plotted and a shaded area att value position is plotted thatindicates whether or not the specified value is significant or not.If botht andp are not specified, a distribution without shadedarea is plotted.

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

Numeric, optional. If specified, a t-distribution withdeg.f degreesof freedom is plotted and a shaded area at the position where the specified p-levelstarts is plotted. If botht andp are not specified, a distributionwithout shaded area is plotted.

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

user defined color for geoms. See 'Details' inplot_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 forfurther processing. Required, ifdata is a data frame (and novector) and only selected variables fromdata should be processed.You may also use functions like: or tidyselect'sselect_helpers.

Character vector, used as plot title. By default,response_labels is called to retrieve the label ofthe dependent variable, which will be used as title. Usetitle = ""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 isNULL, so no weights are used.

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

Determines whether categories should be sortedaccording to their frequencies or not. Default is"none", socategories 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 mostlyneed smaller values than dot sizes.

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

Color of confidence interval bars (error bars).Only applies totype = "bar". In case of dot plots, error barswill have same colors as dots (seegeom.colors).

Character vector of length one or two (depending onthe 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 suchcases, use the return value and add axis titles manually withlabs, e.g.:$plot.list[[1]] + ggplot2::labs(x = ...)

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

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

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

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

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

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

logical, ifTRUE, the plot grid is expanded, i.e. there is a small margin betweenaxes and plotting region. Default isFALSE.

Logical, whether values should be plotted or not.

logical, ifTRUE, adds total number of cases for eachgroup or category to the labels.

logical, ifTRUE (default), percentage values are plotted to each barIfFALSE, percentage values are removed.

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

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

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

Logical, ifTRUE, a vertical line in histogramsis drawn to indicate the mean value of the variables. Onlyapplies to histogram-charts.

Logical, ifTRUE (default), the mean valueis printed to the vertical line that indicates the variable'smean. Only applies to histogram-charts.

Logical, ifTRUE, the standard deviationis annotated as shaded rectangle around the mean interceptline. Only applies to histogram-charts.

Logical, ifTRUE and the variable's values are labeled, values / factorlevels with no occurrence in the data are omitted from the output. IfFALSE,labeled values that have no observations are still printed in the table (with frequency0).

Numeric value, indicating the linetype of the meanintercept line. Only applies to histogram-charts andwhenshow.mean = TRUE.

Numeric, size of the mean intercept line. Onlyapplies to histogram-charts and whenshow.mean = TRUE.

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

size of mean dot insie a violin or box plot. Applies onlywhentype = "violin" or"boxplot".

Logical, ifTRUE, a normal curve, which is adjusted to the data,is plotted over the histogram or density plot. Default isFALSE. Only applies when histograms or density plots are plotted (seetype).

Color of the normal curve line. Onlyapplies ifnormal.curve = TRUE.

Numeric, size of the normal curve line. Onlyapplies ifnormal.curve = TRUE.

Transparancy level (alpha value) of the normal curve. Onlyapplies ifnormal.curve = TRUE.

numeric value, indicating the minimum amount of unique valuesin the count variable, at which automatic grouping into smaller unitsis done (seegroup_var). Default value forauto.group isNULL, i.e. auto-grouping is off.Seegroup_var for examples on grouping.

logical, ifTRUE, the x and y axis are swapped.

character vector, indicating the vertical position of valuelabels. Allowed are same values as forvjust aesthetics fromggplot2: "left", "center", "right", "bottom", "middle", "top" andnew options like "inward" and "outward", which align text towards andaway from the center of the plot respectively.

character vector, indicating the horizontal position of valuelabels. Allowed are same values as forvjust aesthetics fromggplot2: "left", "center", "right", "bottom", "middle", "top" andnew options like "inward" and "outward", which align text towards andaway from the center of the plot respectively.

numeric, offset for text labels when their alignment is adjustedto the top/bottom of the geom (seehjust andvjust).

A data frame, or a grouped data frame.

Categorical variable, where the proportion of each category inx for the highest category ofy will be printedalong the x-axis.

Categorical or numeric variable. If not a binary variable,ywill be recoded into a binary variable, dichtomized at the highestcategory and all remaining categories.

Grouping variable, which will define the y-axis

May be a character vector of color values in hex-format, validcolor value names (seedemo("colors")) or a name of a pre-definedcolor palette. Following options are valid for thecolors 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 (seethis package-vignette).

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

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

• Else specify own color values or names as vector (e.g.colors = "#00ff00" orcolors = 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 mostlyneed smaller values than dot sizes.

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

Numeric vector with shape styles, used to map the differentcategories ofx.

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

character vector with labels used as axis labels. Optionalargument, 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 thathave a legend.

character vector with labels for the guide/legend.

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

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

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

numeric, determines how many chars of the legend labels aredisplayed 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., fromtype = "eff" ortype = "slope" inplot_model),axis.lim mayalso be a list of vectors of length 2, defining axis limits for eachplot (only if non-faceted).

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

Logical, ifTRUE, a total summary line for all aggregatedgrp is added.

Logical, ifTRUE andshow.total = TRUE,the total-row in the figure will be highlighted with a slightlyshaded background.

Logical, adds significance levels to values, or value andvariable labels.

logical, ifTRUE, adds total number of cases for eachgroup or category to the labels.

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

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

Add tags to your subfigures. Can beTRUE (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, wherevar.cntis grouped into the categories represented byvar.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 isNULL, so no weights are used.

An interaction variable which can be used for box plots. Divides each category indicatedbyvar.grp into the factors ofintr.var, so that each category ofvar.grpis subgrouped intointr.var's categories. Only applies whentype = "boxplot" ortype = "violin".

character vector, used as plot title. Depending on plot type and function,will be set automatically. Iftitle = "", 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, ifweight.by is specified,e.g.title.wtd.suffix=" (weighted)". Default isNULL, sotitle 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. Optionalargument, 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 breakswhen having interaction variables included.These labels replace theaxis.labels. Only applies, when using box or violin plots(i.e.type = "boxplot" or"violin") andintr.var is notNULL.

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

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

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

numeric, determines how many chars of the legend labels aredisplayed 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 mostlyneed smaller values than dot sizes.

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

user defined color for geoms. See 'Details' inplot_grpfrq.

Logical, whether values should be plotted or not.

logical, ifTRUE, adds total number of cases for eachgroup or category to the labels.

logical, ifTRUE (default), percentage values are plotted to each barIfFALSE, percentage values are removed.

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

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

logical, ifTRUE, the count within each group is addedto the category labels (e.g."Cat 1 (n=87)"). Default value isFALSE.

logical, ifTRUE, and depending on plot type andfunction, a legend is added to the plot.

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

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

Logical, ifTRUE and the variable's values are labeled, values / factorlevels with no occurrence in the data are omitted from the output. IfFALSE,labeled values that have no observations are still printed in the table (with frequency0).

numeric value, indicating the minimum amount of unique valuesin the count variable, at which automatic grouping into smaller unitsis done (seegroup_var). Default value forauto.group isNULL, i.e. auto-grouping is off.Seegroup_var for examples on grouping.

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

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

logical, ifTRUE, the plot grid is expanded, i.e. there is a small margin betweenaxes and plotting region. Default isFALSE.

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

size of mean dot insie a violin or box plot. Applies onlywhentype = "violin" or"boxplot".

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

logical, ifTRUE, the groups of dots in a dot-plot are highlightedwith a shaded rectangle.

position of the model summary which is printed whenshow.summaryisTRUE. 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 plotsin a grid of an integrated single plot. This argument callsfacet_wrap orfacet_gridto arrange plots. Useplot_grid to plot multiple plot-objectsas an arranged grid withgrid.arrange.

logical, ifTRUE, the x and y axis are swapped.

numeric, offset for text labels when their alignment is adjustedto the top/bottom of the geom (seehjust andvjust).

character vector, indicating the vertical position of valuelabels. Allowed are same values as forvjust aesthetics fromggplot2: "left", "center", "right", "bottom", "middle", "top" andnew options like "inward" and "outward", which align text towards andaway from the center of the plot respectively.

character vector, indicating the horizontal position of valuelabels. Allowed are same values as forvjust aesthetics fromggplot2: "left", "center", "right", "bottom", "middle", "top" andnew options like "inward" and "outward", which align text towards andaway from the center of the plot respectively.

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

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

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

character vector, used as plot title. Depending on plot type and function,will be set automatically. Iftitle = "", 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. Optionalargument, since in most cases, axis labels are set automatically.

optional, amount of categories ofitems (e.g."strongly disagree","disagree", "agree" and"strongly agree" would becatcount = 4).Note that this argument only applies to "valid" answers, i.e. if youhave an additional neutral category (seecat.neutral) like"don't know",this won't count forcatcount (e.g. "strongly disagree","disagree", "agree", "strongly agree" and neutral category "don't know"would still mean thatcatcount = 4). See 'Note'.

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

Indicates whether the items ofitems should be ordered bytotal 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 isNULL, so no weights are used.

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

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

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

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

numeric, determines how many chars of the legend labels aredisplayed 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 mostlyneed smaller values than dot sizes.

user defined color for geoms. See 'Details' inplot_grpfrq.

Color of the neutral category, if plotted (seecat.neutral).

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

logical, ifTRUE, the color scale fromgeom.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, ifTRUE, adds total number of cases for eachgroup or category to the labels.

logical, ifTRUE, and depending on plot type andfunction, a legend is added to the plot.

logical, ifTRUE, %-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 becausethey 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 everygrid.breaks'th position a major grid is being printed.

logical, ifTRUE, the plot grid is expanded, i.e. there is a small margin betweenaxes and plotting region. Default isFALSE.

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

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

logical, ifTRUE, 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 togroups. Defaults toTRUE.

(optional, only used if groups are supplied) Defines the legend position. Possible values arec("bottom", "top", "both", "all", "none").If the is only one group or this option is set to"all" legends will be printed as defined withset_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 itemsor due to legend placement. This can be adjusted here. Takes a vector of numbers, onefor each plot. Values are evaluated relative to each other.

(optional, only used if groups are supplied) List of options to be passed toguide_legend.The most notable options arebyrow=T (default), this will order the categories row wise.And withgroup.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 toplot_grid.

A regression model object. Depending on thetype, manykinds of models are supported, e.g. from packages likestats,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 modelonly contains one predictor, slope-line is plotted.

type = "re"

For mixed effects models, plots the randomeffects.

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) forspecific model terms. Seeggpredict for details.

type = "eff"

Similar totype = "pred", however,discrete predictors are held constant at their proportions (not referencelevel). Seeggeffect for details.

type = "emm"

Similar totype = "eff", seeggemmeans for details.

type = "int"

Marginal effects of interaction terms inmodel.

Model diagnostics

type = "slope"

Slope of coefficients for each singlepredictor, against the response (linear relationship between each modelterm and response). See 'Details'.

type = "resid"

Slope of coefficients for each singlepredictor, against the residuals (linear relationship between each modelterm and residuals). See 'Details'.

type = "diag"

Check model assumptions. See 'Details'.

Note: For mixed models, the diagnostic plots like linear relationshipor check for Homoscedasticity, donot take the uncertainty ofrandom effects into account, but is only based on the fixed effects partof the model.

A character vector, naming a function that will be appliedon estimates and confidence intervals. By default,transform willautomatically use"exp" as transformation for applicable classes ofmodel (e.g. logistic or poisson regression). Estimates of linearmodels remain untransformed. UseNULL if you want the raw,non-transformed estimates.

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

Coefficients

Select terms that should be plotted. All otherterm are removed from the output. Note that the term names must matchthe names of the model's coefficients. For factors, this means thatthe variable name is suffixed with the related factor level, and eachcategory counts as one term. E.g.rm.terms = "t_name [2,3]"would remove the terms"t_name2" and"t_name3" (assumingthat the variablet_name is categorical and has at leastthe factor levels2 and3). Another example for theiris-dataset:terms = "Species" would not work, insteadyou would writeterms = "Species [versicolor,virginica]" toremove these two levels, orterms = "Speciesversicolor" if youjust want to remove the levelversicolor from the plot.

Marginal Effects

Hereterms indicates for whichterms marginal effects should be displayed. At least one term isrequired to calculate effects, maximum length is three terms, wherethe second and third term indicate the groups, i.e. predictions offirst term are grouped by the levels of the second (and third) term.terms may also indicate higher order terms (e.g. interactionterms). Indicating levels in square brackets allows for selecting onlyspecific groups. Term name and levels in brackets must be separated bya whitespace character, e.g.terms = c("age", "education [1,3]").It is also possible to specify a range of numeric values for thepredictions with a colon, for instanceterms = 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 weretransformed for fitting the model and should be back-transformed to theoriginal scale for predictions. Finally, numeric vectors for which nospecific values are given, a "pretty range" is calculated, to avoidmemory allocation problems for vectors with many unique values. If anumeric vector is specified as second or third term (i.e. if this vectorrepresents a grouping structure), representative values (seevalues_at) are chosen. If all values for anumeric vector should be used to compute predictions, you may usee.g. terms = "age [all]". For more details, seeggpredict.

Determines in which way estimates are sorted in the plot:

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

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

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

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

Character vector with names that indicate which terms shouldbe removed from the plot. Counterpart toterms.rm.terms ="t_name" would remove the termt_name. Default isNULL, i.e.all terms are used. For factors, levels that should be removed from the plotneed to be explicitely indicated in square brackets, and match the model'scoefficient names, e.g.rm.terms = "t_name [2,3]" would remove the terms"t_name2" and"t_name3" (assuming that the variablet_namewas categorical and has at least the factor levels2 and3).Another example for theiris dataset would berm.terms = "Species [versicolor,virginica]". Note that therm.terms-argument does not apply toMarginal 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 coefficientsshould be plotted. See examples inthis package-vignette.

Character, only applies forMarginal Effects plotswith mixed effects models. Indicates whether predicted values should beconditioned on random effects (pred.type = "re") or fixed effectsonly (pred.type = "fe", the default). For details, see documentationof thetype-argument inggpredict.

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

"minmax"

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

"meansd"

uses themean value of the moderator as well as one standard deviation below andabove mean value to plot the effect of the moderator on the independentvariable (following the convention suggested by Cohen and Cohen andpopularized by Aiken and West (1991), i.e. using the mean, the value onestandard deviation above, and the value one standard deviation below themean as values of the moderator, seeGrace-MartinK: 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 beuseful for predictors that don't have an empirical zero-value, but absenceof moderation should be simulated by using 0 as minimum.

"quart"

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

"all"

uses all values of themoderator variable.

Numeric vector. Iftype = "re" and fitted model has morethan one random intercept,ri.nr indicates which random effects ofwhich random intercept (or: which list elements ofranef) will be plotted. Default isNULL, so allrandom effects will be plotted.

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

Character vector of length one or two (depending on theplot function and type), used as title(s) for the x and y axis. If notspecified, a default labelling is chosen.Note: Some plot typesmay not support this argument sufficiently. In such cases, use the returnedggplot-object and add axis titles manually withlabs. Useaxis.title = "" to remove axistitles.

Character vector with labels for the model terms, used asaxis labels. By default,term_labels iscalled to retrieve the labels of the coefficients, which will be used asaxis labels. Useaxis.labels = "" orauto.label = FALSE touse the variable names as labels instead. Ifaxis.labels is a namedvector, axis labels (by default, the names of the model's coefficients)will be matched with the names ofaxis.label. This ensures thatlabels always match the related axis value, no matter in which wayaxis labels are sorted.

Character vector, used as legend title for plots thathave a legend.

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

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

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

Numeric value or vector; ifgrid.breaks is asingle value, sets the distance between breaks for the axis at everygrid.breaks'th position, where a major grid line is plotted. Ifgrid.breaks is a vector, values will be used to define theaxis positions of the major grid lines.

Numeric, the level of the confidence intervals (error bars).Useci.lvl = NA to remove error bars. Forstanreg-models,ci.lvl defines the (outer) probability for thecredible intervalthat is plotted (seeci). Bydefault,stanreg-models are printed with two intervals: the "inner"interval, which defaults to the 50%-CI; and the "outer" interval, whichdefaults to the 89%-CI.ci.lvl affects only the outer interval insuch cases. Seeprob.inner andprob.outer under the...-argument for more details.

Logical, ifTRUE, the standard errors arealso printed. If robust standard errors are required, use argumentsvcov.fun andvcov.args (seestandard_error for details).se overridesci.lvl: if notNULL, argumentsci.lvl andtransformwill be ignored. Currently,se only applies toCoefficients plots.

Variance-covariance matrix used to compute uncertaintyestimates (e.g., for robust standard errors). This argument accepts acovariance matrix, a function which returns a covariance matrix, or astring which identifies the function to be used to compute the covariancematrix. Seemodel_parameters().

List of arguments to be passed to the function identified bythevcov.fun argument. This function is typically supplied by thesandwich orclubSandwich packages. Please refer to theirdocumentation (e.g.,?sandwich::vcovHAC) to see the list ofavailable arguments.

May be a character vector of color values in hex-format, validcolor value names (seedemo("colors")) or a name of a pre-definedcolor palette. Following options are valid for thecolors 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 (seethis package-vignette).

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

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

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

Logical, ifTRUE, the intercept of the fittedmodel is also plotted. Default isFALSE. Iftransform ="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 ofestimates to the value labels.

Logical, forMarginal Effects plots, also plots theraw data points.

ForMarginal Effects plots, shows or hides thelegend.

Logical, ifTRUE, shows the zero-inflation part ofhurdle- or zero-inflated models.

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

Numeric, indicates the size of value labels. Can be usedfor all plot types where the argumentshow.values is applicable,e.g.value.size = 4.

Numeric, between 0 and 1. Ifshow.data = TRUE, you canadd 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 widthwill be occupied by the jittered values.

Numeric, amount of digits after decimal point when roundingestimates 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 isinherited from the current theme.

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

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

String value, if notNULL, indicates the methodto adjust p-values. Seep.adjust for details.

Logical, ifTRUE, multiple plots are plotted as gridlayout.

Desired target case. Labels will automatically converted into thespecified character case. Seesnakecase::to_any_case() for moredetails on this argument. By default, ifcase is not specified,it will be set to"parsed", unlessprefix.labels is not"none". Ifprefix.labels is either"label" (or"l") or"varname" (or"v") andcase is notspecified, it will be set toNULL - this is a more convenientdefault when prefixing labels.

Logical, ifTRUE (the default),anddata is labelled,term_labels is called to retrieve the labelsof the coefficients, which will be used as predictor labels. If data isnot labelled,format_parameters()is used to create pretty labels. Ifauto.label = FALSE,original variable names and value labels (factor levels) are used.

Indicates whether the value labels of categorical variablesshould be prefixed, e.g. with the variable name or variable label. Seeargumentprefix interm_labels fordetails.

ForStan-models (fitted with therstanarm- orbrms-package), the Bayesian point estimate is, by default, the medianof the posterior distribution. Usebpe to define other functions tocalculate the Bayesian point estimate.bpe needs to be a characternaming the specific function, which is passed to thefun-argument intypical_value. So,bpe = "mean" wouldcalculate the mean value of the posterior distribution.

ForStan-models (fitted with therstanarm- orbrms-package), the Bayesian point estimate is indicated as a small,vertical line by default. Usebpe.style = "dot" to plot a dotinstead of a line for the point estimate.

Character vector, indicating the color of the Bayesianpoint estimate. Settingbpe.color = NULL will inherit the colorfrom the mapped aesthetic to match it with the geom's color.

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

Logical, whether the response variable will also bestandardized if standardized coefficients are requested. Setting bothstd.response = TRUE andshow.std = TRUE will behave as ifthe complete data was standardized before fitting the model.

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

prob.inner andprob.outer

ForStan-models(fitted with therstanarm- orbrms-package) and coefficientsplot-types, you can specify numeric values between 0 and 1 forprob.inner andprob.outer, which will then be used as innerand outer probabilities for the uncertainty intervals (HDI). By default,the inner probability is 0.5 and the outer probability is 0.89 (unlessci.lvl is specified - in this case,ci.lvl is used as outerprobability).

size.inner

ForStan-models andCoefficientsplot-types, you can specify the width of the bar for the innerprobabilities. Default is0.1. Settingsize.inner = 0removes the inner probability regions.

width,alpha, andscale

Passeddown toggplot2::geom_errorbar() orgeom_density_ridges(), forforest or diagnostic plots.

width,alpha,dot.alpha,dodge andlog.y

Passeddown toplot.ggeffects forMarginal Effectsplots.

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 toggpredict,ggeffect orplot.ggeffects.

Case conversion of labels

For case conversion of labels (see argumentcase), argumentssep_in andsep_out will be passeddown tosnakecase::to_any_case(). This onlyapplies to automatically retrieved term labels,not ifterm labels are provided by theaxis.labels-argument.

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

A character vector, naming a function that will be appliedon estimates and confidence intervals. By default,transform willautomatically use"exp" as transformation for applicable classes ofmodel (e.g. logistic or poisson regression). Estimates of linearmodels remain untransformed. UseNULL if you want the raw,non-transformed estimates.

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

Logical, whether the response variable will also bestandardized if standardized coefficients are requested. Setting bothstd.response = TRUE andshow.std = TRUE will behave as ifthe complete data was standardized before fitting the model.

Character vector with names that indicate which terms shouldbe removed from the plot. Counterpart toterms.rm.terms ="t_name" would remove the termt_name. Default isNULL, i.e.all terms are used. For factors, levels that should be removed from the plotneed to be explicitely indicated in square brackets, and match the model'scoefficient names, e.g.rm.terms = "t_name [2,3]" would remove the terms"t_name2" and"t_name3" (assuming that the variablet_namewas categorical and has at least the factor levels2 and3).Another example for theiris dataset would berm.terms = "Species [versicolor,virginica]". Note that therm.terms-argument does not apply toMarginal Effects plots.

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

Character vector, used to indicate the different modelsin the plot's legend. If not specified, the labels of the dependentvariables for each model are used.

Character vector, used as legend title for plots thathave a legend.

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

Character vector with labels for the model terms, used asaxis labels. By default,term_labels iscalled to retrieve the labels of the coefficients, which will be used asaxis labels. Useaxis.labels = "" orauto.label = FALSE touse the variable names as labels instead. Ifaxis.labels is a namedvector, axis labels (by default, the names of the model's coefficients)will be matched with the names ofaxis.label. This ensures thatlabels always match the related axis value, no matter in which wayaxis labels are sorted.

Character vector of length one or two (depending on theplot function and type), used as title(s) for the x and y axis. If notspecified, a default labelling is chosen.Note: Some plot typesmay not support this argument sufficiently. In such cases, use the returnedggplot-object and add axis titles manually withlabs. Useaxis.title = "" to remove axistitles.

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

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

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

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

Numeric value or vector; ifgrid.breaks is asingle value, sets the distance between breaks for the axis at everygrid.breaks'th position, where a major grid line is plotted. Ifgrid.breaks is a vector, values will be used to define theaxis 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 usedfor all plot types where the argumentshow.values is applicable,e.g.value.size = 4.

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

May be a character vector of color values in hex-format, validcolor value names (seedemo("colors")) or a name of a pre-definedcolor palette. Following options are valid for thecolors 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 (seethis package-vignette).

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

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

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

Logical, whether values should be plotted or not.

ForMarginal Effects plots, shows or hides thelegend.

Logical, ifTRUE, the intercept of the fittedmodel is also plotted. Default isFALSE. Iftransform ="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 ofestimates to the value labels.

Logical, ifTRUE, significant levels are distinguished bydifferent point shapes and a related legend is plotted. DefaultisFALSE.

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

String value, if notNULL, indicates the methodto adjust p-values. Seep.adjust for details.

Numeric, the level of the confidence intervals (error bars).Useci.lvl = NA to remove error bars. Forstanreg-models,ci.lvl defines the (outer) probability for thecredible intervalthat is plotted (seeci). Bydefault,stanreg-models are printed with two intervals: the "inner"interval, which defaults to the 50%-CI; and the "outer" interval, whichdefaults to the 89%-CI.ci.lvl affects only the outer interval insuch cases. Seeprob.inner andprob.outer under the...-argument for more details.

Variance-covariance matrix used to compute uncertaintyestimates (e.g., for robust standard errors). This argument accepts acovariance matrix, a function which returns a covariance matrix, or astring which identifies the function to be used to compute the covariancematrix. Seemodel_parameters().

List of arguments to be passed to the function identified bythevcov.fun argument. This function is typically supplied by thesandwich orclubSandwich packages. Please refer to theirdocumentation (e.g.,?sandwich::vcovHAC) to see the list ofavailable arguments.

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

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

Logical, ifTRUE, multiple plots are plotted as gridlayout.

Logical, ifTRUE (the default),anddata is labelled,term_labels is called to retrieve the labelsof the coefficients, which will be used as predictor labels. If data isnot labelled,format_parameters()is used to create pretty labels. Ifauto.label = FALSE,original variable names and value labels (factor levels) are used.

Indicates whether the value labels of categorical variablesshould be prefixed, e.g. with the variable name or variable label. Seeargumentprefix interm_labels fordetails.

Fitted linear (mixed) regression model (including objects of classgls orplm).

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 mostlyneed smaller values than dot sizes.

Numeric vector with indices (order equals to row index ofcoef(fit))or character vector with coefficient names that indicate which estimates should be removedfrom 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 estimateest_name. DefaultisNULL, i.e. all estimates are printed.

Logical, ifTRUE, a line connecting predicted andresidual values is plotted. Set this argument toFALSE, ifplot-building is too time consuming.

Logical, ifTRUE, residual values are plotted.

Logical, ifTRUE, predicted values are plotted.

Logical, ifTRUE), adds notches to the box plot, which areused 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, thescatter plot will be grouped. See 'Examples'.

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

Character vector, used as legend title for plots thathave a legend.

character vector with labels for the guide/legend.

Character vector with names for each coordinate pair givenbyx andy, so text labels are added to the plot.Must be of same length asx andy.Ifdot.labels has a different length, data points will be trimmedto matchdot.labels. Ifdot.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 argumentdot.labels is used.

May be a character vector of color values in hex-format, validcolor value names (seedemo("colors")) or a name of a pre-definedcolor palette. Following options are valid for thecolors 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 (seethis package-vignette).

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

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

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

Specifies the method to add a fitted line accrossthe data points. Possible values are for instance"lm","glm","loess" or"auto". IfNULL, no line is plotted.fit.line adds a fitted line for the complete data, whilefit.grpsadds a fitted line for each subgroup ofgrp.

Logical, ifTRUE, a marginal rug plot is displayedin the graph.

ForMarginal Effects plots, shows or hides thelegend.

Logical, ifTRUE), adds notches to the box plot, which areused 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 aredisplayed in one line and when a line break is inserted.

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

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

Numeric, between 0 and 1. Ifshow.data = TRUE, you canadd 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 widthwill be occupied by the jittered values.

Logical, ifTRUE, overlapping points at same coordinateswill be becomme larger, so point size indicates amount of overlapping.

Logical, ifTRUE, multiple plots are plotted as gridlayout.

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. Iftitle = "", 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. Optionalargument, 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 isNULL, so no weights are used.

Indicates whether theitems should be ordered byby highest count of first or last category ofitems.

"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 inone line and when a line break is inserted.

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

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

numeric, determines how many chars of the legend labels aredisplayed 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 mostlyneed smaller values than dot sizes.

user defined color for geoms. See 'Details' inplot_grpfrq.

Logical, whether percentage values should be plotted or not.

Logical, whether count values hould be plotted or not.

logical, ifTRUE, adds total number of cases for eachgroup or category to the labels.

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

logical, ifTRUE, and depending on plot type andfunction, a legend is added to the plot.

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

logical, ifTRUE, the plot grid is expanded, i.e. there is a small margin betweenaxes and plotting region. Default isFALSE.

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

character vector, indicating the vertical position of valuelabels. Allowed are same values as forvjust aesthetics fromggplot2: "left", "center", "right", "bottom", "middle", "top" andnew options like "inward" and "outward", which align text towards andaway from the center of the plot respectively.

logical, ifTRUE, 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 asx, wherexis grouped into the categories represented bygrp.

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" forcalculating row percentages,"col" for column percentages and"cell" for cell percentages.Ifmargin = "col", an additional bar with the total sum of each columncan be added to the plot (seeshow.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. Iftitle = "", 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, ifweight.by is specified,e.g.title.wtd.suffix=" (weighted)". Default isNULL, sotitle 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. Optionalargument, 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 isNULL, so no weights are used.

Logical, ifTRUE, order of categories (groups) is reversed.

Logical, whether values should be plotted or not.

logical, ifTRUE, adds total number of cases for eachgroup or category to the labels.

logical, ifTRUE (default), percentage values are plotted to each barIfFALSE, percentage values are removed.

Whenmargin = "col", an additional barwith the sum within each category and it's percentages will be addedto each category.

logical, ifTRUE, and depending on plot type andfunction, a legend is added to the plot.

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

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

Logical, ifTRUE and the variable's values are labeled, values / factorlevels with no occurrence in the data are omitted from the output. IfFALSE,labeled values that have no observations are still printed in the table (with frequency0).

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

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

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

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

numeric, determines how many chars of the legend labels aredisplayed 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 mostlyneed smaller values than dot sizes.

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

user defined color for geoms. See 'Details' inplot_grpfrq.

Dot size, only applies, when argumenttype = "line".

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

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

logical, ifTRUE, the plot grid is expanded, i.e. there is a small margin betweenaxes and plotting region. Default isFALSE.

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

character vector, indicating the vertical position of valuelabels. Allowed are same values as forvjust aesthetics fromggplot2: "left", "center", "right", "bottom", "middle", "top" andnew options like "inward" and "outward", which align text towards andaway from the center of the plot respectively.

character vector, indicating the horizontal position of valuelabels. Allowed are same values as forvjust aesthetics fromggplot2: "left", "center", "right", "bottom", "middle", "top" andnew options like "inward" and "outward", which align text towards andaway from the center of the plot respectively.

numeric, offset for text labels when their alignment is adjustedto the top/bottom of the geom (seehjust andvjust).

logical, ifTRUE, the x and y axis are swapped.

Name of the output file; filename must end with oneof 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, allmetrics fromtheme_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, ifgeom.outline.sizeis larger than 0.

size of bar outlines. Default is 0.1. Usesize of0 to remove geom outline.

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

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

specifies the transparancy (alpha value) of geoms

linetype of line geoms. Default is1 (solid line).

size (thickness) of error bars. Default is0.8

linetype of error bars. Default is1 (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 bothaxis.angle.x andaxis.angle.y

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

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

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

Color of x-axis border

Color of y-axis border

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

size (thickness) of axis lines. Only affected, ifaxis.linecoloris set.

size of x-axis labels

size of y-axis labels

size for both x- and y-axis labels.If set, overrides bothaxis.textsize.x andaxis.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 bothpanel.bordercol andpanel.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 bothpanel.major.gridcol andpanel.minor.gridcol.

Seepanel.gridcol.

Seepanel.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 bothplot.backcol andplot.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 sideof the diagram. Right positioning is default.

legend inside plot

Iflegend.inside = TRUE, legend can be placed insideplot. 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 alsolegend.inside.

justification of legend, relative to its position ("center" ortwo-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, useTRUE to put legend inside the plotting area. Seelegend.pos.

text size of the legend. Default is 1. Relative size, sorecommended 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".

Base font size.

Base font family.

Font size for plot titles.

Font size for x-axis titles.

Font size for y-axis titles.

Font size for x-axis labels.

Font size for y-axis labels.

Offset for x-axis titles.

Offset for y-axis titles.

Optional ggplot-theme-object, which is needed in case multiplefunctions should be combined, e.g.theme_sjplot() + label_angle().In such cases, uselabel_angle(base.theme = theme_sjplot()).

Angle for x-axis labels.

Angle for y-axis labels.

Logical, useTRUE to put legend inside the plotting area.See alsopos.

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 sideof the diagram.

Legend inside plot

Ifinside = TRUE, legend can be placed insideplot. 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 alsoinside.

Justification of legend, relative to its position ("center" ortwo-element numeric vector with values from 0-1.

Character name of color palette.

Logical, ifTRUE, a discrete colour palette is returned.Else, a gradient palette is returned, where colours of the requested paletteare interpolated usingcolorRampPalette.

Logical, ifTRUE, order of returned colours is reversed.

Further arguments passed down to ggplot'sscale()-functions.

Numeric, number of colors to be returned. By default, the completecolour palette is returned.

Name of the CSS pre-set theme-style. Can be used for table-functions.

A data frame with (dichotomous) factor variables.

character vector, used as plot title. Depending on plot type and function,will be set automatically. Iftitle = "", 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. Optionalargument, since in most cases, axis labels are set automatically.

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

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

logical, ifTRUE, and depending on plot type andfunction, a legend is added to the plot.

character vector, used as title for the plot legend.

A vector, representing the response variable of a linear (mixed) model; ora linear (mixed) model as returned bylm orlmer.

Ifx is a vector,poly.term should also be a vector, representingthe polynomial term (independent variabl) in the model; ifx is afitted 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.Ifpoly.degree is a numeric vector, multiple polynomial curves foreach degree are plotted. See 'Examples'.

Logical, ifTRUE,poly.term will be scaled beforelinear regression is computed. Default isFALSE. Scaling the polynomialterm may have an impact on the resulting p-values.

Linear function when modelling polynomial terms. Usefun = "lm"for linear models, orfun = "glm" for generalized linear models.Whenx is not a vector, but a fitted model object, the functionis detected automatically. Ifx is a vector,fun defaultsto"lm".

Character vector of length one or two (depending on theplot function and type), used as title(s) for the x and y axis. If notspecified, a default labelling is chosen.Note: Some plot typesmay not support this argument sufficiently. In such cases, use the returnedggplot-object and add axis titles manually withlabs. Useaxis.title = "" to remove axistitles.

user defined color for geoms. See 'Details' inplot_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 mostlyneed smaller values than dot sizes.

Logical, ifTRUE, an additional loess-smoothed line is plotted.

Logical, ifTRUE, a confidence region for the loess-smoothed linewill be plotted.

Logical, ifTRUE (default), p-values for polynomial terms areprinted to the console.

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

Alpha value of point-geoms in the scatter plots. Onlyapplies, ifshow.scatter = TRUE.

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

Color of the loess-smoothed line. Only applies, ifshow.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 furtherarguments passed down to thesjPlot-functions. See 'Examples'.

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

Matrix with correlation coefficients as returned by thecor-function, or adata.frame of variables wherecorrelations between columns should be computed.

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

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

String, will be used as table caption.

Character vector with variable names, which will be usedto label variables in the output.

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

Logical, ifTRUE, p-values are also printed.

Logical, ifTRUE, the p-values are printedas numbers. IfFALSE (default), asterisks are used.

Logical, ifTRUE (default), non-significant correlation-valuesappear faded (by using a lighter grey text color). See 'Note'.

Specify a number between 0 and 1 to suppress the output of correlation valuesthat are smaller thanval.rm. The absolute correlation values are used, soa correlation value of-.5 would be greater thanval.rm = .4 and thus not beomitted. By default, this argument isNULL, hence all values are shown in the table.If a correlation value is below the specified value ofval.rm, it is still printed tothe HTML table, but made "invisible" with white foreground color. You can use theCSSargument ("css.valueremove") to change color and appearance of those correlation value that are smaller thanthe limit specified byval.rm.

Amount of decimals for estimates

Indicates whether only the upper right (use"upper"), lower left (use"lower")or both (use"both") triangles of the correlation table is filled with values. Defaultis"both". You can specifiy the inital letter only.

A vector with string values of the same length asncol(data) (number ofcorrelated items) that can be used to display content in the diagonal cellswhere row and column item are identical (i.e. the "self-correlation"). By defauilt,this argument isNULL and the diagnal cells are empty.

Alist with user-defined style-sheet-definitions,according to theofficial CSS syntax.See 'Details' orthis package-vignette.

Character vector, indicating the charset encoding usedfor variable and value labels. Default is"UTF-8". For WindowsSystems,encoding = "Windows-1252" might be necessary for properdisplay of special characters.

Destination file, if the output should be saved as file.IfNULL (default), the output will be saved as temporary file andopened either in the IDE's viewer pane or the default web browser.

Logical, ifTRUE, the HTML table is shown in the IDE'sviewer pane. IfFALSE or no viewer available, the HTML table isopened in a web browser.

Logical, ifTRUE, leading spaces are removed from all lines in the final stringthat contains the html-data. Use this, if you want to remove parantheses for html-tags. The html-sourcemay look less pretty, but it may help when exporting html-tables to office tools.

Fortab_df(), a data frame; and fortab_dfs(), alist of data frames.

Character vector with tablecaption(s) resp. footnote(s). Fortab_df(), must be a characterof length 1; fortab_dfs(), a character vector of same length asx (i.e. one title or footnote per data frame).

Character vector with elements used as column header forthe table. IfNULL, column names fromx are used ascolumn header.

Logical, ifTRUE, adds information about thevariable type to the variable column.

Logical, ifTRUE, adds a column with thedata frame's rowname to the table output.

Logical, ifTRUE,adds a summary footnote belowthe table. Fortab_df(), specify the string infootnote,fortab_dfs() provide a character vector infootnotes.

Logical, ifTRUE, rows are printed inalternatig colors (white and light grey by default).

Numeric vector, indicating the index of the columnthat should sorted. by default, the column is sorted in ascending order.Use negative index for descending order, for instance,sort.column = -3 would sort the third column in descending order.Note that the first column with rownames is not counted.

Numeric, amount of digits after decimal point when roundingvalues.

Character vector, indicating the charset encoding usedfor variable and value labels. Default is"UTF-8". For WindowsSystems,encoding = "Windows-1252" might be necessary for properdisplay of special characters.

Alist with user-defined style-sheet-definitions,according to theofficial CSS syntax.See 'Details' orthis package-vignette.

Destination file, if the output should be saved as file.IfNULL (default), the output will be saved as temporary file andopened either in the IDE's viewer pane or the default web browser.

Logical, ifTRUE, the HTML table is shown in the IDE'sviewer pane. IfFALSE or no viewer available, the HTML table isopened in a web browser.

Currently not used.

Character vector, can be used to set row names whenshow.rownames=TRUE.

A data frame that should be used to compute a PCA, or aprcomp object.

Rotation of the factor loadings. May be one of"varimax", "quartimax", "promax", "oblimin", "simplimax", "cluster"or"none".

the factoring method to be used."ml" will do a maximum likelihood factor analysis (default)."minres" will do a minimum residual (OLS),"wls" will do a weighted least squares (WLS) solution,"gls" does a generalized weighted least squares (GLS),"pa" will do the principal factor solution,"minchi" will minimize the sample size weighted chi squarewhen treating pairwise correlations with different number ofsubjects per pair."minrank" will do a minimum rank factor analysis.

Number of factors used for calculating the rotation. Bydefault, this value isNULL and the amount of factors iscalculated according to the Kaiser-criteria.

Specifies the minimum difference a variable needs to have betweenfactor loadings (components) in order to indicate a clear loading on just one factor and notdiffusing over all factors. For instance, a variable with 0.8, 0.82 and 0.84 factor loadingon 3 possible factors can not be clearly assigned to just one factor and thus would be removedfrom the principal component analysis. By default, the minimum difference of loading valuesbetween the highest and 2nd highest factor should be 0.1

logical, ifTRUE, sort the loadings for each factors(items will be sorted in terms of their greatest loading, in descendingorder)

String, will be used as table caption.

Character vector with variable names, which will be usedto label variables in the output.

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

Logical, ifTRUE (default), the cronbach's alpha value for each factor scale will be calculated,i.e. all variables with the highest loading for a factor are taken for thereliability test. The result is an alpha value for each factor dimension.Only applies whendata is a data frame.

Logical, ifTRUE, show the communality column in the table.

Logical, ifTRUE, rows are printed inalternatig colors (white and light grey by default).

Amount of decimals for estimates

Alist with user-defined style-sheet-definitions,according to theofficial CSS syntax.See 'Details' orthis package-vignette.

Character vector, indicating the charset encoding usedfor variable and value labels. Default is"UTF-8". For WindowsSystems,encoding = "Windows-1252" might be necessary for properdisplay of special characters.

Destination file, if the output should be saved as file.IfNULL (default), the output will be saved as temporary file andopened either in the IDE's viewer pane or the default web browser.

Logical, ifTRUE, the HTML table is shown in the IDE'sviewer pane. IfFALSE or no viewer available, the HTML table isopened in a web browser.

Logical, ifTRUE, leading spaces are removed from all lines in the final stringthat contains the html-data. Use this, if you want to remove parantheses for html-tags. The html-sourcemay look less pretty, but it may help when exporting html-tables to office tools.

A data frame with items.

If notNULL,df will be splitted into sub-groups,where the item analysis is carried out for each of these groups. Must be a vector of samelength asncol(df), where each item in this vector represents the group number ofthe related columns ofdf. Iffactor.groups = "auto", a principalcomponent analysis with Varimax rotation is performed, and the resultinggroups for the components are used as group index. See 'Examples'.

Titles for each factor group that will be used as table caption for eachcomponent-table. Must be a character vector of same length aslength(unique(factor.groups)).Default is"auto", which means that each table has a standard captionComponent x.UseNULL to suppress table captions.

Logical, ifTRUE, the data frame's vectors will be scaled when calculating theCronbach's Alpha value (seeitem_reliability). Recommended, whenthe variables have different measures / scales.

Minimum amount of valid values to compute row means for index scores.Default is 2, i.e. the return valuesindex.scores anddf.index.scores arecomputed for those items that have at leastmin.valid.rowmean per case (observation, ortechnically, row). Seemean_n for details.

Logical, ifTRUE, rows are printed inalternatig colors (white and light grey by default).

Numeric vector, indicating the index of the columnthat should sorted. by default, the column is sorted in ascending order.Use negative index for descending order, for instance,sort.column = -3 would sort the third column in descending order.Note that the first column with rownames is not counted.

Logical, ifTRUE, a Shapiro-Wilk normality test is computed for each item.Seeshapiro.test for details.

Logical, ifTRUE, the kurtosis for each item will also be shown (seekurtosianddescribe in thepsych-package for more details.

Logical, ifTRUE (default), a correlation matrix of each component'sindex score is shown. Only applies iffactor.groups is notNULL anddf hasmore than one group. First, for each case (df's row), the sum of all variables (df's columns) isscaled (using thescale-function) and represents a "total score" foreach component (a component is represented by each group offactor.groups).After that, each case (df's row) has a scales sum score for each component.Finally, a correlation of these "scale sum scores" is computed.

Alist with user-defined style-sheet-definitions,according to theofficial CSS syntax.See 'Details' orthis package-vignette.

Character vector, indicating the charset encoding usedfor variable and value labels. Default is"UTF-8". For WindowsSystems,encoding = "Windows-1252" might be necessary for properdisplay of special characters.

Destination file, if the output should be saved as file.IfNULL (default), the output will be saved as temporary file andopened either in the IDE's viewer pane or the default web browser.

Logical, ifTRUE, the HTML table is shown in the IDE'sviewer pane. IfFALSE or no viewer available, the HTML table isopened in a web browser.

Logical, ifTRUE, leading spaces are removed from all lines in the final stringthat contains the html-data. Use this, if you want to remove parantheses for html-tags. The html-sourcemay look less pretty, but it may help when exporting html-tables to office tools.

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

A character vector, naming a function that will be appliedon estimates and confidence intervals. By default,transform willautomatically use"exp" as transformation for applicable classes ofmodel (e.g. logistic or poisson regression). Estimates of linearmodels remain untransformed. UseNULL if you want the raw,non-transformed estimates.

Logical, ifTRUE, the intercepts are printed.

Logical, ifTRUE, the estimates are printed.

Either logical, and ifTRUE, the confidence intervalsis printed to the table; ifFALSE, confidence intervals areomitted. Or numeric, between 0 and 1, indicating the range of theconfidence intervals.

Logical, ifTRUE, for Bayesian models, a secondcredible interval is added to the table output.

Logical, ifTRUE, the standard errors arealso printed. If robust standard errors are required, use argumentsvcov.fun, andvcov.args (seestandard_error for details).

Indicates whether standardized beta-coefficients shouldalso printed, and if yes, which type of standardization is done.See 'Details'.

Logical, whether the response variable will also bestandardized if standardized coefficients are requested. Setting bothstd.response = TRUE andshow.std = TRUE will behave as ifthe complete data was standardized before fitting the model.

Logical, ifTRUE, p-values are also printed.

Logical, ifTRUE, the coefficients' test statisticis also printed.

Logical, ifTRUE andp.val = "kr", the p-valuesfor linear mixed models are based on df with Kenward-Rogers approximation.These df-values are printed. Seep_value for details.

Logical, ifTRUE and model has a zero-inflatedmodel part, this is also printed to the table.

Logical, ifTRUE, the r-squared value is also printed.Depending on the model, these might be pseudo-r-squared values, or Bayesianr-squared etc. Seer2 for details.

Logical, ifTRUE, prints the intraclass correlationcoefficient for mixed models. Seeicc for details.

Logical, ifTRUE, prints the random effect variancesfor mixed models. Seeget_variance for details.

Logical, ifTRUE, shows number of random effects groupsfor mixed models.

Logical, ifTRUE, the F-statistics for each model isprinted in the table summary. This option is not supported by all model types.

Logical, ifTRUE, the AIC value for each model is printedin the table summary.

Logical, ifTRUE, the second-order AIC value for each modelis printed in the table summary.

Logical, ifTRUE, shows the deviance of the model.

Logical, ifTRUE, shows the log-Likelihood of the model.

Logical, ifTRUE, the number of observations per model isprinted in the table summary.

Logical, ifTRUE, an additional row is inserted tothe table before each predictor of typefactor, which willindicate the reference level of the related factor.

Character vector with names of those terms (variables) that shouldbe printed in the table. All other terms are removed from the output. IfNULL, all terms are printed. Note that the term names must matchthe names of the model's coefficients. For factors, this means thatthe variable name is suffixed with the related factor level, and eachcategory counts as one term. E.g.rm.terms = "t_name [2,3]"would remove the terms"t_name2" and"t_name3" (assumingthat the variablet_name is categorical and has at leastthe factor levels2 and3). Another example for theiris-dataset:terms = "Species" would not work, insteaduseterms = "Species [versicolor,virginica]".

Character vector with names that indicate which terms shouldbe removed from the output Counterpart toterms.rm.terms ="t_name" would remove the termt_name. Default isNULL, i.e.all terms are used. For factors, levels that should be removed from the plotneed to be explicitly indicated in square brackets, and match the model'scoefficient names, e.g.rm.terms = "t_name [2,3]" would remove the terms"t_name2" and"t_name3" (assuming that the variablet_namewas categorical and has at least the factor levels2 and3).

Numeric vector, indicating in which order the coefficientsshould be plotted. See examples inthis package-vignette.

Character containing a regular expression pattern thatdescribes the parameters that should be included (forkeep) or excluded(fordrop) in the returned data frame.keep may also be anamed list of regular expressions. All non-matching parameters will beremoved from the output. Ifkeep has more than one element, thesewill be merged with anOR operator into a regular expression patternlike this:"(one|two|three)". See further details in?parameters::model_parameters.

String, will be used as table caption.

Character vector with labels of predictor variables.If notNULL,pred.labels will be used in the firsttable column with the predictors' names. By default, ifauto.label = TRUEanddata is labelled,term_labels is called to retrieve the labelsof the coefficients, which will be used as predictor labels. If data isnot labelled,format_parameters()is used to create pretty labels. Ifpred.labels = "" orauto.label = FALSE, the rawvariable names as used in the model formula are used as predictorlabels. Ifpred.labels is a named vector, predictor labels (bydefault, the names of the model's coefficients) will be matched with thenames ofpred.labels. This ensures that labels always match therelated predictor in the table, no matter in which way the predictorsare sorted. See 'Examples'.

Character vector with labels of dependent variables of allfitted models. Ifdv.labels = "", the row with names of dependentvariables is omitted from the table.

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

Logical, ifTRUE, returns bootstrapped estimates..

Numeric, number of bootstrap iterations (default is 1000).

Numeric, the number of the seed to replicate bootstrapped estimates. IfNULL, uses random seed.

Variance-covariance matrix used to compute uncertaintyestimates (e.g., for robust standard errors). This argument accepts acovariance matrix, a function which returns a covariance matrix, or astring which identifies the function to be used to compute the covariancematrix. Seemodel_parameters().

List of arguments to be passed to the function identified bythevcov.fun argument. This function is typically supplied by thesandwich orclubSandwich packages. Please refer to theirdocumentation (e.g.,?sandwich::vcovHAC) to see the list ofavailable arguments.

Character vector,used as headline for the predictor column.Default is"Predictors".

Character vector, used for the column heading of coefficients.Default is based on the response scale, e.g. for logistic regression models,"Odds Ratios" will be chosen, while for Poisson models it is"Incidence Rate Ratios" etc. Default if not specified is"Estimate".

Character vector, used for the column heading of standardized beta coefficients. Default is"std. Beta".

Character vector, used for the column heading of confidence interval values. Default is"CI".

Character vector, used for the column heading of standard error values. Default is"std. Error".

Character vector, used for the column heading of standard error of standardized coefficients. Default is"standardized std. Error".

Character vector, used for the column heading of confidence intervals of standardized coefficients. Default is"standardized std. Error".

String value, used for the column heading of p values. Default is"p".

Character vector, used for the column heading of p values. Default is"std. p".

Character vector, used for the column heading of degrees of freedom. Default is"df".

Character vector, used for the test statistic. Default is"Statistic".

Character vector, used for the test statistic. Default is"std. Statistic".

Character vector, used for the column heading of of the response level for multinominal or categorical models. Default is"Response".

Character vector, used as name for the intercept parameter. Default is"(Intercept)".

Named character vector, as alternative to arguments likestring.ciorstring.p etc. The name (lhs) must be one of the string-indicator fromthe aforementioned arguments, while the value (rhs) is the string that is usedas column heading. E.g.,strings = c(ci = "Conf.Int.", se = "std. Err")would be equivalent to settingstring.ci = "Conf.Int.", string.se = "std. Err".

Character vector, indicating the hyphen for confidence interval range.May be an HTML entity. See 'Examples'.

string, indicating the minus sign for negative numbers.May be an HTML entity. See 'Examples'.

Logical, ifFALSE, the CI values are shown ina separate table column.

Logical, ifFALSE, the SE values are shown ina separate table column.

Logical, ifTRUE andcollapse.ci = FALSE orcollapse.se = FALSE, inserts a line break between estimate andCI resp. SE values. IfFALSE, values are printed in the same lineas estimate values.

Character vector, indicating which columns should be printedand in which order. Column names that are excluded fromcol.orderare not shown in the table output. However, column names that are included,are only shown in the table when the related argument (likeshow.estfor"estimate") is set toTRUE or another valid value.Table columns are printed in the order as they appear incol.order.

Amount of decimals for estimates

Amount of decimals for p-values

Amount of decimals for r-squared values

Amount of decimals for random effects part of the summary table.

Logical, ifTRUE, significant p-values are shown bold faced.

Method for computing degrees of freedom for p-values,standard errors and confidence intervals (CI). Only applies to mixed models.Usedf.method = "wald" for a faster, but less precise computation.This will use the residual degrees of freedom (as returned bydf.residual())for linear mixed models, andInf degrees if freedom for all othermodel families.df.method = "kenward" (ordf.method = "kr")uses Kenward-Roger approximation for the degrees of freedom.df.method = "satterthwaite" uses Satterthwaite's approximation and"ml1" uses a "m-l-1" heuristic seedegrees_of_freedomfor details). Useshow.df = TRUE to show the approximated degrees of freedomfor each coefficient.

Character, indicating if p-values should be printed asnumeric value ("numeric"), as 'stars' (asterisks) only ("stars"),or scientific ("scientific"). Scientific and numeric style can becombined with "stars", e.g."numeric_stars"

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

String value, if notNULL, indicates the methodto adjust p-values. Seep.adjust for details.

Desired target case. Labels will automatically converted into thespecified character case. Seesnakecase::to_any_case() for moredetails on this argument. By default, ifcase is not specified,it will be set to"parsed", unlessprefix.labels is not"none". Ifprefix.labels is either"label" (or"l") or"varname" (or"v") andcase is notspecified, it will be set toNULL - this is a more convenientdefault when prefixing labels.

Logical, ifTRUE (the default),anddata is labelled,term_labels is called to retrieve the labelsof the coefficients, which will be used as predictor labels. If data isnot labelled,format_parameters()is used to create pretty labels. Ifauto.label = FALSE,original variable names and value labels (factor levels) are used.

Indicates whether the value labels of categorical variablesshould be prefixed, e.g. with the variable name or variable label. Seeargumentprefix interm_labels fordetails.

ForStan-models (fitted with therstanarm- orbrms-package), the Bayesian point estimate is, by default, the medianof the posterior distribution. Usebpe to define other functions tocalculate the Bayesian point estimate.bpe needs to be a characternaming the specific function, which is passed to thefun-argument intypical_value. So,bpe = "mean" wouldcalculate the mean value of the posterior distribution.

Alist with user-defined style-sheet-definitions,according to theofficial CSS syntax.See 'Details' orthis package-vignette.

Destination file, if the output should be saved as file.IfNULL (default), the output will be saved as temporary file andopened either in the IDE's viewer pane or the default web browser.

Logical, ifTRUE, the HTML table is shown in the IDE'sviewer pane. IfFALSE or no viewer available, the HTML table isopened in a web browser.

Character vector, indicating the charset encoding usedfor variable and value labels. Default is"UTF-8". For WindowsSystems,encoding = "Windows-1252" might be necessary for properdisplay of special characters.

A data frame that should be used to compute a PCA, or aprcomp object.

Rotation of the factor loadings. May be one of"varimax", "quartimax", "promax", "oblimin", "simplimax", "cluster"or"none".

Number of factors used for calculating the rotation. Bydefault, this value isNULL and the amount of factors iscalculated according to the Kaiser-criteria.

Specifies the minimum difference a variable needs to have betweenfactor loadings (components) in order to indicate a clear loading on just one factor and notdiffusing over all factors. For instance, a variable with 0.8, 0.82 and 0.84 factor loadingon 3 possible factors can not be clearly assigned to just one factor and thus would be removedfrom the principal component analysis. By default, the minimum difference of loading valuesbetween the highest and 2nd highest factor should be 0.1

String, will be used as table caption.

Character vector with variable names, which will be usedto label variables in the output.

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

Logical, ifTRUE (default), the cronbach's alpha value for each factor scale will be calculated,i.e. all variables with the highest loading for a factor are taken for thereliability test. The result is an alpha value for each factor dimension.Only applies whendata is a data frame.

Logical, ifTRUE, shows an additional column with the measure of sampling adequacy accordingdor each component.

Logical, ifTRUE, the proportions of variances for each component as well as cumulativevariance are shown in the table footer.

Logical, ifTRUE, rows are printed inalternatig colors (white and light grey by default).

Amount of decimals for estimates

String for the table row that contains the proportions of variances. By default,"Proportion of Variance" will be used.

String for the table row that contains the cumulative variances. By default,"Cumulative Proportion" will be used.

Alist with user-defined style-sheet-definitions,according to theofficial CSS syntax.See 'Details' orthis package-vignette.

Character vector, indicating the charset encoding usedfor variable and value labels. Default is"UTF-8". For WindowsSystems,encoding = "Windows-1252" might be necessary for properdisplay of special characters.

Destination file, if the output should be saved as file.IfNULL (default), the output will be saved as temporary file andopened either in the IDE's viewer pane or the default web browser.

Logical, ifTRUE, the HTML table is shown in the IDE'sviewer pane. IfFALSE or no viewer available, the HTML table isopened in a web browser.

Logical, ifTRUE, leading spaces are removed from all lines in the final stringthat contains the html-data. Use this, if you want to remove parantheses for html-tags. The html-sourcemay look less pretty, but it may help when exporting html-tables to office tools.

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

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

String, will be used as table caption.

Character vector with variable names, which will be usedto label variables in the output.

Character vector (orlist of character vectors)with value labels of the supplied variables, which will be usedto label variable values in the output.

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

logical, indicates whether theitems should be ordered byby highest count of first or last category ofitems.

• Use"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,

• orNULL (default) for no sorting.

Logical, ifTRUE, rows are printed inalternatig colors (white and light grey by default).

Numeric, amount of digits after decimal point when roundingvalues.

label for the total N column.

label for the missing column/row.

logical, ifTRUE, adds total number of cases for eachgroup or category to the labels.

logical, ifTRUE, an additional column with eachitem's total N is printed.

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

logical, ifTRUE, an additional column with each item's skewness is printed.The skewness is retrieved from thedescribe-functionof thepsych-package.

Logical, ifTRUE, the kurtosis for each item will also be shown (seekurtosianddescribe in thepsych-package for more details.

amount of digits for rounding the skewness and kurtosis valuess.Default is 2, i.e. skewness and kurtosis values have 2 digits after decimal point.

Destination file, if the output should be saved as file.IfNULL (default), the output will be saved as temporary file andopened either in the IDE's viewer pane or the default web browser.

Character vector, indicating the charset encoding usedfor variable and value labels. Default is"UTF-8". For WindowsSystems,encoding = "Windows-1252" might be necessary for properdisplay of special characters.

Alist with user-defined style-sheet-definitions,according to theofficial CSS syntax.See 'Details' orthis package-vignette.

Logical, ifTRUE, the HTML table is shown in the IDE'sviewer pane. IfFALSE or no viewer available, the HTML table isopened in a web browser.

Logical, ifTRUE, leading spaces are removed from all lines in the final stringthat contains the html-data. Use this, if you want to remove parantheses for html-tags. The html-sourcemay look less pretty, but it may help when exporting html-tables to office tools.

Variable that should be displayed in the table rows.

Cariable that should be displayed in the table columns.

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

String, will be used as table caption.

Character vector with variable names, which will be usedto label variables in the output.

Character vector (orlist of character vectors)with value labels of the supplied variables, which will be usedto label variable values in the output.

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

Logical, ifTRUE, observed values are shown

Logical, ifTRUE, cell percentage values are shown

Logical, ifTRUE, row percentage values are shown

Logical, ifTRUE, column percentage values are shown

Logical, ifTRUE, expected values are also shown

logical, ifTRUE, and depending on plot type andfunction, a legend is added to the plot.

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

Logical, ifTRUE, a summary row withchi-squared statistics, degrees of freedom and Cramer's V or Phicoefficient and p-value for the chi-squared statistics.

Logical, ifTRUE and the variable's values are labeled, values / factorlevels with no occurrence in the data are omitted from the output. IfFALSE,labeled values that have no observations are still printed in the table (with frequency0).

Name of measure of association that should be computed. Maybe one of"auto","cramer","phi","spearman","kendall","pearson" or"fisher". Seextab_statistics.

Character label for the total column / row header

Amount of decimals for estimates

Color for highlighting count (observed) values in table cells. Default is black.

Color for highlighting expected values in table cells. Default is cyan.

Color for highlighting cell percentage values in table cells. Default is red.

Color for highlighting row percentage values in table cells. Default is blue.

Color for highlighting column percentage values in table cells. Default is green.

Logical, ifTRUE, the total column and row will be emphasized with adifferent background color. Seeemph.color.

Logical, ifemph.total = TRUE, this color value will be usedfor painting the background of the total column and row. Default is a light grey.

The percentage sign that is printed in the table cells, in HTML-format.Default is" %", hence the percentage sign has a non-breaking-space afterthe percentage value.

Default value that indicates the 100-percent column-sums (since rounding valuesmay lead to non-exact results). Default is"100.0".

Alist with user-defined style-sheet-definitions,according to theofficial CSS syntax.See 'Details' orthis package-vignette.

String, indicating the charset encoding used for variable andvalue labels. Default isNULL, so encoding will be auto-detecteddepending on your platform (e.g.,"UTF-8" for Unix and"Windows-1252" forWindows OS). Change encoding if specific chars are not properly displayed (e.g. German umlauts).

Destination file, if the output should be saved as file.IfNULL (default), the output will be saved as temporary file andopened either in the IDE's viewer pane or the default web browser.

Logical, ifTRUE, the HTML table is shown in the IDE'sviewer pane. IfFALSE or no viewer available, the HTML table isopened in a web browser.

Logical, ifTRUE, leading spaces are removed from all lines in the final stringthat contains the html-data. Use this, if you want to remove parantheses for html-tags. The html-sourcemay look less pretty, but it may help when exporting html-tables to office tools.

Other arguments, currently passed down to the test statistics functionschisq.test() orfisher.test().

A (labelled) data frame, imported byread_spss,read_sas orread_stata function,or any similar labelled data frame (seeset_labelandset_labels).

Name of variable inx that indicated the vector ofweights that will be applied to weight all observations. Default isNULL, so no weights are used.

Logical, ifTRUE, rows are printed inalternatig colors (white and light grey by default).

Logical, ifTRUE (default), the variable ID is shown inthe first column.

Logical, ifTRUE, adds information about thevariable type to the variable column.

Logical, ifTRUE (default), the variable valuesare shown as additional column.

Logical, ifTRUE, elements of character vectorsare also shown. By default, these are omitted due to possibly overlengthytables.

Logical, ifTRUE (default), the value labels areshown as additional column.

Logical, ifTRUE, an additional column withfrequencies for each variable is shown.

Logical, ifTRUE, an additional column with percentageof frequencies for each variable is shown.

Logical, ifTRUE, an additional column with weightedfrequencies for each variable is shown. Weights strem fromweight.by.

Logical, ifTRUE, an additional column with weightedpercentage of frequencies for each variable is shown. Weights strem fromweight.by.

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

Numeric, indicates how many values and value labels per variableare shown. Useful for variables with many different values, where the outputcan be truncated.

Logical, ifTRUE, rows are sorted according to thevariable names. By default, rows (variables) are ordered according to theirorder in the data frame.

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

Logical, ifTRUE, a progress bar is displayedwhile creating the output.

Alist with user-defined style-sheet-definitions,according to theofficial CSS syntax.See 'Details' orthis package-vignette.

Character vector, indicating the charset encoding usedfor variable and value labels. Default is"UTF-8". For WindowsSystems,encoding = "Windows-1252" might be necessary for properdisplay of special characters.

Destination file, if the output should be saved as file.IfNULL (default), the output will be saved as temporary file andopened either in the IDE's viewer pane or the default web browser.

Logical, ifTRUE, the HTML table is shown in the IDE'sviewer pane. IfFALSE or no viewer available, the HTML table isopened in a web browser.

Logical, ifTRUE, leading spaces are removed from all lines in the final stringthat contains the html-data. Use this, if you want to remove parantheses for html-tags. The html-sourcemay look less pretty, but it may help when exporting html-tables to office tools.